Guias /

Atualização

/

Atualização de imagem Docker

Atualização de imagem Docker

Este guia aplica-se apenas à imagem oficial do Piwigo. Se estiver a utilizar um contentor de servidor Linux, consulte a respetiva documentação.

Se você quiser mudar para a imagem oficial, pode seguir este guia

Etapa 1 - Verificando atualizações

Os números de versão dos contêineres sempre corresponderão à versão do Piwigo. A partir da versão 16.3.0, eles terão uma letra adicional para permitir atualizações específicas do contêiner.

Para a versão 16.3 e superior do contêiner.

Você já deve conseguir ver se há alguma atualização disponível na interface de atualização. Se quiser atualizar para a versão secundária, use o primeiro número da tag (ex: 16).

Para a versão 16.2 e inferiores do contêiner.

Acesse a lista de tags e pesquise a tag que deseja atualizar.

Passo 2 - Criar um backup

Para garantir que a atualização seja feita sem riscos, você deve fazer um backup tanto do banco de dados quanto dos arquivos da sua instância do Piwigo.

Backup do banco de dados

Você pode criar um backup do seu banco de dados usando o seguinte comando:

docker exec -it piwigo-db-1 mariadb-dump -u piwigodb_user -p "piwigodb" | tee db_dump.sql

A senha do banco de dados deve ser a mesma que você inseriu em .env (certifique-se de substituir o nome do contêiner para que corresponda ao seu).

Agora você pode parar seu contêiner executando docker compose down

Backup de arquivos

Para fazer backup de qualquer imagem/foto carregada no seu Piwigo, copie as seguintes pastas:


      ./piwigo-data/piwigo/
      ├── galleries
      ├── local
      └── upload
    

Faça backup dos arquivos compose e env.

Renomeie seus arquivos compose e env adicionando .bak ao final (ex: .env.bak)

Etapa 3 - Obtendo o novo arquivo compose e atualizando o arquivo .env

Você pode obter a versão mais recente do arquivo compose.yaml usando o seguinte comando:

curl -O "https://raw.githubusercontent.com/Piwigo/piwigo-docker/refs/heads/main/compose.yaml"

Consulte o wiki do GitHub para obter o arquivo .env correspondente à sua versão.

Etapa 4 - Atualizando e reiniciando o contêiner

Baixe a imagem com docker compose pull -d e reinicie-a com docker compose up.

Você pode verificar os logs com docker logs e o nome (terminando com piwigo-main-1).

Ainda tem alguma dúvida?

Você pode obter ajuda no fórum ou encontrar suas próprias respostas na documentação