Aparência
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
Atualize a CLI:
bashfinnest update --check finnest update --yes finnest versionA atualização troca a CLI e o pacote de runtime juntos. No Windows nativo, rode de novo o instalador.
O
finnest updaterespondePLANE_CAPABILITY_DISABLEDquando~/.finnest/config.tomltemself_update = falsena seção[plane]. Ofinnest initgrava esse valor por padrão. Se a política da instituição permitir, apague a linha ou troque-a porself_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.
Confira o alvo:
bashCLOUD=aws ENVIRONMENT=sandbox # ou: azure, prod finnest doctor --cloud="$CLOUD" --environment="$ENVIRONMENT"Revise o plano de mudanças:
bashCLOUD=aws ENVIRONMENT=sandbox # ou: azure, prod finnest deploy --cloud="$CLOUD" --environment="$ENVIRONMENT" --previewAplique:
bashCLOUD=aws ENVIRONMENT=sandbox # ou: azure, prod finnest deploy --cloud="$CLOUD" --environment="$ENVIRONMENT" --apply --yesO deploy roda automaticamente as migrações do banco e a configuração do Keycloak, antes de liberar a nova versão.
Verifique:
bashCLOUD=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
Cada versão da CLI implanta o conjunto de imagens que veio com ela. Para manter uma versão homologada, por exemplo num pipeline, rode sempre a mesma versão da CLI.
O finnest update sempre busca a versão estável mais recente; ele não escolhe uma versão anterior. Para instalar uma versão específica, na estação ou num pipeline, use o instalador dessa versão:
bash
VERSAO="<versão>" # por exemplo, 0.33.1
BASE="https://github.com/finnestbr/finnest-static/releases/download/cli-v$VERSAO"
curl --proto '=https' --proto-redir '=https' -fL "$BASE/install.sh" | FINNEST_CLI_BASE_URL="$BASE" shO instalador confere o SHA-256 e a assinatura cosign antes de instalar.
Para fixar a imagem de um só módulo, defina FINNEST_RUNTIME_IMAGE_TAG_<MÓDULO> antes do deploy, por exemplo FINNEST_RUNTIME_IMAGE_TAG_BANKING. A variável FINNEST_RUNTIME_IMAGE_TAG aplica uma só tag a todos os módulos. Nos dois casos, a tag precisa existir no registro de onde o alvo baixa as imagens.
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.