Skip to content

feat(regions): add opt-in Connectivity Operator beta.2 #436

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Dav-14 merged 7 commits into from
Oct 9, 2026
Merged

feat(regions): add opt-in Connectivity Operator beta.2 #436

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
63b8857
feat(regions): add opt-in Connectivity Operator
Dav-14 Sep 18, 2026
ace4d89
chore(formance): regenerate values schema for regions.operator.connec…
Dav-14 Sep 18, 2026
5338864
chore(regions): align Connectivity Operator with beta.2
Dav-14 Oct 8, 2026
0225e6f
fix(regions): pin Connectivity in the beta Versions profile
Dav-14 Oct 8, 2026
1322c42
chore(regions): use the packaged Connectivity Operator image default
Dav-14 Oct 8, 2026
37eec2a
chore(regions): align Ledger v3 dependencies with beta.10
Dav-14 Oct 8, 2026
9f427ca
chore(regions): consume Stack Operator 3.17.0
Dav-14 Oct 8, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,12 @@
| [Cloudprem](./charts/cloudprem/README.md) | 6.1.0 | latest | Formance control-plane | [![Artifact HUB](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/cloudprem)](https://artifacthub.io/packages/search?repo=cloudprem) |
| [Console-V3](./charts/console-v3/README.md) | 5.0.2 | v4.0.2 | Formance Console | [![Artifact HUB](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/console-v3)](https://artifacthub.io/packages/search?repo=console-v3) |
| [Core](./charts/core/README.md) | 1.6.0 | latest | Formance Core Library | [![Artifact HUB](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/core)](https://artifacthub.io/packages/search?repo=core) |
| [Formance](./charts/formance/README.md) | 3.2.4 | latest | Formance Platform - Unified Helm Chart | [![Artifact HUB](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/formance)](https://artifacthub.io/packages/search?repo=formance) |
| [Formance](./charts/formance/README.md) | 3.3.0 | latest | Formance Platform - Unified Helm Chart | [![Artifact HUB](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/formance)](https://artifacthub.io/packages/search?repo=formance) |
| [Identity](./charts/identity/README.md) | 0.1.0 | 4a542c9f48b3799fe4a7f06c75c62a75b83afd0b | Formance Identity service | [![Artifact HUB](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/identity)](https://artifacthub.io/packages/search?repo=identity) |
| [Ledger-Ui](./charts/ledger-ui/README.md) | 0.1.0 | latest | Formance Ledger UI | [![Artifact HUB](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/ledger-ui)](https://artifacthub.io/packages/search?repo=ledger-ui) |
| [Membership](./charts/membership/README.md) | 3.7.2 | v2.5.0 | Formance EE Membership API. Manage stacks, organizations, regions, invitations, users, roles, and permissions. | [![Artifact HUB](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/membership)](https://artifacthub.io/packages/search?repo=membership) |
| [Portal](./charts/portal/README.md) | 5.0.2 | v4.0.2 | Formance Portal | [![Artifact HUB](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/portal)](https://artifacthub.io/packages/search?repo=portal) |
| [Regions](./charts/regions/README.md) | 3.20.6 | latest | Formance Private Regions Helm Chart | [![Artifact HUB](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/regions)](https://artifacthub.io/packages/search?repo=regions) |
| [Regions](./charts/regions/README.md) | 3.21.0 | latest | Formance Private Regions Helm Chart | [![Artifact HUB](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/regions)](https://artifacthub.io/packages/search?repo=regions) |
| [Stargate](./charts/stargate/README.md) | 0.11.0 | latest | Formance EE Stargate gRPC Gateway | [![Artifact HUB](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/stargate)](https://artifacthub.io/packages/search?repo=stargate) |

## How to contribute
Expand Down
6 changes: 3 additions & 3 deletions charts/formance/Chart.lock
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@ dependencies:
version: 18.12.4
- name: regions
repository: file://../regions
version: 3.20.6
version: 3.21.0
- name: cloudprem
repository: file://../cloudprem
version: 6.1.0
digest: sha256:fd01db0ef06fbf71dcd747e5dc20adc697f11ca64f1682f5a0c14ab220d05eed
generated: "2026-10-08T12:19:12+02:00"
digest: sha256:aa82afaa5c0522891d3b9b0325327f0e77ee379033c78ead87e2ae666fa84b77
generated: "2026-10-08T17:30:13.522746+02:00"
2 changes: 1 addition & 1 deletion charts/formance/Chart.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ maintainers:
icon: "https://avatars.githubusercontent.com/u/84325077?s=200&v=4"

type: application
version: 3.2.4
version: 3.3.0
appVersion: "latest"
# The "-0" suffix is required for GKE compatibility. GKE versions contain
# build metadata like "v1.33.5-gke.2392000" which semver treats as pre-release.
Expand Down
18 changes: 13 additions & 5 deletions charts/formance/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# formance

![Version: 3.2.4](https://img.shields.io/badge/Version-3.2.4-informational?style=flat-square) ![Type: application](https://img.shields.io/badge/Type-application-informational?style=flat-square) ![AppVersion: latest](https://img.shields.io/badge/AppVersion-latest-informational?style=flat-square)
![Version: 3.3.0](https://img.shields.io/badge/Version-3.3.0-informational?style=flat-square) ![Type: application](https://img.shields.io/badge/Type-application-informational?style=flat-square) ![AppVersion: latest](https://img.shields.io/badge/AppVersion-latest-informational?style=flat-square)

Formance Platform - Unified Helm Chart

Expand Down Expand Up @@ -192,7 +192,8 @@ Kubernetes: `>=1.14.0-0`
| regions.agent.server.address | string | `"app.formance.cloud:443"` | Formance Cloud server address |
| regions.agent.server.tls.enabled | bool | `true` | Enable TLS |
| regions.agent.server.tls.insecureSkipVerify | bool | `true` | Skip TLS verification |
| regions.operator | object | `{"enabled":true,"ledger":{"enabled":false},"operator-crds":{"create":false}}` | Operator configuration |
| regions.operator | object | `{"connectivity":{"enabled":false},"enabled":true,"ledger":{"enabled":false},"operator-crds":{"create":false}}` | Operator configuration |
| regions.operator.connectivity.enabled | bool | `false` | Enable the Connectivity Operator (requires operator.enabled and operator.ledger.enabled) |
| regions.operator.enabled | bool | `true` | Enable the Formance Operator |
| regions.operator.ledger.enabled | bool | `false` | Enable the Ledger v3 Operator (requires operator.enabled) |
| regions.versions | object | `{"allowDefaultVersion":false,"create":true}` | Stack versions configuration |
Expand Down Expand Up @@ -313,6 +314,12 @@ Kubernetes: `>=1.14.0-0`
|-----|------|---------|-------------|
| cloudprem.portal.config.postgresqlUrl | string | `""` | PostgreSQL connection URL override (if not set, will be generated from global.postgresql) |

### Connectivity Operator configuration

| Key | Type | Default | Description |
|-----|------|---------|-------------|
| regions.operator.connectivity.enabled | bool | `false` | Enable the Connectivity Operator (requires operator.enabled and operator.ledger.enabled) |

### Ledger Operator configuration

| Key | Type | Default | Description |
Expand Down Expand Up @@ -738,8 +745,8 @@ Kubernetes: `>=1.14.0-0`
| regions.agent.server.tls.enabled | bool | `true` | |
| regions.agent.server.tls.insecureSkipVerify | bool | `true` | |
| regions.fullnameOverride | string | `""` | |
| regions.ledger-operator.image.tag | string | `"v3.0.0-beta.1"` | |
| regions.ledger-operator.ledgerImage.tag | string | `"v3.0.0-beta.1"` | |
| regions.ledger-operator.image.tag | string | `"v3.0.0-beta.10"` | |
| regions.ledger-operator.ledgerImage.tag | string | `"v3.0.0-beta.10"` | |
| regions.nameOverride | string | `""` | |
| regions.operator.fullnameOverride | string | `"operator"` | |
| regions.operator.image.repository | string | `"ghcr.io/formancehq/operator"` | |
Expand Down Expand Up @@ -819,8 +826,9 @@ Kubernetes: `>=1.14.0-0`
| regions.versions.files."v3.2".wallets | string | `"v2.2.1"` | |
| regions.versions.files."v3.2".webhooks | string | `"v2.5.4"` | |
| regions.versions.files."v4.0-beta".auth | string | `"v2.5.1"` | |
| regions.versions.files."v4.0-beta".connectivity | string | `"1.0.0-beta.2"` | |
| regions.versions.files."v4.0-beta".gateway | string | `"v2.3.2"` | |
| regions.versions.files."v4.0-beta".ledger | string | `"v3.0.0-beta.5"` | |
| regions.versions.files."v4.0-beta".ledger | string | `"v3.0.0-beta.10"` | |
| regions.versions.files."v4.0-beta".mcp | string | `"v0.3.0"` | |
| regions.versions.files."v4.0-beta".orchestration | string | `"v2.7.0"` | |
| regions.versions.files."v4.0-beta".payments | string | `"v3.4.8"` | |
Expand Down
8 changes: 8 additions & 0 deletions charts/formance/values.schema.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -535,6 +535,14 @@
"operator": {
"type": "object",
"properties": {
"connectivity": {
Comment thread
Dav-14 marked this conversation as resolved.
"type": "object",
"properties": {
"enabled": {
"type": "boolean"
}
}
},
"enabled": {
"type": "boolean"
},
Expand Down
4 changes: 4 additions & 0 deletions charts/formance/values.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -321,6 +321,10 @@ regions:
# -- Enable the Ledger v3 Operator (requires operator.enabled)
# @section -- Regions configuration
enabled: false
connectivity:
# -- Enable the Connectivity Operator (requires operator.enabled and operator.ledger.enabled)
# @section -- Regions configuration
enabled: false
operator-crds:
create: false

Expand Down
11 changes: 7 additions & 4 deletions charts/regions/Chart.lock
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,12 +4,15 @@ dependencies:
version: 2.17.0
- name: operator
repository: oci://ghcr.io/formancehq/helm
version: 3.16.0
version: 3.17.0
- name: ledger-operator
repository: oci://ghcr.io/formancehq/helm
version: 3.0.0-beta.1
version: 3.0.0-beta.10
- name: connectivity-operator
repository: oci://ghcr.io/formancehq/helm
version: 1.0.0-beta.2
- name: core
repository: file://../core
version: 1.6.0
digest: sha256:93f4b839219e582ec556bcc74ad29380b5a41725e8354dfa1b667755bd45b91a
generated: "2026-09-26T20:30:43.025664+02:00"
digest: sha256:96269e95f11118790fdf21d1158b5347c2b75d207d443e927abc5bc73f9fd2c4
generated: "2026-10-08T18:15:09.407005+02:00"
8 changes: 6 additions & 2 deletions charts/regions/Chart.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ maintainers:
icon: "https://avatars.githubusercontent.com/u/84325077?s=200&v=4"

type: application
version: 3.20.6
version: 3.21.0
appVersion: "latest"

dependencies:
Expand All @@ -24,9 +24,13 @@ dependencies:
repository: "oci://ghcr.io/formancehq/helm"
condition: operator.enabled
- name: ledger-operator
version: 3.0.0-beta.1
version: 3.0.0-beta.10
repository: "oci://ghcr.io/formancehq/helm"
condition: operator.ledger.enabled
- name: connectivity-operator
version: 1.0.0-beta.2
repository: "oci://ghcr.io/formancehq/helm"
condition: operator.connectivity.enabled
- name: core
version: "1.X"
repository: file://../core
18 changes: 13 additions & 5 deletions charts/regions/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Formance regions Helm chart

![Version: 3.20.6](https://img.shields.io/badge/Version-3.20.6-informational?style=flat-square) ![Type: application](https://img.shields.io/badge/Type-application-informational?style=flat-square) ![AppVersion: latest](https://img.shields.io/badge/AppVersion-latest-informational?style=flat-square)
![Version: 3.21.0](https://img.shields.io/badge/Version-3.21.0-informational?style=flat-square) ![Type: application](https://img.shields.io/badge/Type-application-informational?style=flat-square) ![AppVersion: latest](https://img.shields.io/badge/AppVersion-latest-informational?style=flat-square)
Formance Private Regions Helm Chart

## Requirements
Expand All @@ -9,7 +9,8 @@ Formance Private Regions Helm Chart
|------------|------|---------|
| file://../agent | agent | 2.X |
| file://../core | core | 1.X |
| oci://ghcr.io/formancehq/helm | ledger-operator | 3.0.0-beta.1 |
| oci://ghcr.io/formancehq/helm | connectivity-operator | 1.0.0-beta.2 |
| oci://ghcr.io/formancehq/helm | ledger-operator | 3.0.0-beta.10 |
| oci://ghcr.io/formancehq/helm | operator | 3.X |

## Maintainers
Expand Down Expand Up @@ -71,6 +72,12 @@ Then configure it through the `global.licence.token` and `global.licence.cluster
| global.monitoring.support.resourceAttributes | object | `{}` | Resource attributes added to all signals sent to this endpoint |
| global.monitoring.support.stackSelector | object | `{"matchExpressions":[{"key":"formance.com/stack","operator":"Exists"}]}` | Stack selector for the support OtelExporterEndpoint |

### Connectivity Operator configuration

| Key | Type | Default | Description |
|-----|------|---------|-------------|
| operator.connectivity.enabled | bool | `false` | Enable the Connectivity Operator (requires operator.enabled and operator.ledger.enabled) |

### Ledger Operator configuration

| Key | Type | Default | Description |
Expand All @@ -96,8 +103,8 @@ Then configure it through the `global.licence.token` and `global.licence.cluster
| agent.server.tls.enabled | bool | `true` | |
| agent.server.tls.insecureSkipVerify | bool | `true` | |
| fullnameOverride | string | `""` | |
| ledger-operator.image.tag | string | `"v3.0.0-beta.1"` | |
| ledger-operator.ledgerImage.tag | string | `"v3.0.0-beta.1"` | |
| ledger-operator.image.tag | string | `"v3.0.0-beta.10"` | |
| ledger-operator.ledgerImage.tag | string | `"v3.0.0-beta.10"` | |
| nameOverride | string | `""` | |
| operator.fullnameOverride | string | `"operator"` | |
| operator.image.repository | string | `"ghcr.io/formancehq/operator"` | |
Expand Down Expand Up @@ -177,8 +184,9 @@ Then configure it through the `global.licence.token` and `global.licence.cluster
| versions.files."v3.2".wallets | string | `"v2.2.1"` | |
| versions.files."v3.2".webhooks | string | `"v2.5.4"` | |
| versions.files."v4.0-beta".auth | string | `"v2.5.1"` | |
| versions.files."v4.0-beta".connectivity | string | `"1.0.0-beta.2"` | |
| versions.files."v4.0-beta".gateway | string | `"v2.3.2"` | |
| versions.files."v4.0-beta".ledger | string | `"v3.0.0-beta.5"` | |
| versions.files."v4.0-beta".ledger | string | `"v3.0.0-beta.10"` | |
| versions.files."v4.0-beta".mcp | string | `"v0.3.0"` | |
| versions.files."v4.0-beta".orchestration | string | `"v2.7.0"` | |
| versions.files."v4.0-beta".payments | string | `"v3.4.8"` | |
Expand Down
6 changes: 6 additions & 0 deletions charts/regions/templates/validation.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,12 @@
{{- if and .Values.operator.ledger.enabled (not .Values.operator.enabled) }}
{{- fail "operator.ledger.enabled requires operator.enabled=true" }}
{{- end }}
{{- if and .Values.operator.connectivity.enabled (not .Values.operator.enabled) }}
Comment thread
Dav-14 marked this conversation as resolved.
Comment thread
Dav-14 marked this conversation as resolved.
{{- fail "operator.connectivity.enabled requires operator.enabled=true" }}
{{- end }}
{{- if and .Values.operator.connectivity.enabled (not .Values.operator.ledger.enabled) }}
{{- fail "operator.connectivity.enabled requires operator.ledger.enabled=true" }}
{{- end }}
{{- range $name, $stack := .Values.stacks }}
{{- if and (eq ($stack.versionsFromFile | default "") "v4.0-beta") (not $.Values.operator.ledger.enabled) }}
{{- fail (printf "stack %q requires operator.ledger.enabled=true to use versionsFromFile=v4.0-beta" $name) }}
Expand Down
11 changes: 11 additions & 0 deletions charts/regions/values.schema.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -175,6 +175,14 @@
"operator": {
"type": "object",
"properties": {
"connectivity": {
"type": "object",
"properties": {
"enabled": {
"type": "boolean"
}
}
},
"enabled": {
"type": "boolean"
},
Expand Down Expand Up @@ -511,6 +519,9 @@
"auth": {
"type": "string"
},
"connectivity": {
"type": "string"
},
"gateway": {
"type": "string"
},
Expand Down
14 changes: 11 additions & 3 deletions charts/regions/values.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -59,6 +59,11 @@ operator:
# @section -- Ledger Operator configuration
enabled: false

connectivity:
# -- Enable the Connectivity Operator (requires operator.enabled and operator.ledger.enabled)
# @section -- Connectivity Operator configuration
enabled: false

fullnameOverride: "operator"
nameOverride: "operator"

Expand All @@ -82,12 +87,14 @@ operator:
operator-crds:
create: false

# The published beta.10 chart uses latest for both image tags, not appVersion.
# Keep explicit release tags until the upstream chart defaults are versioned.
ledger-operator:
image:
tag: "v3.0.0-beta.1"
tag: "v3.0.0-beta.10"

ledgerImage:
tag: "v3.0.0-beta.1"
tag: "v3.0.0-beta.10"

agent:
enabled: false
Expand Down Expand Up @@ -198,8 +205,9 @@ versions:
webhooks: v2.5.4
v4.0-beta:
auth: v2.5.1
connectivity: 1.0.0-beta.2
Comment thread
Dav-14 marked this conversation as resolved.
gateway: v2.3.2
ledger: v3.0.0-beta.5
ledger: v3.0.0-beta.10
mcp: v0.3.0
orchestration: v2.7.0
payments: v3.4.8
Expand Down
Loading