zeekayandHanzo Dev 6c42f1e6f0 docs: the CRD API version migration order, and the incident that proves it ...

Removing v1alpha1 before deploying the binary that speaks v1 took the control
plane down on 2026-07-28: the running controller listed *v1alpha1.Application
against an API that no longer served it, CrashLooped, and 65 Applications plus
the ApplicationSet were lost.

The workloads survived only because the resources-finalizer never fired, and
recovery was possible only because everything was reconstructible from git.

Every CRD migration step was individually correct. The unchecked thing was
which version the running consumer speaks.

Co-authored-by: Hanzo Dev <[email protected]>

2026-07-28 17:24:55 -07:00

..

applicationset

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

notifications

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

server-commands

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

templates

docs: Add release checklist step to reference the release-specific instructions file (#25854)

2026-01-13 16:08:40 +02:00

upgrading

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

user-management

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

api-version-migration.md

docs: the CRD API version migration order, and the incident that proves it

2026-07-28 17:24:55 -07:00

app-any-namespace.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

app-sync-using-impersonation.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

application.yaml

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

applicationset.yaml

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

architecture.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

cd-cm-yaml.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

cd-cm.yaml

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

cd-cmd-params-cm-yaml.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

cd-cmd-params-cm.yaml

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

cd-rbac-cm-yaml.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

cd-rbac-cm.yaml

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

cd-repo-creds-yaml.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

cd-repo-creds.yaml

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

cd-repositories-yaml.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

cd-repositories.yaml

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

cd-secret-yaml.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

cd-secret.yaml

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

cd-ssh-known-hosts-cm-yaml.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

cd-ssh-known-hosts-cm.yaml

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

cd-tls-certs-cm-yaml.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

cd-tls-certs-cm.yaml

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

cluster-bootstrapping.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

cluster-management.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

config-management-plugins.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

core.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

custom_tools.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

custom-styles.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

declarative-setup.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

deep_links.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

disaster_recovery.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

dynamic-cluster-distribution.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

feature-maturity.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

git_configuration.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

health.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

high_availability.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

index.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

ingress.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

installation.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

managed-by-url.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

metrics.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

mtls.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

project-specification.md

docs: add CRD specification example files to docs (#14021)

2023-06-19 13:40:44 +03:00

project.yaml

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

rbac.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

reconcile.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

resource_actions_builtin.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

resource_actions.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

secret-management.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

security.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

signed-release-assets.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

tested-kubernetes-versions.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

tls.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

troubleshooting.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

ui-customization.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

web_based_terminal.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00

webhook.md

cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai

2026-07-28 16:32:14 -07:00