Mettre à niveau Drupal

Edge pour Private Cloud v4.18.05

Dans une installation Edge for Private Cloud du portail Apigee Developer Services (ou simplement, le portail), vous pouvez recevoir une notification indiquant qu'une nouvelle version de Drupal est disponible. Une nouvelle version peut désigner une version de fonctionnalité, un correctif, une mise à jour de sécurité ou un autre type de mise à jour de Drupal. Dans le cas d'une mise à jour de sécurité, vous devez mettre à niveau votre installation de Drupal dès que possible pour garantir la sécurité de votre site.

La procédure ci-dessous explique comment mettre à jour une installation de cloud privé de Drupal 7.x.y vers une autre version mineure (par exemple, de Drupal 7.54 à 7.56).

Remarques :

• Cette procédure ne met à jour que votre installation de Drupal. Il ne met pas à jour le logiciel Apigee fourni avec le portail. Pour savoir comment mettre à niveau le logiciel du portail Apigee, consultez Mettre à niveau le portail.

• Vous devez exécuter les commandes Drush à partir du répertoire racine du site du portail. Par défaut, le portail est installé à l'emplacement suivant :
  • /opt/apigee/apigee-drupal/wwwroot (Nginx)
  • /var/www/html (Apache)
  La procédure ci-dessous suppose que le serveur Nginx est installé à l'emplacement par défaut ci-dessus.

Déterminer votre version actuelle de Drupal

Avant de commencer la mise à jour de Drupal, vous pouvez déterminer la version actuelle de Drupal en exécutant la commande suivante à partir du dossier d'installation de Drupal. Par défaut, Drupal est installé dans /opt/apigee/apigee-drupal/wwwroot:

cd /opt/apigee/apigee-drupal/wwwroot

drush status | grep 'Drupal version'

Le résultat doit s'afficher au format suivant :

Drupal version          :  7.54

Si vous avez installé Drupal dans un répertoire autre que /opt/apigee/apigee-drupal/wwwroot, assurez-vous d'accéder à ce répertoire avant d'exécuter la commande drush.

Mettre à jour la version de Drupal

Cette section explique comment utiliser Drush (Drupal Shell) à partir d'une ligne de commande pour mettre à jour votre version Drupal. Consultez également la section Mettre à jour Drupal à l'aide de Drush dans la documentation Drupal.

Pour mettre à jour votre installation Drupal:

1. Accédez au répertoire /opt/apigee/apigee-drupal/wwwroot ou au répertoire dans lequel vous avez installé le portail.
2. Effectuez une sauvegarde complète de tous les fichiers, répertoires et bases de données. Enregistrez la sauvegarde à un emplacement hors de l'installation Drupal. Pour obtenir des instructions détaillées, consultez la section Sauvegarder le portail.

   Si vous avez apporté des modifications à des fichiers tels que .htaccess, robots.txt ou defaults.settings.php (dans le répertoire sites), vous devrez appliquer à nouveau les modifications après la mise à jour. Vous devrez également réappliquer toutes les personnalisations apportées au répertoire sites/all.

3. Mettez votre site en mode maintenance :

   drush vset --exact maintenance_mode 1

   drush cache-clear all

4. Installez la version de Drupal souhaitée à l'aide de la commande suivante :

   drush pm-update drupal-7.56

   Vous pouvez également exécuter drush pm-update drupal pour passer à la dernière version du noyau Drupal. Vous pouvez exécuter drush pm-updatestatus pour lister les mises à jour mineures disponibles pour le noyau Drupal et les projets associés.

5. Appliquez à nouveau les modifications apportées à .htaccess, robots.txt ou defaults.settings.php (dans le répertoire sites).
6. Réappliquez les modifications apportées au répertoire sites/all .
7. Désactivez le mode de maintenance de votre site:
   

   drush vset --exact maintenance_mode 0

   drush cache-clear all

Que se passe-t-il si je rencontre un problème pendant la mise à jour ?

Restaurez votre site à son état précédent à l'aide des fichiers de sauvegarde que vous avez créés. Contactez votre représentant de l'assistance Apigee et fournissez-lui tous les messages d'erreur signalés lors de la mise à jour.