Pular para o conteúdo principal

​
Visão geral

O CaseBender é distribuído como um conjunto de imagens de contêiner versionadas. Atualizar significa baixar as imagens mais recentes e recriar os contêineres. Seus dados, a licença e a configuração residem em volumes Docker nomeados e no seu arquivo .env — ambos são preservados durante as atualizações, portanto uma atualização nunca afeta seus casos, usuários, credenciais ou licença, desde que você os mantenha.
As migrações de banco de dados e o seeding de dados padrão são executados automaticamente na inicialização após cada atualização. Você não precisa executar nenhum comando de migração manualmente.

​
O que é preservado nas atualizações

Nunca execute docker compose down -v em um sistema de produção. A opção -v apaga todos os volumes nomeados — seu banco de dados, licença e arquivos. Sem esses volumes, a próxima inicialização cria um banco de dados novo, o que redefine a senha do administrador para o padrão e regenera a licença.

​
Procedimento de atualização (Docker Compose)

1

Faça backup do banco de dados e do .env

2

Baixe as imagens mais recentes

3

Recrie os contêineres

O Compose recria apenas os serviços cuja imagem mudou e mantém seus volumes.
4

Acompanhe os logs

As migrações e o seeding são executados na inicialização — aguarde a aplicação reportar que está saudável (healthy).

​
Verificação após a atualização

  • Faça login e confirme que seus casos, alertas e usuários existentes estão presentes.
  • Confirme que seu login ainda funciona (sua senha de administrador não muda).
  • Verifique se o worker está processando os jobs:

​
Rollback

Se algo der errado, fixe a tag da imagem anterior e restaure seu backup:
Sempre atualize primeiro um ambiente de staging e faça um backup recente do banco de dados imediatamente antes de atualizar a produção.

​
Erros comuns de atualização

Os dois problemas mais comuns vêm da perda de estado:
  • Alterar o nome do projeto ou o diretório do Compose. O Docker deriva os nomes dos volumes a partir do projeto. Renomear a pasta ou usar um nome de projeto -p diferente faz o Compose apontar para volumes novos e vazios. Sempre atualize a partir do mesmo diretório/projeto para reutilizar seus volumes existentes.
  • LICENSE_SECRET_KEY ausente e sem o volume casebender_secret. Em implantações antigas sem o volume de segredo persistente, defina LICENSE_SECRET_KEY no .env (ou adicione o volume) para que a licença sobreviva. As implantações atuais a preservam automaticamente.

​
Instalador Desktop

Se você fez a implantação com o Instalador Desktop, use o fluxo de atualização integrado do aplicativo — ele baixa as imagens mais recentes e recria os serviços preservando seu diretório de dados, o .env e a chave de licença.

​
Google Cloud Run

As atualizações no Cloud Run implantam uma nova revisão. Como o Cloud Run tem um sistema de arquivos efêmero, o segredo da licença deve ser fornecido via Secret Manager como LICENSE_SECRET_KEY para que persista entre revisões. Reimplante usando sua instância do Cloud SQL e os segredos existentes:
As migrações são executadas automaticamente na nova revisão.