Migrar do Easypanel
Leve seus serviços do Easypanel para o sh0 um a um, mantendo o Easypanel no ar até cada um ser verificado.
Antes de começar
Este guia segue a migração que fizemos nós mesmos: cerca de vinte serviços de produção de vários projetos, levados do Easypanel para o sh0 e comparados um a um com a produção. O método é deliberadamente sequencial: implantar um serviço no sh0, compará-lo com o que o Easypanel serve e passar ao próximo.
1. Liste o que está rodando
Para cada serviço do Easypanel, anote:
- A origem: repositório Git e branch, o caminho de build se a app estiver numa subpasta, e o nome do Dockerfile se não for o padrão.
- Suas variáveis de ambiente, incluindo as usadas só no build.
- Seus domínios e a porta em que a app escuta.
- Seus dados: bancos de dados que usa e volumes ou montagens onde grava arquivos.
- Se ele escuta em alguma porta. Consumidores de fila e agendadores não escutam, e são criados de outra forma no sh0.
2. Prepare o servidor sh0
Instale o sh0 em outro servidor, não na máquina do Easypanel: os dois precisam das portas 80 e 443. Siga Instalação e depois crie a conta de proprietário.
Antes de mover qualquer coisa, verifique o host. O comando confere o Docker, as portas, o espaço em disco, os certificados e o relógio, e sai com 0 quando nada bloqueia:
sudo sh0 doctorUm exemplo de relatório e o significado de cada linha estão em Atualizações e diagnóstico.
3. Recrie cada app
Crie cada app no sh0 a partir da mesma origem usada no Easypanel:
- Da sua própria máquina, sem provedor Git: sh0 push envia o diretório do projeto e o constrói, com o Dockerfile dele ou, se não houver, detectando a stack.
- Do mesmo repositório Git e branch: veja Deploy via Git. Repositórios privados, branches não padrão e repositórios de outra organização funcionaram na nossa migração.
- Monorepos: defina o caminho de build como a subpasta da app, e o nome do Dockerfile se ele não se chamar Dockerfile. Um Dockerfile nomeado é resolvido em relação ao caminho de build.
- Serviços sem porta (Celery, BullMQ, um agendador): crie-os como Worker (sem porta). O sh0 então verifica se o processo continua vivo em vez de esperar uma porta.
Copie as variáveis de ambiente antes da primeira implantação e depois compare a nova app com a produção: mesmos códigos de status nos mesmos caminhos, mesmo título de página, mesma resposta do endpoint de saúde.
4. Mova os bancos de dados
Crie no sh0 um servidor de banco de dados com o mesmo motor e a mesma versão principal da origem. Depois copie os dados com as ferramentas de dump e restauração do próprio motor. O exemplo abaixo é PostgreSQL.
Substitua EASYPANEL_DB pelo contêiner do banco do Easypanel (encontre-o com docker ps) e sh0-dbsrv-<name> pelo contêiner do servidor de banco do sh0. Use o nome do banco e o usuário mostrados nos dados de conexão do servidor.
docker exec EASYPANEL_DB pg_dump -U app -d app -Fc > app.dumpdocker exec -i sh0-dbsrv-NAME pg_restore -U app -d app --no-owner --no-privileges < app.dump
docker exec sh0-dbsrv-NAME psql -U app -d app -tAc "select count(*) from orders"Copie o arquivo de dump entre os dois servidores com scp ou rsync. Depois aponte o DATABASE_URL da app (ou equivalente) para o servidor de banco do sh0 e reimplante a app.
5. Mova arquivos e volumes
Os arquivos gravados por uma app (uploads, documentos gerados) ficam num volume Docker. Copie o conteúdo do volume por um arquivo tar e depois adicione à app no sh0 um volume com o mesmo caminho de montagem:
docker run --rm -v SOURCE_VOLUME:/data alpine:3.19 tar -czf - -C /data . > uploads.tgzdocker run --rm -i -v TARGET_VOLUME:/data alpine:3.19 tar -xzf - -C /data < uploads.tgz
docker run --rm -v TARGET_VOLUME:/data alpine:3.19 find /data -type fEncontre os nomes dos volumes com docker volume ls em cada servidor. No sh0, os nomes de volume começam com sh0- seguido do nome da app.
O que funciona diferente
- Memória: o Easypanel não define limite por padrão; o sh0 limita cada app a 512 MB, a menos que você aumente. Um backend Python com quatro workers precisou de mais na nossa migração e foi parado pelo limite até o aumentarmos.
- Nomes de serviço: dentro de um projeto, uma app alcança outra pelo nome ou por
<app>.internal, que não muda entre implantações. Atualize os nomes de host que apontavam para nomes de serviço do Easypanel. - Contexto de build: o sh0 lê seu .dockerignore com as regras do Docker, então um projeto que compila no Easypanel compila do mesmo jeito no sh0.
- Um banco novo revela o que um antigo esconde: na nossa migração, uma cadeia de migrações não rodava a partir de um banco vazio e uma app criava suas tabelas a partir de quatro workers ao mesmo tempo. Eram defeitos dos projetos, não das plataformas; restaurar os dados primeiro os evita.
6. Troque os domínios
- Na véspera, reduza o TTL de cada registro DNS que vai mover, para a troca se propagar rápido.
- Adicione o domínio à app no sh0.
- Aponte o registro DNS para o endereço IP do servidor sh0. O sh0 obtém o certificado sozinho assim que o registro resolve para ele.
- Compare o domínio no ar com o que o Easypanel servia.
- Só então pare o serviço no Easypanel. Guarde os dados dele até ter certeza de que não precisará voltar.