Edge for Private Cloud v4.19.01
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é.
Mettre à niveau le cœur de Drupal
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.59).
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.
Si, lors d'une mise à niveau de Private Cloud (par exemple, de la version 4.18.05 à la version 4.19.01), l'utilitaire de mise à jour Apigee rétrograde votre version de Drupal, vous devrez peut-être réexécuter l'utilitaire de mise à niveau de 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 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 les commandes Drush à partir d'une ligne de commande pour mettre à jour votre version de Drupal. Consultez également 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 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.txtoudefaults.settings.php(dans le répertoiresites), vous devrez réappliquer les modifications après la mise à jour. Vous devrez également réappliquer les personnalisations effectuées dans le répertoiresites/all. - Mettez votre site en mode 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 est la version souhaitée.
Vous pouvez également exécuter
drush pm-update drupalpour installer la dernière version du noyau Drupal. Vous pouvez exécuterdrush pm-updatestatuspour lister les mises à jour mineures disponibles pour le cœur de Drupal et les projets contrib. - Réappliquez les modifications apportées à
.htaccess,robots.txtoudefaults.settings.php(dans le répertoiresites). - Réappliquez les modifications apportées au répertoire
sites/all. - Désactivez le mode maintenance de votre site :
drush vset --exact maintenance_mode 0
drush cache-clear all
Mettre à niveau les modules de contribution PHP et Drupal
Lorsque vous mettez à niveau Drupal en suivant les instructions ci-dessus, les modules utilisés par Drupal, tels que contrib et PHP, sont également mis à niveau. Toutefois, vous devez vous tenir informé des derniers modules Drupal entre les versions de Private Cloud.
Notez que si le module se trouve dans /profiles/apigee/modules/contrib, vous pouvez le remplacer par une version plus récente de ce module en stockant la version plus récente 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 Mettre à jour des modules (Drupal.org).
Si vous installez une nouvelle version de Private Cloud qui inclut une version plus récente du module précédemment stocké dans /sites/all/modules/contrib, supprimez le module de /sites/all/modules/contrib. Pour en savoir plus, consultez Déplacer des modules et des thèmes (Drupal.org).
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 l'assistance Apigee Edge et fournissez les messages d'erreur signalés lors de la mise à jour.