Skip to content

Commit a6f1172

Browse files
committed
docs: access management default is NetBird + Keycloak; Teleport is deprecated
The README credited Teleport with unified access management, but the current model runs cluster access over the NetBird mesh with Keycloak as the SSO identity provider. Teleport stays available for existing setups; both teleport chart READMEs now carry a deprecation banner. Signed-off-by: Ashish Jaiswal <ashish@obmondo.com>
1 parent b14f035 commit a6f1172

3 files changed

Lines changed: 16 additions & 6 deletions

File tree

README.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -122,7 +122,9 @@ and day-2 operations for every supported platform.
122122
handling of trivial alerts like disks filling up.
123123
- **Secrets in Git, safely**: [sealed-secrets](./argocd-helm-charts/sealed-secrets/README.md) encrypts secrets locally
124124
before they are committed to your config repository.
125-
- **Unified access management** through Teleport for Kubernetes, applications, and databases.
125+
- **Unified access management**: cluster access runs over the [NetBird](https://netbird.io/) mesh with
126+
[Keycloak](https://www.keycloak.org/) as the SSO identity provider by default. Teleport remains available as an
127+
optional, deprecated alternative.
126128
- **Cluster security**: NetworkPolicies enforce least privilege between applications and secure intra-cluster and
127129
ingress traffic.
128130
- **Lifecycle operations**: auto-scaling, backup and recovery, live migration of applications or whole clusters, major

argocd-helm-charts/teleport-cluster/README.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,15 @@
44
apps). This chart deploys the central Teleport proxy/auth cluster (`clusterName` in values.yaml, e.g.
55
`teleport.obmondo.com`) that managed clusters join through.
66

7+
> **Deprecated:** Teleport is no longer KubeAid's default access layer — new clusters use the NetBird mesh with
8+
> Keycloak SSO instead. This chart remains available for existing setups.
9+
710
## Why it's in KubeAid
811

9-
KubeAid uses Teleport as the access layer for managed clusters: instead of distributing raw kubeconfigs, each
10-
managed cluster runs the [`teleport-kube-agent`](../teleport-kube-agent/README.md) chart and joins this central
11-
cluster, so cluster access can be issued/revoked/audited from one place.
12+
KubeAid previously used Teleport as the access layer for managed clusters: instead of distributing raw
13+
kubeconfigs, each managed cluster runs the [`teleport-kube-agent`](../teleport-kube-agent/README.md) chart and
14+
joins this central cluster, so cluster access can be issued/revoked/audited from one place. On current clusters
15+
that role is filled by NetBird (mesh access) and Keycloak (SSO).
1216

1317
## Upgrade
1418

argocd-helm-charts/teleport-kube-agent/README.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,14 @@ This chart deploys the [Teleport](https://goteleport.com) kube-agent — a light
44
cluster's Kubernetes API to the central [`teleport-cluster`](../teleport-cluster/README.md) (see `proxyAddr` in
55
values.yaml), so operators access it through Teleport instead of a distributed kubeconfig.
66

7+
> **Deprecated:** Teleport is no longer KubeAid's default access layer — new clusters use the NetBird mesh with
8+
> Keycloak SSO instead. This chart remains available for existing setups.
9+
710
## Why it's in KubeAid
811

9-
This is the per-managed-cluster half of KubeAid's Teleport-based access model: `teleport-cluster` runs the central
10-
proxy/auth service, and every managed cluster runs this agent to expose its API through it.
12+
This is the per-managed-cluster half of KubeAid's previous Teleport-based access model: `teleport-cluster` runs the
13+
central proxy/auth service, and every managed cluster runs this agent to expose its API through it. On current
14+
clusters that role is filled by NetBird (mesh access) and Keycloak (SSO).
1115

1216
**NOTE: if there is no join-token secret, the pod would fail to start.**
1317

0 commit comments

Comments
 (0)