Atualizar o Pier
Trocar de versão sem perder dados.
Atualizar o Pier é trocar a versão do código e rodar o instalador de novo. Os dados ficam onde estão e as migrations do banco rodam sozinhas.
Versões
O Pier segue o versionamento semântico. Cada versão beta é uma tag vX.Y.Z no repositório, com as notas em Releases. A versão beta atual é a 0.9.0.
Enquanto o número começar com 0., uma versão nova pode mudar comportamentos. Leia as notas antes de atualizar.
Antes de atualizar
Faça um backup da instância e guarde fora do servidor.
Pare o painel com
docker compose stop piere copie o banco do Pier. Não copie um SQLite ativo sem coordenar seu WAL. As migrations não têm volta, então esta cópia é o seu caminho para voltar à versão anterior:sh. ./.env sudo cp "$PIER_DATA_DIR/pier.db" "$PIER_DATA_DIR/pier.db.antes-da-atualizacao"Confira se não há deploys em andamento.
Atualizar
Na pasta pier, no servidor, troque vX.Y.Z pela versão nova:
git fetch --depth 1 origin tag vX.Y.Z
git checkout vX.Y.Z
./install.shO instalador baixa a imagem GHCR da versão selecionada e recria o container. Se o download falhar, veja o que fazer ou construa o código localmente com PIER_BUILD=1 ./install.sh. O .env é mantido. O painel fica fora do ar por alguns segundos, mas as aplicações continuam respondendo.
Confira a versão em execução:
docker compose exec pier wget -q -O - http://127.0.0.1:8700/api/v1/versionVoltar para a versão anterior
Pare o painel:
docker compose stop pier.Volte o banco copiado antes da atualização:
sh. ./.env sudo cp "$PIER_DATA_DIR/pier.db.antes-da-atualizacao" "$PIER_DATA_DIR/pier.db" sudo rm -f "$PIER_DATA_DIR/pier.db-wal" "$PIER_DATA_DIR/pier.db-shm"Volte o código e reinstale:
shgit checkout vVERSAO-ANTERIOR ./install.sh
O que mudou entre a cópia e a volta, como um deploy novo, fica de fora.
Notas da versão 0.5.0
Quem vem de uma instalação anterior à 0.5.0 precisa de três passos a mais. O roteamento ficou mais restrito: o proxy só encaminha para containers marcados pelo Pier com o token do servidor.
Rede do painel. O instalador cria a rede
pier-panelsozinho. Se você subir o Pier sem o instalador, crie a rede antes:shdocker network inspect pier-panel >/dev/null 2>&1 || docker network create pier-panelProxy. Em Infraestrutura › servidor local › Proxy, recrie o proxy. Faça o mesmo nos outros servidores.
Recursos com domínio. Implante de novo cada aplicação e stack que tem domínio. Até o novo deploy, elas deixam de ser roteadas.
Outras novidades da 0.5.0: comando de release, segredos de build, promoção entre ambientes, deploy por tag, processos e réplicas, pier.yaml, pierctl up, restauração e teste de backups, backup da instância, alertas de execução e uptime, auditoria e ambientes protegidos.
Atualizar a pierctl
Baixe o binário da versão nova, como na instalação da pierctl, e substitua o antigo. A CLI e o servidor falam a mesma API (v1). Mantenha os dois na mesma versão para ter todos os comandos.