Upgrade from Drupal 9 to Drupal 10

This page describes how to upgrade your portal from Drupal 9 to Drupal 10.

Prerequisites

Before updating to Drupal 10, update to the latest version of the composer (apigee/devportal-kickstart-project-composer) file. See Updating the composer file to the latest version.

Upgrade steps

After you've completed the composer update, follow these steps:

1. Upgrade the ckeditor following the instructions in Upgrade the CKEditor from CKEditor 4 to CKEditor 5.
2. Upgrade the composer file to latest Drupal 10, following the steps in How to upgrade.

• Note: When upgrading to Drupal 10, themes seven and bartik should not be enabled.

Updating the composer file to the latest version:

Follow these steps to update your composer file to the latest version.

1. Backup your original composer.json file.
2. Copy over the latest composer.json file from apigee/devportal-kickstart-project-composer.
3. Re-add any Drupal modules to the new composer.json file or changes you made from the backup composer.json file. 
4. Run composer update --with-dependencies.
5. Run pending database updates.

Upgrade the CKEditor from CKEditor 4 to CKEditor 5:

Follow these steps to upgrade the CKEditor.

1. Enable the CKEditor 5 module(if already not enabled) (leave "CKEditor" module enabled).

2. To converting text formats to use CKEditor 5:

   1. Go to Text Formats ⮕ Editors in the Drupal Configuration user interface and click "Configure" for each text format where ‘Text Editor’ is ‘ckeditor’ .

      Note: If the Text Editor is already "CKEditor 5", you can ignore the remaining steps in this section for that entry.

   2. Under Text Editor, change the selection to "CKEditor 5" and click "Save configuration".

   3. Text formats must be updated one at a time. This will automatically migrate your text format configuration to CKEditor 5.

   4. Disable the (old) "CKEditor" module.

      Note: This will change your configuration.