Title here
Summary here
Overview
Schedule Kubernetes resource changes and maintenance restrictions with one cluster-scoped resource. ChangeWindow is a standalone Capsule addon: Capsule core and Tenant objects are not required.
Select namespaces and resource kinds, define recurring windows, then choose what happens inside them. Scale development workloads down overnight and restore their replicas in the morning. Freeze writes during maintenance. Warn users before a window starts, when they interact with affected resources.
| Capability | What it does |
|---|---|
| Schedules | Combine cron windows across named time zones. |
| Resource actions | Apply templated changes at the start and end, including /scale. |
| Admission rules | Deny selected writes during or outside a window, with a custom message. |
| Warnings | Return advance, active, and ending-window notices on API writes. |
| Operations | Inspect readiness, pending restoration, and Prometheus metrics. |
Start with
installation, try the
maintenance example,
or browse the
generated API reference. The current API is
addons.projectcapsule.dev/v1alpha1.
How a window works
- Namespace and resource selectors define the scope.
- Named schedules form a union of overlapping or adjacent windows.
- On entry, the controller snapshots matching resources, records captures, and applies start actions using the configured executor service account.
- Admission rules and warnings evaluate the current time on each affected write.
- On exit, end actions restore or change the recorded resources. Failed actions retry using the durable journal.
Admission rules can be used on their own, without resource actions or an executor. Resource actions are transitions: after a successful patch, they do not continuously enforce the value throughout the window.
Next
Installation