Kubernetes 1.37: Storage Version Migration GA torna versões antigas um trabalho observável

O sinal e os factos que mudam a decisão

No Kubernetes 1.37, a API storagemigration.k8s.io/v1 e o controlador integrado de Storage Version Migration chegaram a Stable e ficam ativos por defeito. A migração reescreve objetos existentes na versão de armazenamento preferida e expõe estado declarativo, substituindo scripts manuais difíceis de observar.

Alterar a storage version afeta novas escritas, mas objetos existentes permanecem antigos até serem reescritos pela API. A mesma necessidade surge na rotação de encriptação: chaves antigas não podem sair em segurança enquanto objetos ainda dependerem delas.

O controlador atualiza condições de progresso e sucesso; para CRD, storedVersions precisa refletir apenas a versão preferida após confirmação. Um estado Succeeded pode envelhecer se o CRD mudar durante a migração; a documentação indica que nesse caso a migração deve ser repetida. APIs agregadas ou recursos com comportamento fora dos pressupostos, pressão no apiserver e conflitos de escrita exigem canário, limites e observação.

Decisão, limites e condição de bloqueio

Inclua uma migração explícita antes de remover versões antigas de CRD ou retirar chaves anteriores de encriptação. Inventarie resources e storedVersions, aplique um objeto por recurso, observe condições, confirme conclusão e só depois altere serving, status do CRD ou material criptográfico.

Um estado Succeeded pode envelhecer se o CRD mudar durante a migração; a documentação indica que nesse caso a migração deve ser repetida. APIs agregadas ou recursos com comportamento fora dos pressupostos, pressão no apiserver e conflitos de escrita exigem canário, limites e observação.

Execução e prova de conclusão

A execução deve começar por exportar recursos, contagens, tamanho, versões servidas e armazenadas, conversão, encriptação, dependências e taxa normal de escrita. Depois, migrar um recurso canário, limitar concorrência operacional, observar apiserver, etcd, conflitos, latência, erros e estado do objeto. O fecho exige reconciliar contagens, repetir após alteração concorrente do crd e guardar prova antes de remover versão ou chave antiga.

A mudança fecha quando todos os objetos do recurso foram reescritos, Succeeded é atual e coerente com a geração, storedVersions e leitura funcionam, métricas permanecem dentro do orçamento e restauração foi testada antes da remoção irreversível.

• exportar recursos, contagens, tamanho, versões servidas e armazenadas, conversão, encriptação, dependências e taxa normal de escrita.
• migrar um recurso canário, limitar concorrência operacional, observar apiserver, etcd, conflitos, latência, erros e estado do objeto.
• reconciliar contagens, repetir após alteração concorrente do CRD e guardar prova antes de remover versão ou chave antiga.
• A mudança fecha quando todos os objetos do recurso foram reescritos, Succeeded é atual e coerente com a geração, storedVersions e leitura funcionam, métricas permanecem dentro do orçamento e restauração foi testada antes da remoção irreversível.