Como atualizar o Drupal 9 para o Drupal 10

Este tutorial é indicado se você estiver usando drupal/core-recommended como dependência no composer do seu projeto Drupal 9.

Antes de continuar neste tutorial, recomendo fortemente que você leia a seção "Important Update Information" disponível na página de lançamento do Drupal 10.0.0, aqui.

Atualizar o Drupal 9 para o Drupal 10, felizmente é muito mais fácil do que atualizar do Drupal 7 para o Drupal 8 ou 9, porém ainda precisa de um alto conhecimento de Drupal do desenvolvedor que o fará. É necessário verificar os requisitos do Drupal 10, algumas etapas de atualização (pré e pós) para garantir que tudo foi atualizado com sucesso. Veja abaixo os tópicos que acredito serem cruciais para qualquer desenvolvedor atualizar seu projeto Drupal 9 atual para a última versão do Drupal 10.

Requisitos

Primeiro de tudo, por favor, cheque com o serviço de hospedagem do seu site, se ele tem todos os requisitos necessários para o Drupal 10, aqui.

Passo 1 - Pre Upgrade

Para atualizar do Drupal 9 para a versão mais recente do Drupal 10, você precisará executar algumas etapas antes, que são:

• Atualize seu site Drupal 9 pelo menos para a versão 9.4.4, conforme mencionado aqui.
• Se o seu site atual usa o módulo do CKEditor 4, atualize ele para usar o módulo do CKEditor 5 (seu site deve estar usando o Drupal 9.4.4 como mencionado acima, ou aqui).
• Verifique se sua instalação atual do Drupal 9 está pronta para o Drupal 10. Para isso, você pode usar o módulo Upgrade Status, o que é muito bom. Para instalar, através do composer, você pode rodar:

composer require drupal/upgrade_status

• Verifique também se você está usando algum outro pacote que tenha dependência do Drupal 9 e remova-o ou atualize-o. Para verificar as dependências do pacote para Drupal 9, você pode executar o comando abaixo:

composer why drupal/core

• Quando sua instalação do Drupal 9 estiver 100% pronta para o Drupal 10, você estará pronto para prosseguir com a atualização do Drupal 10. Mas primeiro, provavelmente seria uma boa ideia executar mais alguns passos, a seguir:

Remova o módulo Upgrade Status, se você instalou no passo anterior, pois a versão (8.x-3.18), que estou escrevendo hoje não é compatível com Drupal 10:

composer remove drupal/upgrade_status

Remova a dependência drush se você a tiver em seu composer.json, pois normalmente ela causa alguns conflitos ao fazer upgrade entre versões Drupal. Faça isso, executando o comando abaixo:

composer remove drush/drush

Passo 2 - Upgrade

Então, finalmente, você pode executar o comando para atualizar para a versão mais recente do Drupal 10 usando o drupal/core-recommended:

composer require drupal/core-recommended drupal/core-composer-scaffold drupal/core-project-message --update-with-all-dependencies

Passo 3 - Pós Upgrade

Agora você pode reinstalar o drush novamente em seu projeto, executando o comando:

composer require drush/drush

Execute o comando de atualização do banco de dados usando drush conforme abaixo:

drush updb -y

Exporte as novas alterações de configuração:

drush cex

Limpe o cache

drush cr

Validate se está tudo certo.