A regra é simples: cópia primeiro, actualização depois, e uma versão de cada vez. A Evolution API depende de uma biblioteca não oficial que acompanha as mudanças do WhatsApp, por isso as versões novas aparecem a um ritmo que não controla. O que controla é o momento em que actualiza e o que tem guardado se correr mal.
O que tem de ser copiado
| O quê |
Porquê |
| A base de dados (PostgreSQL ou MySQL) |
Guarda as instâncias e os dados. É a cópia que mais conta. Veja cópias com mysqldump e pg_dump. |
| Os volumes das instâncias |
As sessões que o ficheiro compose manda guardar. Sem eles, a cópia da base de dados pode não chegar para voltar ligado. |
| O ficheiro de definições |
Tem a chave da API e as palavras-passe. Sem ele não recria o serviço. Guarde-o num sítio privado, fora do servidor. |
| O ficheiro compose |
Diz que versão corria e como estava montado. |
Uma cópia que está no mesmo servidor serve contra um erro seu, não contra a perda do servidor. Leve-a para fora. Para as opções, veja cópias de um VPS: instantâneos ou ficheiros.
Actualizar, passo a passo
| 1 |
Faça a cópia da base de dados, dos volumes e dos ficheiros, e confirme que a consegue abrir.
|
|
| 2 |
Leia as notas da versão no repositório do projecto. Procure mudanças que quebrem a configuração, definições renomeadas e avisos sobre a base de dados.
|
|
| 3 |
Mude a versão da imagem no compose para a que escolheu. Prefira uma versão concreta a seguir a «mais recente».
|
|
| 4 |
Descarregue e recrie: docker compose pull e depois docker compose up -d.
|
|
| 5 |
Leia os registos com docker compose logs -f. A API tem de arrancar sem erros e as instâncias têm de voltar ligadas.
|
|
| 6 |
Teste a sério: envie uma mensagem e receba outra pelo webhook, antes de dar a actualização por boa.
|
|
|
Voltar atrás nem sempre é só trocar a versão. Se a versão nova alterou a base de dados, a antiga pode já não a perceber. Por isso a cópia é anterior à actualização: restaurar essa cópia e voltar à versão anterior é o recuo seguro. Para o princípio geral, veja actualizar uma aplicação Docker sem perder dados.
|
Quando actualizar
| 1 |
Quando há um problema que a nova versão resolve, como uma instância presa em «connecting». Veja as causas habituais.
|
|
| 2 |
Quando há uma correcção de segurança.
|
|
| 3 |
Fora do horário de uso. A actualização interrompe o serviço durante algum tempo, e as mensagens que chegam nesse intervalo podem perder-se.
|
|
|
Cada vez que a actualização funcionar, anote a versão e a data. Na próxima vez que algo falhar, saber qual foi a última boa poupa horas. E teste a restauração uma vez, num servidor de ensaio, antes de precisar dela de verdade. A manutenção é sua, como diz a Política de Suporte.
|
|
Precisa de espaço para as cópias e para um servidor de ensaio? Veja os VPS.
Ver servidores VPS
|
PRODUTO RECOMENDADO Alojamento de sites com cPanel Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde 5,94 €/mês (plano de 3 anos, com cupão) Ver planos |
Angola
Brasil
Kenya
Moçambique
Nigeria
Portugal
South Africa
United Kingdom
United States
International
