OCM ManagedServiceAccount ReplicaSet Controller is a hub-side controller for
creating OCM ManagedServiceAccount resources across clusters selected by OCM
Placement output.
The upstream ManagedServiceAccount API is per managed cluster namespace. It
does not support creating one ManagedServiceAccount in a cluster-set namespace
and having it apply to every cluster in the set. This controller fills that gap
with ManagedServiceAccountReplicaSet.
ManagedServiceAccountReplicaSet provides an OCM-native workflow for
replicating managed service accounts across a selected fleet:
- Resolves target clusters from OCM
PlacementandPlacementDecisionoutput using the OCM placement SDK tracker. - Supports OCM-style
rolloutStrategyper placement ref. - Reports OCM-style rollout progress counts for updating, succeeded, failed, and timed-out clusters.
- Creates one generated OCM
ManagedServiceAccountper selected managed cluster namespace. - Optionally delivers typed, least-privilege remote RBAC through generated OCM
ManifestWorkobjects. - Cleans generated cross-namespace children with explicit finalizers.
Install the controller on an OCM hub, point a
ManagedServiceAccountReplicaSet at an existing OCM Placement, and let the
controller reconcile generated hub-side children for each selected managed
cluster. The included sample shows a complete replica set with service account
rotation and typed remote RBAC grants:
- Getting started for the end-to-end flow.
- Helm installation for chart options and production values.
- Sample ManagedServiceAccountReplicaSet
- API reference
- Placement behavior
- Operations
- Troubleshooting
- Security model
- Admission policy
- Supply chain
- Observability
- Compatibility
The controller intentionally avoids direct remote-cluster access. It does not
read Cluster API Cluster objects, remote kubeconfig Secrets, or child status
subresources, and it only writes the status of ManagedServiceAccountReplicaSet.
make test
make lint
make helm-lint
make test-chart
make test-e2e