O n8n actualiza-se descarregando a imagem nova e recriando o contentor. Os seus dados ficam, porque estão no volume. O que pode correr mal não é o comando, é saltar versões sem ler as notas e não ter cópia para onde voltar. Faça nesta ordem.
A actualização, por ordem
| 1 |
Faça uma cópia primeiro. Dados, compose e chave de encriptação, como em cópia de segurança do n8n. Ao arrancar com uma versão nova, o n8n pode alterar a estrutura dos dados, e isso não se desfaz sozinho.
|
|
| 2 |
Leia as notas da versão no site do projecto, sobretudo se vai saltar várias versões de uma vez. É lá que vêm as mudanças que obrigam a alterar fluxos ou variáveis.
|
|
| 3 |
Ponha uma versão fixa no compose, em vez de uma etiqueta que anda sempre para a frente. O nome exacto das etiquetas está na página da imagem oficial. Assim sabe sempre em que versão está e só muda quando decide.
|
|
| 4 |
Descarregue e recrie com docker compose pull e docker compose up -d.
|
|
| 5 |
Veja os registos com docker compose logs. Procure erros nos primeiros momentos.
|
|
| 6 |
Teste os fluxos importantes à mão, um a um: um webhook, um agendamento, uma credencial de cada tipo.
|
|
O que costuma partir
| Sintoma |
Causa provável |
O que fazer |
| O n8n não arranca depois |
Uma variável antiga já não é aceite, ou a migração dos dados falhou. |
Leia os registos; compare as variáveis com as notas da versão. |
| Um nó deixou de funcionar |
Mudou o comportamento ou foi substituído. |
Procure o nó na documentação da sua versão. |
| As credenciais deram erro |
A chave de encriptação mudou, ou foi apagada com o volume. |
Ponha de volta a chave original. |
| Os webhooks não respondem |
O contentor novo perdeu WEBHOOK_URL. |
Reponha a variável. Veja webhooks do n8n. |
|
Voltar atrás nem sempre é só mudar a versão. Se a versão nova já alterou a estrutura dos dados, voltar à antiga pode não funcionar. O caminho seguro é repor a cópia que fez no início e arrancar com a versão antiga.
|
Quando actualizar
Actualize de tempos a tempos, e sem pressa, mas não deixe passar muito. Uma instalação parada durante muito tempo acumula falhas de segurança conhecidas e torna o salto seguinte mais arriscado. Fora do horário em que os fluxos importantes correm, e com tempo para os testar. O método geral para qualquer aplicação em Docker está em actualizar uma aplicação Docker sem perder dados.
|
Se tem fluxos críticos, ensaie a actualização numa cópia: restaure a sua cópia num segundo VPS ou numa pasta à parte, actualize aí e só depois faça no verdadeiro. Também liberta espaço no disco: Docker a encher o disco.
|
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.940,00 Kz/mês (plano de 3 anos, com cupão) Ver planos |
Português
English
