Atualização de versão

A versão da plataforma implantada acompanha a versão da CLI. Atualizar é, portanto, atualizar a CLI e fazer um novo deploy.

Antes de começar

• Leia as notas da versão nova.
• Confirme que o backup automático do banco está em dia. Veja Backup.
• Planeje a janela de mudança; em produção, combine o congelamento de outras mudanças.
• Se possível, atualize primeiro o sandbox e rode os testes de fumaça e de conformidade.

Passo a passo

1. Atualize a CLI:

   finnest update --check
   finnest update --yes
   finnest version

   A atualização troca a CLI e o pacote de runtime juntos. No Windows nativo, instale a nova versão manualmente.

   O finnest update só funciona com a atualização automática ligada. O finnest init a deixa desligada, e o comando responde PLANE_CAPABILITY_DISABLED. Se a política da instituição permitir, ligue-a na configuração do operador, em ~/.finnest/config.toml:

   [plane]
   self_update = true

   Se a atualização automática precisar ficar desligada, rode de novo o instalador: ele baixa a versão estável mais recente e confere o SHA-256 e a assinatura cosign antes de instalar.

2. Confira o alvo:

   CLOUD=aws ENVIRONMENT=sandbox  # ou: azure, prod
   finnest doctor --cloud="$CLOUD" --environment="$ENVIRONMENT"

3. Revise o plano de mudanças:

   CLOUD=aws ENVIRONMENT=sandbox  # ou: azure, prod
   finnest deploy --cloud="$CLOUD" --environment="$ENVIRONMENT" --preview

4. Aplique:

   CLOUD=aws ENVIRONMENT=sandbox  # ou: azure, prod
   finnest deploy --cloud="$CLOUD" --environment="$ENVIRONMENT" --apply --yes

   O deploy roda automaticamente as migrações do banco e a configuração do Keycloak, antes de liberar a nova versão.

5. Verifique:

   CLOUD=aws ENVIRONMENT=sandbox  # ou: azure, prod
   finnest smoke --cloud="$CLOUD" --environment="$ENVIRONMENT"
   finnest status --cloud="$CLOUD" --environment="$ENVIRONMENT"

Se algo falhar

• Se as migrações ou a configuração do Keycloak falharem por um problema passageiro, corrija a causa e repita o deploy com --rerun-operations, que força essas etapas a rodar de novo.
• Para os demais casos, siga Recuperação de deploy.

Fixar uma versão

Para manter uma versão específica (por exemplo, num pipeline com versão homologada), defina FINNEST_RUNTIME_IMAGE_TAG com a versão desejada antes do deploy.

O finnest update sempre busca a versão estável mais recente; ele não escolhe uma versão anterior. Para rodar uma versão específica da CLI:

• em pipelines, use a imagem de contêiner da versão, ghcr.io/finnestbr/finnest:<versão>;
• na estação do operador, peça à Finnest os arquivos assinados da versão e instale-os com o instalador, que confere a assinatura antes de instalar.

A opção finnest update --allow-downgrade --yes serve só para um caso: aceitar a versão estável publicada quando ela for mais antiga que a instalada, por exemplo depois que a Finnest recolher uma versão.