Edge for Private Cloud v4.19.01
Dans une installation Edge for Private Cloud du portail de services pour les développeurs Apigee (ou simplement, le portail), 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é.
Mettre à niveau le noyau Drupal
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.59).
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 Mettre à niveau le portail.
Si, lors d'une mise à niveau d'un cloud privé (de la version 4.18.05 à la version 4.19.01, par exemple), l'utilitaire de mise à jour Apigee inférieur votre version de Drupal, vous devrez peut-être réexécuter l'utilitaire de mise à niveau Drupal. Pour en savoir plus, consultez Réexécuter la mise à niveau de Drupal.
- Vous devez exécuter les commandes Drush (Drupal Shell) à 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)
Déterminer votre version actuelle de Drupal
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 à y accéder avant d'exécuter la commande drush.
Mettre à jour la version Drupal
Cette section explique comment utiliser les commandes Drush à partir d'une ligne de commande pour mettre à jour votre version de Drupal. Consultez également la page Mettre à jour Drupal à l'aide de Drush (Drupal.org).
Pour mettre à jour votre installation Drupal:
- Accédez au répertoire
/opt/apigee/apigee-drupal/wwwrootou au répertoire dans lequel vous avez installé le portail. - 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 Sauvegarder le portail.
Si vous avez apporté des modifications à des fichiers tels que
.htaccess,robots.txtoudefaults.settings.php(dans le répertoiresites), vous devrez réappliquer les modifications après la mise à jour. Vous devez également réappliquer les personnalisations effectuées dans le répertoiresites/all. - Passez le site en mode de maintenance :
drush vset --exact maintenance_mode 1
drush cache-clear all
- Installez la version souhaitée de Drupal à l'aide de la commande suivante :
drush pm-update drupal-version
Où version correspond à la version souhaitée.
Vous pouvez également exécuter
drush pm-update drupalpour passer à la dernière version principale de Drupal. Vous pouvez exécuterdrush pm-updatestatuspour répertorier les mises à jour mineures disponibles pour les projets de base et de contrib de Drupal. - Réappliquez les modifications apportées à
.htaccess,robots.txtoudefaults.settings.php(dans le répertoiresites). - Réappliquez toutes les modifications apportées au répertoire
sites/all. - Désactivez le mode de maintenance pour votre site:
drush vset --exact maintenance_mode 0
drush cache-clear all
Mettre à niveau les modules de contrib PHP et Drupal
Lorsque vous mettez à niveau Drupal en suivant les instructions ci-dessus dans cette section, les modules utilisés par Drupal tels que contrib et PHP sont également mis à niveau. Toutefois, vous devez vous tenir informé des derniers modules de Drupal entre les versions du cloud privé.
Notez que si le module se trouve dans /profiles/apigee/modules/contrib, vous pouvez le remplacer par une version plus récente en stockant la dernière version dans /sites/all/modules/contrib. Edge for Private Cloud utilise la version la plus récente dans /sites/all/modules/contrib plutôt que l'ancienne version dans /profiles/apigee/modules/contrib. Pour en savoir plus, consultez la page Mettre à jour des modules (Drupal.org).
Si vous installez une nouvelle version du cloud privé qui inclut une version plus récente du module précédemment stocké dans /sites/all/modules/contrib, supprimez-le de /sites/all/modules/contrib. Pour en savoir plus, consultez la page Déplacer des modules et des thèmes (Drupal.org).
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 l'assistance Apigee Edge et indiquez les messages d'erreur signalés lors de la mise à jour.