Esegui l'upgrade di Drupal

In un'installazione Edge per cloud privato del portale Apigee Developer Services (o semplicemente, il portale), potresti ricevere una notifica che indica che è disponibile una nuova versione di Drupal. Una nuova versione può indicare un rilascio di funzionalità, una patch, un aggiornamento della sicurezza o un altro tipo di aggiornamento Drupal di Drupal. In caso di aggiornamento della sicurezza, vuoi eseguire l'upgrade dell'installazione di Drupal appena possibile per assicurarti che il tuo sito rimanga sicuro.

Esegui l'upgrade del core Drupal

La procedura seguente descrive come aggiornare un'installazione nel cloud privato di Drupal 7.x.y a un'altra versione secondaria (ad esempio, Drupal da 7.54 a 7.59).

Tieni presente quanto segue:

• Questa procedura aggiorna solo la tua installazione di Drupal. Non aggiorna il software Apigee fornito come parte del portale. Per informazioni sull'upgrade del software del portale Apigee, consulta l'articolo sull'upgrade del portale.

  Se durante un upgrade del cloud privato (ad esempio da 4.18.05 a 4.19.01), l'utilità di aggiornamento Apigee effettivamente esegui il downgrade della tua versione di Drupal, potrebbe essere necessario eseguire nuovamente l'utilità di upgrade Drupal. Per maggiori informazioni, consulta Eseguire nuovamente l'upgrade di Drupal.

• Devi eseguire i comandi Drush (Drupal Shell) dalla directory root del sito del portale. Per impostazione predefinita, il portale è installato all'indirizzo:
  • /opt/apigee/apigee-drupal/wwwroot (nginx)
  • /var/www/html (apache)
  La procedura riportata di seguito presuppone l'installazione di un server Nginx nella posizione predefinita indicata sopra.

Determinare la versione attuale di Drupal

Prima di avviare l'aggiornamento di Drupal, puoi determinare la tua versione attuale di Drupal eseguendo il comando seguente dalla cartella di installazione di Drupal. Per impostazione predefinita, Drupal è installato in /opt/apigee/apigee-drupal/wwwroot:

cd /opt/apigee/apigee-drupal/wwwroot

drush status | grep 'Drupal version'

Dovresti vedere l'output nel formato:

Drupal version          :  7.54

Se hai installato Drupal in una directory diversa da /opt/apigee/apigee-drupal/wwwroot, assicurati di passare a quella directory prima di eseguire il comando drush.

Aggiorna la versione di Drupal

Questa sezione descrive come utilizzare i comandi Drush dalla riga di comando per aggiornare la versione di Drupal. Consulta anche Aggiornamento di Drupal tramite Drush (Drupal.org).

Per aggiornare l'installazione Drupal:

1. Passa alla directory /opt/apigee/apigee-drupal/wwwroot o alla directory in cui hai installato il portale.
2. Esegui un backup completo di tutti i file, le directory e i database. Salva il backup in una posizione esterna all'installazione Drupal. Per le istruzioni complete, vedi Effettuare il backup del portale.

   Se hai apportato modifiche a file quali .htaccess, robots.txt o defaults.settings.php (nella directory sites), dovrai applicare di nuovo le modifiche dopo l'aggiornamento. Dovrai anche applicare di nuovo le eventuali personalizzazioni apportate nella directory sites/all.

3. Attiva la modalità di manutenzione del tuo sito:

   drush vset --exact maintenance_mode 1

   drush cache-clear all

4. Installa la versione di Drupal che ti interessa utilizzando il seguente comando:

   drush pm-update drupal-version

   Dove version è la versione desiderata.

   In alternativa, puoi eseguire drush pm-update drupal per eseguire l'aggiornamento all'ultima versione core di Drupal. Puoi eseguire drush pm-updatestatus per elencare gli aggiornamenti minori disponibili per i progetti principali e per i contributi di Drupal.

5. Applica di nuovo le modifiche apportate a .htaccess, robots.txt o defaults.settings.php (nella directory sites).
6. Applica di nuovo le modifiche apportate alla directory sites/all .
7. Disattiva la modalità di manutenzione del tuo sito:
   

   drush vset --exact maintenance_mode 0

   drush cache-clear all

Upgrade dei moduli di contributo PHP e Drupal

Quando esegui l'upgrade di Drupal utilizzando le istruzioni riportate sopra in questa sezione, viene eseguito l'upgrade anche dei moduli utilizzati da Drupal, come contrib e PHP. Tuttavia, ti consigliamo di rimanere al passo con gli ultimi moduli Drupal tra una release di Private Cloud e l'altra.

Tieni presente che se il modulo è in /profiles/apigee/modules/contrib, puoi sostituirlo con una versione più recente del modulo memorizzando la versione più recente in /sites/all/modules/contrib. Edge per il cloud privato utilizza la versione più recente in /sites/all/modules/contrib anziché la versione precedente in /profiles/apigee/modules/contrib. Per maggiori informazioni, consulta Aggiornare i moduli (Drupal.org).

Se installi una nuova versione del cloud privato che include una versione più recente del modulo precedentemente archiviato in /sites/all/modules/contrib, rimuovi il modulo da /sites/all/modules/contrib. Per maggiori informazioni, consulta la pagina Spostare moduli e temi (Drupal.org).

Cosa succede se si verifica un problema durante l'aggiornamento?

Ripristina lo stato precedente del sito utilizzando i file di backup che hai creato. Contatta l'assistenza Apigee Edge e fornisci gli eventuali messaggi di errore segnalati durante l'aggiornamento.