Mettre à niveau la version Drupal d'une installation de cloud privé

Edge pour Private Cloud version 4.17.09

Dans une installation Edge pour Private Cloud du portail des services pour les développeurs, vous pouvez recevoir une notification vous informant qu'une nouvelle version de Drupal est disponible. Une nouvelle version peut signifier la publication d'une fonctionnalité, d'un correctif, d'une mise à jour de sécurité ou d'un autre type de mise à jour Drupal. Dans le cas d'une mise à jour de sécurité, vous devez mettre à niveau votre installation 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 de cloud privé de Drupal 7.xxx 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. Elle ne met pas à jour le logiciel Apigee inclus dans le portail. Pour en savoir plus sur la mise à niveau du logiciel du portail Apigee, consultez la section Mettre à niveau le portail des services pour les développeurs.

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

Déterminer votre version Drupal actuelle

Avant de lancer la mise à jour 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 à passer à ce répertoire avant d'exécuter la commande drush.

Mettre à jour la version 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. Passez 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 en dehors de l'installation de 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 réappliquer les modifications après la mise à jour. Vous devez également réappliquer les personnalisations effectuées dans le répertoire sites/all.

  3. Passez votre site en mode de maintenance:
    > drush vset --exact maintenance_mode 1 
    > drush cache-clear all
    
  4. Installez la version souhaitée de Drupal en utilisant la commande suivante:

    > drush pm-update drupal-7.56

    Remarque:Remplacez la version 7.56 par la version souhaitée.
    Vous pouvez également exécuter la commande drush pm-update drupal pour passer à la dernière version principale de Drupal. Vous pouvez exécuter drush pm-updatestatus pour répertorier les mises à jour mineures disponibles pour les projets Drupal Core et Contrib.
  5. Réappliquez les modifications apportées à .htaccess, robots.txt ou defaults.settings.php (dans le répertoire sites).
  6. Réappliquez toutes les modifications apportées au répertoire sites/all .
  7. Désactivez le mode de maintenance pour 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 l'état précédent de votre site à l'aide des fichiers de sauvegarde que vous avez créés. Contactez votre représentant de l'assistance Apigee et indiquez les messages d'erreur signalés lors de la mise à jour.