blog
Servidores

CentOS 8 para AlmaLinux 8 no cPanel sem reinstalar

Como os dois são o mesmo RHEL 8, a conversão troca repositórios, chaves e pacotes de release, não a versão do sistema. Veja o procedimento documentado pelo cPanel e um roteiro de validação para fechar a janela com segurança.

JR · · 8 min de leitura · 2 tabelas · 11 blocos de código

Resposta curta: a conversão é feita no lugar, sem reinstalar: com o cPanel na versão mínima exigida pela documentação, você roda o almalinux-deploy.sh, reinicia e valida release, repositórios, pacotes e serviços. CentOS 8 e AlmaLinux 8 são o mesmo RHEL 8.

Neste artigo
  1. Por que CentOS 8 para AlmaLinux 8 não é uma migração de versão
  2. O que a troca de base de pacotes muda de fato
  3. Qual versão do cPanel exigir e o que checar antes da janela
  4. Como executar a conversão, passo a passo
  5. Validação item a item antes de encerrar a janela
  6. Como voltar atrás se a conversão falhar

Por que CentOS 8 para AlmaLinux 8 não é uma migração de versão

CentOS 8 e AlmaLinux 8 são reconstruções do mesmo código-fonte do RHEL 8. Mesma ABI, mesmo glibc de base, mesmo layout de sistema de arquivos, mesmo dnf, mesmos módulos AppStream. A conversão não sobe de major. Ela troca quem assina e distribui os pacotes.

Isso muda o tipo de risco. Na passagem de CentOS 7 para AlmaLinux 8 você enfrenta troca de Python 2 para Python 3, de OpenSSL 1.0 para 1.1, de yum para dnf e de toolchain, e o cPanel precisa do processo próprio dele para atravessar isso. Aqui não há nada disso. O que pode dar errado está concentrado em três pontos: repositórios, chaves GPG e pacotes que o script de conversão não reconhece.

Por isso a documentação do cPanel trata o caso como conversão no lugar, sem reinstalar o servidor e sem mover contas. O procedimento oficial está em How to Convert from CentOS 8 to AlmaLinux OS, e se apoia no script almalinux-deploy.sh mantido pelo projeto AlmaLinux.

O que a troca de base de pacotes muda de fato

O script substitui os pacotes de identidade da distribuição e reaponta o dnf para os espelhos AlmaLinux. Depois disso, o dnf distro-sync reinstala os pacotes do sistema com a versão assinada pela AlmaLinux. Os binários do cPanel e do EasyApache 4 vêm de repositórios do cPanel. MySQL e MariaDB vêm dos repositórios oficiais de cada fornecedor, gerenciados pelo cPanel. Todos ficam fora do distro-sync de base e não são trocados pela conversão.

Componente Antes Depois Impacto para o cPanel
Pacote de release centos-release / centos-linux-release almalinux-release /etc/redhat-release e /etc/os-release passam a identificar AlmaLinux
Repositórios base arquivos CentOS-*.repo em /etc/yum.repos.d arquivos almalinux*.repo dnf passa a buscar nos espelhos AlmaLinux
Chave GPG chave CentOS chave AlmaLinux importada pacotes base passam a ser verificados pela nova chave
Kernel build CentOS build AlmaLinux exige reboot para entrar em uso
Pacotes de branding logos e notas CentOS equivalentes AlmaLinux sem efeito operacional
Repositórios do cPanel (EA4, cPanel RPMs) inalterados inalterados contas, PHP e Apache seguem como estavam
Repositórios de terceiros (EPEL, Imunify e similares) inalterados inalterados precisam ser compatíveis com EL8 genérico, o que normalmente já são

CloudLinux não entra nesta tabela nem neste procedimento: ele tem caminho de conversão próprio, mantido pela CloudLinux, e o almalinux-deploy.sh não é a ferramenta para esse caso.

O ponto do kernel merece atenção em quem usa Secure Boot. O shim e o kernel passam a ser assinados pela AlmaLinux, e a nova assinatura precisa ser aceita pelo firmware. Em VPS e na maioria das dedicadas com boot legado isso é irrelevante. Em hardware com Secure Boot ativo, confirme antes da janela.

Qual versão do cPanel exigir e o que checar antes da janela

A conversão só é suportada em versões do cPanel & WHM que já reconhecem AlmaLinux como sistema operacional. A versão mínima está declarada na página oficial do cPanel. Confira lá no dia da janela, em vez de confiar em número decorado, e compare com o que está instalado:

/usr/local/cpanel/cpanel -V
cat /etc/redhat-release
uname -r

Se a versão estiver abaixo da exigida, atualize primeiro e só então converta. Não faça as duas coisas na mesma janela: se algo quebrar, você não saberá qual das duas mudanças causou.

/scripts/upcp

Checklist antes de começar:

dnf repolist all
rpm -qa --qf '%{NAME} %{VENDOR}\n' | sort > /root/pacotes-antes.txt

O segundo comando grava cada pacote com o fornecedor. Ele vira a referência para a validação no fim.

Como executar a conversão, passo a passo

Os passos abaixo seguem a documentação do cPanel. Rode como root, de preferência dentro de screen ou tmux: se a sessão SSH cair durante o distro-sync, o processo continua.

Baixar o script do projeto AlmaLinux

curl -O https://raw.githubusercontent.com/AlmaLinux/almalinux-deploy/master/almalinux-deploy.sh

Leia o script antes de executar. Ele é curto o bastante para isso, e é a forma de saber exatamente o que vai mexer no seu /etc/yum.repos.d.

Executar o almalinux-deploy.sh e o que fazer se abortar

bash almalinux-deploy.sh

O script verifica se o sistema é um EL8 suportado, detecta o painel de controle, troca os pacotes de release, importa a chave GPG e sincroniza os pacotes. Se ele abortar logo no início, a causa costuma ser repositório inacessível ou pacote de release inesperado. A mensagem de erro indica qual. Corrija e rode de novo. Que as verificações iniciais não alteram o sistema é leitura nossa do script, não algo que a página do cPanel documenta: confirme no código da versão que você baixou.

Se ele abortar no meio do distro-sync, não reinicie o servidor. Leia o log, resolva o conflito de pacote (normalmente um pacote de terceiro que depende de versão exata de uma biblioteca) e repita a sincronização. Esse caminho de recuperação é orientação nossa, não consta da documentação do cPanel. Reiniciar com o sistema meio convertido é o cenário em que o snapshot passa a ser necessário.

Reiniciar com o kernel AlmaLinux como padrão no GRUB

Antes do reboot, registre quais kernels ficaram instalados e qual é o padrão. Se o kernel CentOS antigo ainda aparecer, ele é uma rota de fuga pelo GRUB. Se não aparecer, a única volta é o snapshot.

rpm -q kernel
grubby --default-kernel
grubby --info=ALL
reboot

Acompanhe pelo console fora de banda. O GRUB deve listar o kernel AlmaLinux como padrão.

Ordem da conversão no servidorBackup e snapshotRestauração testada antes da janelaVerificar versão do cPanelRodar upcp antes, se estiver abaixoExecutar almalinux-deploy.shComo root, dentro de screenConferir GRUB e reiniciarKernel AlmaLinux como padrãoValidar em camadasSistema, cPanel, serviços, cliente
Ordem da conversão no servidor, do backup à validação. Nenhuma etapa depende de número medido.

Validação item a item antes de encerrar a janela

Não encerre a janela porque o servidor voltou a responder ping. Valide em camadas, do sistema operacional até o serviço que o cliente enxerga.

Como confirmar que o sistema passou a ser AlmaLinux

cat /etc/redhat-release
uname -r
rpm -qa --qf '%{NAME} %{VENDOR}\n' | grep -i centos
dnf repolist

Esperado: release AlmaLinux, kernel com sufixo el8 em execução a partir do pacote AlmaLinux, e dnf repolist sem repositório CentOS ativo. O grep por CentOS no fornecedor deve voltar vazio ou só com pacotes que você consegue explicar. Compare com o inventário salvo:

rpm -qa --qf '%{NAME} %{VENDOR}\n' | sort > /root/pacotes-depois.txt
diff /root/pacotes-antes.txt /root/pacotes-depois.txt

O diff vai mostrar a troca de fornecedor nos pacotes base e algumas saídas e entradas esperadas: centos-release (ou centos-linux-release) e os pacotes de logos CentOS saem, pacotes almalinux-* entram, e kernels novos aparecem. Só o desaparecimento de um pacote fora dessa lista exige investigação.

Como confirmar que o cPanel reconhece o novo sistema

/usr/local/cpanel/cpanel -V
/scripts/upcp

Rodar o upcp depois da conversão é uma recomendação nossa, não um passo obrigatório da página oficial. Ele força o cPanel a reavaliar o sistema operacional e reinstalar o que estiver faltando. Se ele terminar sem erro, a instalação está coerente com o novo SO.

Quais serviços checar depois do reboot

/scripts/restartsrv_httpd --status
/scripts/restartsrv_mysql --status
/scripts/restartsrv_exim --status
/scripts/restartsrv_dovecot --status
/scripts/restartsrv_named --status
systemctl --failed

systemctl --failed precisa voltar vazio. Qualquer unidade falhando depois do reboot e que não falhava antes é consequência da conversão até prova em contrário.

O que testar como cliente antes de encerrar a janela

Camada Comando ou teste Critério para encerrar
Release cat /etc/redhat-release AlmaLinux 8.x
Kernel uname -r kernel AlmaLinux em execução
Repositórios dnf repolist nenhum repositório CentOS ativo
Pacotes diff antes/depois troca de fornecedor, mais release, logos e kernel esperados
cPanel /scripts/upcp termina sem erro
Serviços systemctl --failed vazio
Web e PHP site por versão de PHP HTTP 200 e conteúdo correto
E-mail envio e leitura reais entrega nos dois sentidos

Como voltar atrás se a conversão falhar

Não há comando de volta para CentOS 8, e voltar também não faria sentido: o CentOS 8 não recebe atualização desde o fim de 2021. A reversão real é restaurar o snapshot ou a imagem feita antes da janela. Por isso o backup é pré-requisito e não recomendação.

Os problemas mais prováveis, em ordem de frequência esperada pelo desenho do processo:

Se o objetivo final é chegar a uma base com suporte longo, lembre que o AlmaLinux 8 encerrou o suporte ativo em maio de 2024 e recebe só correções de segurança até março de 2029. A conversão resolve o CentOS 8 sem reinstalar, mas o planejamento da próxima troca de major começa no mesmo dia.

Decidir entre correção e snapshotScript abortou no inícioCorrigir a causa e rodar de novoAbortou no distro-syncResolver conflito, repetir sem rebootNão sobe após o rebootKernel CentOS antigo aparece no GRUB?Sim: escolher no GRUBSubir pelo console e investigarNão: restaurar snapshotÚnica volta quando não há kernel antigo
Decisão em caso de falha. A escolha entre GRUB e snapshot depende do que rpm e grubby mostraram antes do reboot.

Referências

  1. Documentação oficial (cpanel) — How to Convert from CentOS 8 to AlmaLinux OS. Consultado em 2026-11-13.
Leia também