Upgrading to Drupal 10

This guide will reference the DM teams standard local Drupal setup that uses Lando, Drush and Composer.

Quick Links

https://www.drupal.org/docs/upgrading-drupal/upgrading-from-drupal-8-or-later/how-to-upgrade-from-drupal-9-to-drupal-10

Preparation

Before we upgrade our Drupal 9 website we do the following step:

1. Create a copy of the site locally as a backup

   cd workspace/
   cp -r gamework gamework-backup

2. Create a backup of the database

   cd workspace/gamework
   lando start
   lando db-export

3. Check Drupal 10 compatibility using the upgrade_status module

   composer require 'drupal/upgrade_status:^4.3'
   lando drush en upgrade_status
   lando drush cr

4. Uninstall old/unsupported modules

   lando drush pmu multiple_sitemap 
   lando drush pmu quickedit
   lando drush pmu rdf
   composer remove drupal/multiple_sitemap --no-update
   composer remove drupal/quickedit --no-update
   composer remove drupal/rdf --no-update

5. Update modules to the latest / supporting Drupal 10

   During this step you may run into loops where a module requires another modules version. If using -W doesn't work you can set the version manually in composer.json

6. Set the file permissions

   chmod 777 gamework/web/sites/default
   chmod 666 gamework/web/sites/default/*settings.php
   chmod 666 gamework/web/sites/default/*services.yml

7. Install Drupal core

   composer require 'drupal/core-recommended:^10' 'drupal/core-composer-scaffold:^10' 'drupal/core-project-message:^10' --no-update

8. Remove files and folders

   rm composer.lock
   rm -rf vendor
   rm -rf web/core
   rm -rf web/modules/contrib

9. Run composer install

   export COMPOSER_PROCESS_TIMEOUT=1200
   export COMPOSER_DISCARD_CHANGES=true
   composer install --no-interaction

10. Update the DB

    lando rush updb --yes

11. Clear Cache

    lando drush cr

12. Set Permissions

    chmod 755 gamework/web/sites/default
    chmod 644 gamework/web/sites/default/*settings.php
    chmod 644 gamework/web/sites/default/*services.yml