Mettre à niveau Drupal

Edge for 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 correspondre à 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 vous assurer que votre site reste sécurisé.

La procédure ci-dessous explique comment mettre à jour une installation Private Cloud de Drupal 7.x.y vers une autre version mineure (par exemple, Drupal 7.54 vers 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 en savoir plus sur la mise à niveau du 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 indiqué ci-dessus.

Déterminer votre version actuelle de Drupal

Avant de commencer la mise à jour de Drupal, vous pouvez déterminer votre 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, veillez à 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 de 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 dans un emplacement situé en dehors de l'installation Drupal. Pour obtenir des instructions complètes, consultez la section Sauvegarder le portail.

   Si vous avez modifié des fichiers tels que .htaccess, robots.txt ou defaults.settings.php (dans le répertoire sites), vous devrez réappliquer les modifications après la mise à jour. Vous devrez également réappliquer les personnalisations effectuées dans le 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 souhaitée de Drupal à l'aide de la commande suivante :

   drush pm-update drupal-7.56

   Vous pouvez également exécuter drush pm-update drupal pour installer la dernière version principale de Drupal. Vous pouvez exécuter drush pm-updatestatus pour lister les mises à jour mineures disponibles pour le cœur de Drupal et les projets contrib.

5. Réappliquez 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 maintenance de votre site :
   

   drush vset --exact maintenance_mode 0

   drush cache-clear all

Que faire si je rencontre un problème lors de 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 les messages d'erreur signalés lors de la mise à jour.