Tutorial do Debian 13 / Migrar um serviço para outro servidor Debian 13 e testar a reversão

Ao migrar serviços para um novo servidor Debian, você deve primeiro preparar o ambiente de execução e as contas, depois restaurar o backup final realizado enquanto as gravações estavam interrompidas e, finalmente, comparar a funcionalidade e os dados. A migração não é concluída apenas ao alterar o acesso, e você deve decidir como preservar quaisquer dados gerados no novo servidor para reverter com segurança para o servidor original.

Definir o escopo da migração e identificar cada servidor

Este exercício migra um pequeno serviço HTTP somente leitura feito com Python entre duas máquinas virtuais (VMs) Debian 13. Ele fornece o programa, os dados e a unidade systemd, e responde apenas em 127.0.0.1:8085. Como descrito na documentação do Python http.server, este não é um exemplo para uso como servidor de produção voltado para a internet. A migração do esquema de banco de dados, alterações reais do sistema de nomes de domínio (DNS, Domain Name System) e mudanças externas na configuração de segurança TLS (Transport Layer Security) não estão incluídas neste exercício.

Funções Conexão do exercício O que verificar
Origem old-server Host 127.0.0.1:22212 → SSH da VM original Resposta de referência, backup final, parar e reiniciar
Destino new-server Host 127.0.0.1:22213 → VM de destino SSH Conta dedicada · Restauração · Resposta do serviço · Reiniciar
Computador de trabalho SSH/SCP que verifica individualmente as chaves do host dos dois servidores Transferência de backup, comparação de hash, seleção do alvo de conexão

Mesmo que o mesmo endereço 10.0.2.15 apareça dentro das duas VMs usando tradução de endereços de rede (NAT, Network Address Translation), elas não são o mesmo servidor. Neste exemplo, diferentes portas de loopback do host foram conectadas via VirtualBox Network → NAT → Advanced → Port Forwarding. Substitua pelo endereço e porta reais do seu servidor e verifique separadamente a identidade e a chave do host de cada servidor. Durante o exercício, a inicialização da VM alvo foi interrompida, então ela foi reiniciada após um desligamento normal via ACPI, e a restauração foi realizada apenas após confirmar que o alvo podia se conectar com sucesso.

No computador Linux de trabalho, você pode definir um alias como o seguinte no ~/.ssh/config. Substitua o caminho da chave privada pelo seu próprio, e não copie senhas ou conteúdos de chave privada em textos ou logs.

Host old-server
    HostName 127.0.0.1
    Port 22212
    User lfstudent
    IdentityFile ~/.ssh/id_ed25519

Host new-server
    HostName 127.0.0.1
    Port 22213
    User lfstudent
    IdentityFile ~/.ssh/id_ed25519

Cada servidor requer Python 3, curl e tar. Se não estiverem instalados, prepare-os com o sudo apt install python3 curl tar, e instale os clientes SSH e SCP no computador de trabalho. O exemplo original abaixo assume a conta lfstudent existente com ID de usuário (UID) e ID de grupo (GID) 1000 do tutorial. Se estiver usando uma conta diferente, também altere as diretivas User e Group e os proprietários dos arquivos. Use um novo ambiente de prática que não sobrescreva diretórios ou serviços existentes com o mesmo nome.

Criar o serviço completo na origem e fazer backup com ele parado

Execute no servidor de origem. Este bloco cria programas, dados e unidades, compara as respostas e então interrompe o serviço. Ao criar o arquivo tar final, o serviço somente leitura deste exercício já está parado. Outros serviços ou arquivos de prática de atualização existentes não são alvos.

sudo bash <<'ROOT'
set -euo pipefail
for p in /opt/lf-migrate35 /var/lib/lf-migrate35 /var/backups/lf-migrate35 /etc/systemd/system/lf-migrate35.service; do test ! -e "$p"; done
test "$(id -u lfstudent)" = 1000
test -z "$(ss -H -ltn 'sport = :8085')"
install -d -m 755 /opt/lf-migrate35
install -d -m 750 -o lfstudent -g lfstudent /var/lib/lf-migrate35
install -d -m 700 /var/backups/lf-migrate35
cat > /opt/lf-migrate35/app.py <<'PY'
from http.server import BaseHTTPRequestHandler, HTTPServer
from pathlib import Path

class Handler(BaseHTTPRequestHandler):
    def do_GET(self):
        if self.path != '/':
            self.send_error(404)
            return
        try:
            body = Path('/var/lib/lf-migrate35/message.txt').read_bytes()
            status = 200
        except OSError:
            body = b'data unavailable\n'
            status = 503
        self.send_response(status)
        self.send_header('Content-Type', 'text/plain; charset=utf-8')
        self.send_header('Content-Length', str(len(body)))
        self.end_headers()
        self.wfile.write(body)

HTTPServer(('127.0.0.1', 8085), Handler).serve_forever()
PY
cat > /etc/systemd/system/lf-migrate35.service <<'UNIT'
[Unit]
Description=LF migration lab 35
After=network.target

[Service]
Type=exec
User=lfstudent
Group=lfstudent
ExecStart=/usr/bin/python3 /opt/lf-migrate35/app.py
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true

[Install]
WantedBy=multi-user.target
UNIT
printf 'migration payload 35\n' > /var/lib/lf-migrate35/message.txt
chown lfstudent:lfstudent /var/lib/lf-migrate35/message.txt
chmod 640 /var/lib/lf-migrate35/message.txt
systemctl daemon-reload
systemctl enable --now lf-migrate35.service
sleep .4
curl -fsS http://127.0.0.1:8085/ > /var/backups/lf-migrate35/before.txt
cmp /var/lib/lf-migrate35/message.txt /var/backups/lf-migrate35/before.txt
systemctl stop lf-migrate35.service
tar --numeric-owner -cpf /var/backups/lf-migrate35/service.tar -C / opt/lf-migrate35 var/lib/lf-migrate35 etc/systemd/system/lf-migrate35.service
cd /var/backups/lf-migrate35
sha256sum service.tar > service.sha256
sha256sum -c service.sha256
echo SOURCE_STOPPED_FINAL_SAMPLE_BACKUP_READY
ROOT

Se o breve atraso de inicialização for insuficiente e o curl falhar, inspecione sudo systemctl status lf-migrate35.service e sudo journalctl -u lf-migrate35.service -n 30. Verifique caminhos, propriedade e conflitos de porta, e então tente novamente a solicitação e comparação falhas após a prontidão. Não execute novamente o bloco de criação sobre recursos parcialmente criados ou crie o arquivo final antes de interromper a origem. Certifique-se de que solicitações curl locais ignorem qualquer proxy configurado.

O resultado esperado é service.tar: OK e uma mensagem de preparação do backup. A resposta normal é uma única linha migration payload 35. Se não houver dados ou eles forem ilegíveis, este serviço retorna 503, e não revela listas de arquivos nem lê outros caminhos.

Para serviços reais de banco de dados ou upload de arquivos, você precisa avaliar se parar apenas um processo é suficiente. Pare trabalhos em lote, consumidores de fila, gravações em outros servidores, ou use os métodos de dump consistente ou backup online do produto. Se você ressincronizar as alterações finais após a cópia inicial em massa, registre os dois pontos no tempo e os intervalos de parada de gravação.

Transferir o backup pela estação de trabalho

Execute o bloco de exportação no servidor de origem como lfstudent. Pare se o diretório de exportação já existir ou se alguma cópia falhar. Na estação de trabalho, pare se mkdir migration35, verificação de checksum ou criação do diretório de importação de destino falhar; não permita que comandos scp posteriores reutilizem um diretório antigo.

Copie apenas os dois arquivos do exercício, o tar e sua soma de verificação, sem abrir o acesso ao diretório de backup exclusivo de root na origem, para um diretório dedicado para a conta prática. Para backups de serviço reais, aplique políticas separadas de criptografia e armazenamento dependendo se eles contêm informações confidenciais.

test ! -e "$HOME/lf-migrate35-export"
install -d -m 700 "$HOME/lf-migrate35-export"
sudo install -m 600 -o "$(id -un)" -g "$(id -gn)" /var/backups/lf-migrate35/service.tar /var/backups/lf-migrate35/service.sha256 "$HOME/lf-migrate35-export/"

Execute na estação de trabalho Linux. Confirme que os aliases SSH apontam para os servidores pretendidos, então receba os arquivos em um novo diretório local dedicado.

ssh old-server hostname
ssh new-server hostname
mkdir -m 700 migration35
scp old-server:lf-migrate35-export/service.tar old-server:lf-migrate35-export/service.sha256 migration35/
cd migration35
sha256sum -c service.sha256
tar -tvf service.tar
ssh new-server 'test ! -e "$HOME/lf-migrate35-import" && install -d -m 700 "$HOME/lf-migrate35-import"'
scp service.tar service.sha256 new-server:lf-migrate35-import/

O hash deve corresponder, e a lista deve incluir apenas opt/lf-migrate35, var/lib/lf-migrate35 e a unidade de serviço relevante. Conceda permissões de restauração apenas aos arquivos confiáveis que você mesmo criou e pare se houver caminhos absolutos, caminhos que sobem ao diretório pai com .. ou links inesperados. O checksum serve para verificar danos durante a transferência e não substitui a confiança na fonte. Opções de SCP e métodos de transferência podem ser encontrados no manual scp do OpenSSH.

Restaurar no destino com uma conta dedicada

Execute no servidor de destino. Primeiro confirme que /opt/lf-migrate35, /var/lib/lf-migrate35, /var/backups/lf-migrate35 e /etc/systemd/system/lf-migrate35.service estão ausentes e que getent passwd lf-migrate35 não encontra nenhuma conta existente. Se sudo ss -ltn mostrar que a porta 8085 está ocupada, pare e investigue.

Todas as verificações de ausência do destino anteriores são obrigatórias: o bloco de restauração assume que elas foram aprovadas. Confirme também que getent group lf-migrate35 não encontra nenhum grupo existente. O caminho de importação assume que o diretório home da conta de login é /home/lfstudent ; substitua-o de forma consistente se o seu for diferente. A afirmação final UID-não-1000 demonstra IDs diferentes neste laboratório; o mapeamento bem-sucedido em produção é definido pela identidade de destino pretendida, e não por uma diferença de número universalmente exigida.

O arquivo tar é extraído primeiro em um diretório de preparação, e apenas os arquivos necessários são instalados. Após confirmar a ausência da unidade de destino, o bloco cria somente a unidade deste exercício; ele não substitui todo o /etc do destino. Em vez de copiar o UID numérico original, redefine a propriedade dos dados para o nome da conta dedicada do destino.

sudo bash <<'ROOT'
set -euo pipefail
install -d -m 700 /var/backups/lf-migrate35
mv -- /home/lfstudent/lf-migrate35-import/service.tar /home/lfstudent/lf-migrate35-import/service.sha256 /var/backups/lf-migrate35/
rmdir /home/lfstudent/lf-migrate35-import
chown root:root /var/backups/lf-migrate35/service.tar /var/backups/lf-migrate35/service.sha256
chmod 600 /var/backups/lf-migrate35/service.tar /var/backups/lf-migrate35/service.sha256
cd /var/backups/lf-migrate35
sha256sum -c service.sha256
mkdir -m 700 staging
tar -xpf service.tar -C staging
useradd --system --user-group --home-dir /var/lib/lf-migrate35 --no-create-home --shell /usr/sbin/nologin lf-migrate35
install -d -m 755 /opt/lf-migrate35
install -m 644 staging/opt/lf-migrate35/app.py /opt/lf-migrate35/app.py
install -d -m 750 -o lf-migrate35 -g lf-migrate35 /var/lib/lf-migrate35
install -m 640 -o lf-migrate35 -g lf-migrate35 staging/var/lib/lf-migrate35/message.txt /var/lib/lf-migrate35/message.txt
cat > /etc/systemd/system/lf-migrate35.service <<'UNIT'
[Unit]
Description=LF migration lab 35
After=network.target

[Service]
Type=exec
User=lf-migrate35
Group=lf-migrate35
ExecStart=/usr/bin/python3 /opt/lf-migrate35/app.py
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true

[Install]
WantedBy=multi-user.target
UNIT
systemctl daemon-reload
systemctl enable --now lf-migrate35.service
sleep .4
curl -fsS http://127.0.0.1:8085/ > after.txt
cmp after.txt staging/var/lib/lf-migrate35/message.txt
cmp /opt/lf-migrate35/app.py staging/opt/lf-migrate35/app.py
test "$(stat -c %U /var/lib/lf-migrate35/message.txt)" = lf-migrate35
test "$(id -u lf-migrate35)" != 1000
id lf-migrate35
stat -c '%U:%G:%a' /var/lib/lf-migrate35/message.txt
systemctl show lf-migrate35.service -p User -p Group -p NoNewPrivileges -p ProtectSystem -p MainPID
systemctl restart lf-migrate35.service
sleep .3
curl -fsS http://127.0.0.1:8085/ | cmp - after.txt
echo TARGET_RESTORED_BY_ACCOUNT_NAME_BYTES_AND_RESTART_PASSED
ROOT

O proprietário original dos dados da VM de verificação era UID 1000, e a conta dedicada de destino era UID e GID 988. As permissões dos dados foram definidas como lf-migrate35:lf-migrate35:640, e os bytes do código, respostas HTTP e respostas após a reinicialização do serviço eram os mesmos. NoNewPrivileges e a proteção do sistema somente leitura são limitações deste exemplo de acordo com as configurações do ambiente de execução systemd. Aplicar a mesma unidade diretamente a um serviço de escrita também pode bloquear a gravação necessária de dados, portanto, as permissões devem ser projetadas separadamente para cada caminho.

Em aplicações reais, versões em tempo de execução, módulos de extensão, clientes de banco de dados, variáveis de ambiente, certificados e caminhos de upload também são comparados. Não presuma que os formatos de arquivos e comportamentos são idênticos apenas porque a versão do SO é a mesma; execute as ferramentas de verificação e os pedidos de funcionalidades suportados pelo produto no destino.

Testar a transição, a reversão e uma nova transição

Atualmente, o serviço original está parado e o serviço alvo está respondendo. No computador de trabalho, use a variável para selecionar o destino da conexão para verificar a leitura. Isto é para selecionar o destino SSH e não é uma operação que altera DNS, balanceador de carga ou endereços web públicos.

active=new-server
ssh "$active" 'curl --noproxy "*" -fsS http://127.0.0.1:8085/'
  1. Execute sudo systemctl stop lf-migrate35.service no destino.
  2. Execute sudo systemctl start lf-migrate35.service no original.
  3. No computador de trabalho, realize a leitura no original como mostrado abaixo e verifique se a resposta é a mesma.
active=old-server
ssh "$active" 'curl --noproxy "*" -fsS http://127.0.0.1:8085/'

Para alternar para o alvo novamente, primeiro pare a origem, depois inicie o serviço do alvo e verifique com active=new-server. Comparamos todas as respostas de restauração/reinício do alvo em ambas as VMs, reversão da origem e troca para o alvo em relação ao arquivo de referência. Este pequeno serviço é somente leitura, portanto não reflete um cenário onde novos conflitos de escrita ocorram após a alternância.

Decisões adicionais a serem tomadas antes de uma alternância real em produção

Item Critérios de Julgamento
DNS e balanceador de carga Leve em consideração o cache atual, conexões existentes, verificações de integridade e atrasos de propagação. Reduzir apenas o tempo de vida (TTL, Time to Live) do DNS não redireciona imediatamente todas as solicitações.
Retomando gravações e reversão Antes da sincronização final, bloqueie gravações na origem e determine se os dados gerados no destino podem ser reaplicados na origem. Evite uma simples reversão se o esquema não for compatível com versões anteriores.
Tarefas agendadas, e-mail, fila Se ambos os servidores estiverem em execução simultaneamente, ative apenas um para tarefas que, de outra forma, seriam duplicadas. Verifique separadamente da mudança de destino das requisições web.
Julgamento de sucesso Compare o processo, a porta, a resposta, os dados, as funções principais e as taxas de erro individualmente. Ler com sucesso sozinho não conta como escrita normal.

Defina a janela de reversão e o período de retenção antes de remover a origem ou os backups. Veja o manual Debian GNU tar para comportamento de propriedade numérica e extração, e siga os procedimentos oficiais específicos do produto para migração de dados de bancos de dados ou de versão principal.

Limpar apenas os recursos do laboratório

Após a verificação, limpe apenas os recursos de laboratório que você criou em cada servidor. Pare e desative o serviço, exclua exatamente os três arquivos e remova apenas diretórios vazios. Mantenha os backups e preserve a conta lfstudent existente do servidor de origem.

sudo systemctl disable --now lf-migrate35.service
sudo rm -- /etc/systemd/system/lf-migrate35.service /opt/lf-migrate35/app.py /var/lib/lf-migrate35/message.txt
sudo rmdir /opt/lf-migrate35 /var/lib/lf-migrate35
sudo systemctl daemon-reload

No destino, remova a conta dedicada recém-criada com sudo userdel lf-migrate35 somente após seus processos terem terminado e seus dados de laboratório terem sido removidos. Aplique sua política de retenção aos dois arquivos de transferência exatos na origem e na estação de trabalho. Para uma migração de produção, mantenha o backup final verificado e os registros da transição até que a janela de recuperação termine.