Skip to content

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:

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

    A atualização troca a CLI e o pacote de runtime juntos. No Windows nativo, rode de novo o instalador.

    O finnest update responde PLANE_CAPABILITY_DISABLED quando ~/.finnest/config.toml tem self_update = false na seção [plane]. O finnest init grava esse valor por padrão. Se a política da instituição permitir, apague a linha ou troque-a por 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:

    bash
    CLOUD=aws ENVIRONMENT=sandbox  # ou: azure, prod
    finnest doctor --cloud="$CLOUD" --environment="$ENVIRONMENT"
  3. Revise o plano de mudanças:

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

    bash
    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:

    bash
    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 ​

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" sh

O 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.

Finnest Power — plataforma Open Finance Brasil e Open Insurance Brasil. Contato: oi@finnest.com.br