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

Edge pour Private Cloud v. 4.17.09

Dans une installation Edge pour Private Cloud du portail de services pour les développeurs, vous pouvez recevoir une notification indiquant qu'une nouvelle version de Drupal est disponible. Une nouvelle version peut être une version de fonctionnalité Drupal, un correctif, une mise à jour de sécurité ou un autre type de mise à jour Drupal. En cas de 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 à 7.56).

Remarques :

  • Cette procédure ne met à jour que votre installation de Drupal. Il ne met pas à jour le logiciel Apigee fourni dans le portail. Pour en savoir plus sur la mise à niveau du logiciel du portail Apigee, consultez Mettre à niveau le portail Developer Services.

  • 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 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 de Drupal. Consultez également la page 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 en dehors 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 de 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

    Remarque:Remplacez 7.56 par la version souhaitée.
    Vous pouvez également exécuter la commande drush pm-update drupal pour installer la dernière version de Drupal principale. Vous pouvez exécuter drush pm-updatestatus pour lister les mises à jour mineures disponibles pour le noyau 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 de 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 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 fournissez les messages d'erreur signalés lors de la mise à jour.