Tutorial do Rocky Linux 10 / Migrar do Rocky Linux 9 para o 10: novo servidor, dados e rollback
Ao migrar do Rocky Linux 9 para o 10, você se prepara instalando um novo servidor Rocky Linux 10 e migrando as configurações e dados necessários. O projeto Rocky Linux não oferece suporte oficial para atualizações in-place (no mesmo sistema instalado) entre diferentes versões principais. Validando o novo ambiente enquanto mantém o servidor existente, é mais fácil identificar problemas antes da troca e definir condições de reversão.
Distinguir atualizações menores de uma migração do Rocky 9 para 10
Atualizar para a versão menor mais recente dentro da 9.x e mudar a versão principal de 9 para 10 são tarefas diferentes. O documento oficial de migração de versão do Rocky Linux orienta através de um fluxo de instalação limpa, preparando as contas necessárias, repositórios, pacotes e restaurando backups. Simplesmente alterar os números nos endereços dos repositórios ou usar dnf --releasever=10 não é considerado um método de migração oficial padrão.
O objetivo de preparar um novo servidor não é replicar o sistema existente como um todo. Trata-se de adaptar os dados e configurações exigidos pelo serviço sobre as configurações padrão e políticas de segurança do novo sistema operacional. Simplesmente mover o kernel, bibliotecas e RPMs do servidor antigo para o novo servidor pode levar a dependências incompatíveis e escopo de suporte inadequado.
| Destino da Migração | Tarefas no Novo Servidor | Critérios de Verificação |
|---|---|---|
| Contas de Usuário e de Serviço | Crie as contas necessárias e defina os correspondentes UID e GID. | As contas pretendidas devem ser capazes de ler e escrever os dados migrados. |
| Pacotes e Ambiente de Execução | Instale as versões necessárias do repositório Rocky 10. | Programas e módulos de extensão devem funcionar no novo ambiente de execução. |
| Configuração | Reaplique as alterações necessárias com base nos novos arquivos padrão. | Verificações de configuração e inicialização de serviços devem ser bem-sucedidas. |
| Arquivos e dados do banco de dados | Restaure backups consistentes em um caminho separado. | Verifique conteúdo, permissões e funções de negócios juntos. |
| Destinos de acesso e tarefas agendadas | Determine a ordem de conversão e os métodos para evitar execução duplicada. | As solicitações do usuário devem ir para o servidor pretendido, e as tarefas devem ser processadas apenas uma vez. |
Se um único dispositivo precisar ser reinstalado, você não pode manter o servidor existente ao mesmo tempo, portanto é mais importante ter backups externos que tenham passado por testes de restauração e meios de retorno antes da reinstalação. Se possível, pratique primeiro em uma nova VM ou em um servidor separado, e determine o tempo de inatividade e os critérios de falha para a conversão real.
Garanta a lista de configuração necessária do servidor existente
No servidor existente Rocky 9, primeiro investigue o status da instalação e as dependências de serviço. A seguir, um exemplo de criação de um novo diretório de investigação a partir do shell do administrador. Listas de contas e configuração de rede podem conter informações operacionais, portanto, o acesso deve ser restrito e não copiado diretamente para logs ou publicações públicas.
sudo -i
set -euo pipefail
umask 077
test ! -e /root/migration-inventory
mkdir /root/migration-inventory
cd /root/migration-inventory
cat /etc/rocky-release > release.txt
getent passwd > users.txt
getent group > groups.txt
rpm -qa --qf '%{NAME}-%{VERSION}-%{RELEASE}.%{ARCH}\n' | sort > packages.txt
dnf repolist --enabled > repositories.txt
dnf module list --enabled > modules.txt
systemctl list-unit-files --state=enabled > enabled-units.txt
ss -lntup > listening-ports.txt
ip -br address > addresses.txt
ip route > routes.txt
exit
Esta lista não é um script de instalação a ser executado no novo servidor como está. Ela serve como referência para selecionar os itens necessários para o serviço e verificar os nomes, a disponibilidade de suporte e pacotes alternativos no Rocky 10. Para serviços no Rocky 9 usando fluxos de módulos, é particularmente necessário investigar a versão em execução e não assumir que a escolha possa ser transferida diretamente para o comando de módulo no Rocky 10.
Para serviços web e de banco de dados, além dos caminhos de dados, verifique contas de banco de dados e métodos de despejo, arquivos enviados, APIs externas, correio, armazenamento, certificados, tarefas agendadas e tarefas de backup. Executar as mesmas tarefas agendadas simultaneamente nos servidores novo e existente pode resultar em envio duplicado de e-mails ou processamento de dados. Senhas operacionais e chaves secretas devem ser entregues por meio de procedimentos protegidos separados e não devem ser copiadas desnecessariamente para arquivos para comparação de configuração.
Preparação do novo servidor e escopo de prática
Instale o Rocky Linux 10 no novo servidor, execute atualizações, configure as contas de gerenciamento, verifique o acesso SSH e primeiro verifique as configurações básicas do firewall e SELinux. Se for um ambiente x86-64, também verifique os requisitos de CPU para o Rocky 10. Não presuma que os requisitos da nova versão são atendidos apenas porque o servidor existente está executando o Rocky 9.
Ao transferir um programa real, em vez de copiar o ambiente virtual Python ou o diretório de módulos de extensão compilados sem alterações, você o recria no novo servidor usando o runtime e as dependências suportadas lá. Para formatos de arquivos de banco de dados e compatibilidade de plugins, siga os procedimentos de migração para cada versão do produto. Não misture configurações padrão e arquivos do sistema sobrescrevendo totalmente /etc, /usr e /var no novo servidor.
O laboratório de origem moveu um pequeno serviço somente leitura do espaço de usuário do contêiner Rocky 9.8 para Python em uma VM Rocky 10.2 . O Python de origem era 3.9.25 e o Python de destino era 3.12.15. Ambos os ambientes compartilhavam o kernel do host Rocky 10, então o teste não migrou o kernel Rocky 9, processo de inicialização ou systemd. Um arquivo de endereço local simulou a mudança e a reversão sem alterar um banco de dados de produção ou o DNS público.
Execute o exercício como usuário regular lfstudent e requer Podman, Python, tar e curl. Na VM do exercício, a conta lfstudent tem UID e GID 1000. Construa uma imagem separada a partir da imagem oficial docker.io/library/rockylinux descrita no guia Rocky Linux Podman . Serviços de produção reais devem gerenciar ciclos de vida de contêineres e efeitos do logout separadamente; aqui, o exercício é realizado dentro da mesma sessão de login do início ao fim.
Preparando o Espaço do Usuário no Rocky 9
Execute os comandos no shell de uma VM de prática dedicada do Rocky 10 como usuário regular, não no servidor existente. Use um novo caminho e um nome de imagem local separado. Se você tiver materiais de prática existentes, pare e verifique primeiro o estado salvo.
set -euo pipefail
umask 077
test ! -e "$HOME/lf-course31"
mkdir -m 700 "$HOME/lf-course31"
cd "$HOME/lf-course31"
if podman image exists localhost/lf-course31-source9-updated:20261112; then
printf 'The local lab image tag already exists. Stop and inspect it.\n' >&2
exit 1
else
image_status=$?
test "$image_status" -eq 1
fi
podman pull docker.io/library/rockylinux:9
base=$(podman image inspect docker.io/library/rockylinux:9 \
--format '{{index .RepoDigests 0}}')
printf '%s\n' "$base" > base.ref
printf 'FROM %s\nRUN dnf -y upgrade && dnf -y install python3 tar && dnf clean all\n' \
"$base" > Containerfile
podman build --tag localhost/lf-course31-source9-updated:20261112 \
--file Containerfile .
podman run --rm localhost/lf-course31-source9-updated:20261112 \
/bin/bash -lc 'cat /etc/rocky-release; python3 --version; uname -r'
Não assuma a versão real apenas olhando a tag. A imagem baseada em :9 recebida na prática estava rotulada como 9.3, e após uma atualização completa da série 9 dentro da imagem de origem, o laboratório confirmou 9.8 e Python 3.9.25. Essa atualização foi feita apenas dentro da imagem isolada. Registre o digest da imagem base em base.ref, observando que a mesma tag pode, posteriormente, referir-se a uma imagem diferente.
Dentro de um contêiner, uname -r mostra o kernel do host Rocky 10. Confirme a versão do espaço do usuário do sistema operacional usando /etc/rocky-release ou /etc/os-release, e distinga-a da versão do kernel. Preparar a imagem ou o primeiro mapeamento do usuário pode levar tempo, portanto, não crie contêineres com o mesmo nome repetidamente. Se houver interrupção, primeiro verifique o estado real usando podman ps -a e podman inspect.
Criando um serviço original somente leitura e backup de migração
O exemplo completo a seguir usa um arquivo de configuração JSON e um arquivo de dados JSON contendo dois itens. /health representa o ambiente de execução, e /items retorna os dados a serem transferidos. Funções de escrita como POST não são fornecidas, e o diretório original também está conectado como somente leitura. Em um serviço de escrita real, esta parte deve ser alterada para o modo de manutenção e um procedimento final de backup consistente.
SOURCE_LISTENERS=$(ss -H -lnt 'sport = :18031')
TARGET_LISTENERS=$(ss -H -lnt 'sport = :18032')
test -z "$SOURCE_LISTENERS"
test -z "$TARGET_LISTENERS"
mkdir -m 700 source target
mkdir -m 700 source/data
printf '{"site":"LF31 migration lab"}\n' > source/config.json
printf '[{"id":1,"name":"alpha"},{"id":2,"name":"beta"}]\n' > source/data/items.json
cat > source/app.py <<'PY'
import json, platform, sys
from pathlib import Path
from http.server import BaseHTTPRequestHandler, HTTPServer
root = Path(sys.argv[1])
class Handler(BaseHTTPRequestHandler):
def do_GET(self):
try:
if self.path == '/health':
release = dict(line.split('=', 1) for line in
Path('/etc/os-release').read_text().splitlines() if '=' in line)
data = {'os': release['VERSION_ID'].strip('"'),
'python': platform.python_version()}
elif self.path == '/items':
config = json.loads((root/'config.json').read_text())
data = {'site': config['site'],
'items': json.loads((root/'data/items.json').read_text())}
else:
self.send_error(404)
return
body = (json.dumps(data, sort_keys=True) + '\n').encode()
self.send_response(200)
content_type = 'application/json'
except (OSError, ValueError, KeyError):
body = b'Cannot read migration data\n'
self.send_response(500)
content_type = 'text/plain; charset=utf-8'
self.send_header('Content-Type', content_type)
self.end_headers()
self.wfile.write(body)
HTTPServer((sys.argv[2], int(sys.argv[3])), Handler).serve_forever()
PY
chmod 640 source/app.py source/config.json source/data/items.json
uid=$(id -u)
gid=$(id -g)
source_id=$(podman run -d --init --name lf-course31-source --label lf.course=31 \
--userns=keep-id --user "$uid:$gid" \
-p 127.0.0.1:18031:8080 -v "$PWD/source:/work:ro,Z" \
localhost/lf-course31-source9-updated:20261112 \
python3 /work/app.py /work 0.0.0.0 8080)
printf '%s\n' "$source_id" > source-container.id
sleep 2
podman exec "$source_id" id
curl --fail --silent --max-time 10 http://127.0.0.1:18031/health
curl --fail --silent --max-time 10 http://127.0.0.1:18031/items > source-response.json
--userns=keep-id permite que o ID numérico de um usuário comum seja mantido mesmo dentro do contêiner. :ro,Z conecta o original em modo somente leitura e aplica um rótulo SELinux dedicado. Essa alteração de rótulo não é aplicada amplamente aos diretórios de dados públicos. Se a resposta inicial falhar, podman inspect "$source_id" e podman logs "$source_id" são verificados, e o ID do contêiner registrado é conferido antes de retomar. O processo não avança para a próxima etapa sem verificar o original em execução.
Se a resposta e o original forem confirmados como normais, um backup de caminho relativo é criado dentro do contêiner e copiado para o host. O backup inclui apenas este pequeno programa, configurações e dados.
podman exec "$source_id" tar --numeric-owner -cpf /tmp/lf31-migration.tar -C /work .
podman cp "$source_id":/tmp/lf31-migration.tar backup.tar
sha256sum backup.tar > backup.tar.sha256
sha256sum -c backup.tar.sha256
tar --numeric-owner -tvf backup.tar
O checksum deve ser OK, e a lista de arquivos deve mostrar app.py, config.json e data/items.json. O backup tar padrão neste exemplo tem como alvo o conteúdo dos arquivos e permissões básicas. Se você quiser preservar ACLs e atributos estendidos, você deve adicionar verificações para essas opções e atributos como o tutorial sobre backup e verificação de restauração real para configurações e dados do usuário . Em particular, rótulos SELinux dedicados a contêineres não devem ser usados como estão para a política de implantação de um novo servidor.
Restaurando no Rocky 10 e comparando os resultados da execução
Após verificar novamente que o target preparado está vazio, restaure apenas o backup que você mesmo criou. Como a restauração é feita com a mesma conta geral no mesmo host, o mapeamento de propriedade numérica neste exemplo é o mesmo. Se for um servidor real diferente, você precisará primeiro alinhar o UID e o GID da nova conta ou planejar as conversões de propriedade necessárias.
TARGET_ENTRIES=$(find target -mindepth 1 -print -quit)
test -z "$TARGET_ENTRIES"
sha256sum -c backup.tar.sha256
tar -xpf backup.tar -C target
python3 - <<'PY'
from pathlib import Path
import hashlib, stat
source, target = Path('source'), Path('target')
for p in sorted(source.rglob('*')):
if not p.is_file():
continue
q = target/p.relative_to(source)
if p.read_bytes() != q.read_bytes():
raise SystemExit('FAIL: content differs')
if (p.stat().st_uid != q.stat().st_uid or
p.stat().st_gid != q.stat().st_gid or
stat.S_IMODE(p.stat().st_mode) != stat.S_IMODE(q.stat().st_mode)):
raise SystemExit('FAIL: owner or mode differs')
print(p.relative_to(source), hashlib.sha256(q.read_bytes()).hexdigest())
print('PASS: file content, numeric ownership and modes match')
PY
python3 target/app.py "$PWD/target" 127.0.0.1 18032 > target-service.log 2>&1 &
target_pid=$!
sleep 1
curl --fail --silent --max-time 10 http://127.0.0.1:18032/health
curl --fail --silent --max-time 10 http://127.0.0.1:18032/items > target-response.json
cmp source-response.json target-response.json
Se o conteúdo e as permissões dos três arquivos forem os mesmos e o cmp sair com status 0 sem saída, as respostas de dados neste exemplo coincidem. No destino /health, o novo espaço de usuário e a versão de runtime apareceram da seguinte forma.
{"os": "10.2", "python": "3.12.15"}
A resposta de /items deve incluir tanto alpha quanto beta e ter o mesmo valor de site. Se a resposta for 500, verifique target-service.log, o caminho do arquivo, a sintaxe JSON e as permissões da conta de execução. Este pequeno servidor é para prática para verificar a funcionalidade no loopback e não é usado como um servidor web de produção externo.
Sucesso em um exemplo pequeno não significa que todas as dependências do serviço real são compatíveis. Em um ambiente de produção, login, operações de visualização/escrita, uploads de arquivos, conjuntos de caracteres do banco de dados e fusos horários, tarefas agendadas, integrações externas, certificados e operações de backup devem ser verificados para cada serviço. Se possível, verifique se os mesmos resultados ocorrem mesmo após reiniciar o novo servidor e verifique nos endereços e caminhos onde os usuários normalmente se conectam.
Teste a troca do destino da conexão e o rollback com os mesmos dados
Neste exercício, client.url é um arquivo padrão que armazena o endereço para enviar solicitações. Sem alterar o DNS público ou o tráfego real do usuário, você pode observar a sequência do ambiente existente → novo ambiente → ambiente existente → novo ambiente.
printf 'http://127.0.0.1:18031\n' > client.url
curl --fail --silent --max-time 10 "$(cat client.url)/health"
printf 'http://127.0.0.1:18032\n' > client.url
curl --fail --silent --max-time 10 "$(cat client.url)/health"
curl --fail --silent --max-time 10 "$(cat client.url)/items" | cmp - source-response.json
printf 'http://127.0.0.1:18031\n' > client.url
curl --fail --silent --max-time 10 "$(cat client.url)/health"
curl --fail --silent --max-time 10 "$(cat client.url)/items" | cmp - source-response.json
printf 'http://127.0.0.1:18032\n' > client.url
curl --fail --silent --max-time 10 "$(cat client.url)/items" | cmp - source-response.json
O laboratório de origem verificou a origem 9.8/3.9.25, destino 10.2/3.12.15, e então a origem 9.8/3.9.25 novamente, e a resposta para cada dado foi a mesma. Como o original estava fixo como somente leitura e o novo ambiente não tinha funcionalidade de escrita, neste exemplo, a comparação poderia reverter apenas o alvo da conexão sem precisar mesclar os dados novamente.
Em um serviço real que aceita gravações, os dados recebidos pelo novo servidor após a transição são cruciais. Se você apenas reverter o endereço sem refletir isso no servidor existente, poderá perder novos pedidos, uploads, alterações de conta, etc. Antes da migração, defina o tempo de suspensão da gravação, o ponto final de sincronização, as condições sob as quais a gravação é permitida no novo servidor e o método para recuperar dados em caso de reversão. Além disso, verifique se a restauração reversa é possível entre diferentes versões do banco de dados.
As alterações na transição operacional modificam o DNS, proxy/balanceador de carga ou configurações de conexão de acordo com o método escolhido. Devido ao cache de DNS e conexões existentes, nem todos os usuários migram para o novo servidor simultaneamente. Após a transição, observe as taxas de erro, logs e verificações essenciais de negócios, e não retome gravações ou tarefas agendadas de forma redundante no servidor existente.
Limpe o laboratório e decida quando desativar o servidor antigo.
Apenas finalize os dois processos iniciados na prática. target_pid e source_id abaixo são alvos iniciados diretamente na sessão atual. Se a sessão foi desconectada, verifique o ID do contêiner salvo e o processo/porta real para confirmar se é o mesmo alvo antes da limpeza, e não finalize nenhum outro processo Python arbitrário.
kill "$target_pid"
wait "$target_pid" || test "$?" = 143
podman stop "$source_id"
podman inspect "$source_id" --format '{{.State.Status}} {{.State.ExitCode}}'
podman rm "$source_id"
ss -lnt 'sport = :18031'
ss -lnt 'sport = :18032'
sudo restorecon -RF "$HOME/lf-course31/source"
sha256sum -c backup.tar.sha256
--init coloca um pequeno processo inicial no contêiner que é responsável pela transmissão de sinais, entre outras coisas. Em uma verificação de terminação separada aplicada a isso, exited 143 apareceu sem um aviso de terminação forçada e, neste exercício, estava em um estado de terminação de acordo com o SIGTERM. Ele também verifica se ambas as portas estão fechadas e se a soma de verificação de backup é OK. A restauração do contexto SELinux aplica-se apenas ao caminho original deste exercício que o contêiner terminou de usar, enquanto mantém o conteúdo e as permissões padrão.
O servidor existente é desligado após o novo servidor concluir a verificação das funções de negócios, acesso operacional, backup e restauração, e tarefas agendadas, e após cumprir o período de observação estabelecido e as condições de reversão. Antes do desligamento, são repassados o local e o método de restauração do último backup, as diferenças na configuração do novo servidor e itens que ainda não foram verificados. A conclusão da migração deve ser julgada pelo comportamento verificado do serviço e pela integridade dos dados, e não pela data de instalação do novo servidor.




