Skip to content

Commit 36485b9

Browse files
feat: add controllerrevision section to Statefulset concept page
Signed-off-by: Husni Alhamdani <[email protected]>
1 parent 5674c2d commit 36485b9

File tree

1 file changed

+7
-11
lines changed

1 file changed

+7
-11
lines changed

content/en/docs/concepts/workloads/controllers/statefulset.md

Lines changed: 7 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -383,28 +383,24 @@ After reverting the template, you must also delete any Pods that StatefulSet had
383383
already attempted to run with the bad configuration.
384384
StatefulSet will then begin to recreate the Pods using the reverted template.
385385

386-
## Revision History and ControllerRevisions
386+
## Revision History for StatefulSets
387387

388-
**ControllerRevisions** are Kubernetes objects used by controllers like StatefulSets to track historical configuration changes. StatefulSets use ControllerRevisions to maintain a revision history, enabling rollbacks and version tracking.
388+
ControllerRevisions are Kubernetes objects used by controllers, such as the StatefulSets controller, to track historical configuration changes.
389+
390+
StatefulSets use ControllerRevisions to maintain a revision history, enabling rollbacks and version tracking.
389391

390-
---
391392

392-
### How ControllerRevisions Work with StatefulSets
393+
### How StatefulSets track changes using ControllerRevisions
393394

394395
When you update a StatefulSet's Pod template (`spec.template`), the StatefulSet controller:
395396

396-
1. Creates a new ControllerRevision object
397+
1. Prepares a new ControllerRevision object
397398
2. Stores a snapshot of the Pod template and metadata
398399
3. Assigns an incremental revision number
399400

400401
#### Key Properties
401402

402-
- **Name Format**: `<statefulset-name>-<revision-number>` (e.g., `webapp-2`)
403-
- **Stored Data**:
404-
- Complete Pod template configuration at time of update
405-
- Revision number (monotonically increasing integer)
406-
- Owner reference to the parent StatefulSet
407-
- **Retention**: Automatically deleted when parent StatefulSet is removed
403+
ControllerREvision key properties and other details can be checked [here](docs/reference/kubernetes-api/workload-resources/controller-revision-v1/)
408404

409405
---
410406

0 commit comments

Comments
 (0)