Repository navigation
Commit 6e1ceef
committed
docs(etcd-per-cluster): reframe as a control-plane app change and close all open questions
Second draft of the per-cluster etcd proposal. The framing changes and
every open question from the first review round is answered.
Reframing: the proposal is about completing packages/apps/kubernetes,
which since the control-plane / node-pool split (community#8) is the
control-plane app. Every control-plane component is rendered by that
chart except the one holding all of its state. Retiring the etcd
tenant-module wiring is a consequence of fixing that, not the goal.
This makes the relationship to community#39 explicit: #39 owns where
packages live and how modules declare themselves, this owns what the
control-plane app contains. Disjoint files, neither blocks the other.
Resolved questions, replacing the five open ones:
- Migration: the CAPI provider does re-project dataStoreName onto
TenantControlPlane.spec.dataStore on every reconcile, so a live
switch works, but it costs a read-only freeze window and a kubelet
restart on every tenant worker node. Migration is therefore an
operator-initiated maintenance runbook, never an unattended
platform migration.
- Standalone etcd: survives. Only the Tenant.spec.etcd bool and the
_namespace.etcd propagation retire; the chart and its
ApplicationDefinition stay.
- Default replicas: 3.
- Reuse mechanism: shared named templates in cozy-lib, not a
subchart. The etcd chart hard-fails unless the release is named
etcd, a subchart inherits the parent release name, and the literal
etcd-*-tls names are pinned by an immutable spec.tls on adopted
clusters.
- Footprint: surfaced in NOTES.txt and the app README.
Also folded in: the minimal values surface from cozystack#3179 (only
etcd.replicas, with the StorageClass derived from it at platform
level), etcd-operator v1alpha2 and the Available condition throughout,
a name-length section with the real 53-character release cap and the
operator's derived names, a delete hook that reaps a per-cluster etcd
but never a shared one, corrected source citations, and a migration
slot of 56+ rather than the stale 49.
Assisted-By: Claude <[email protected]>
Signed-off-by: Myasnikov Daniil <[email protected]>1 parent 35ad494 commit 6e1ceef
1 file changed
Lines changed: 176 additions & 119 deletions
0 commit comments