Esegui l'upgrade di Drupal

In un'installazione Edge for Private Cloud 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ò essere una release di funzionalità, una patch, un aggiornamento della sicurezza o un altro tipo di aggiornamento di Drupal. Nel caso di un aggiornamento della sicurezza, ti consigliamo di eseguire l'upgrade dell'installazione di Drupal il prima possibile per garantire che il tuo sito rimanga sicuro.

Esegui l'upgrade del core di Drupal

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

Tieni presente quanto segue:

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

    Se durante un upgrade di cloud privato (ad esempio, dalla versione 4.18.05 alla 4.19.01), l'utilità di aggiornamento di Apigee esegue effettivamente il downgrade della tua versione di Drupal, potresti dover eseguire nuovamente l'utilità di upgrade di Drupal. Per saperne di più, consulta Esegui 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 in:
    • /opt/apigee/apigee-drupal/wwwroot (Nginx)
    • /var/www/html (Apache)
    La procedura riportata di seguito presuppone l'installazione di un server Nginx nella località predefinita indicata sopra.

Determina la versione attuale di Drupal

Prima di iniziare l'aggiornamento di Drupal, puoi determinare la versione corrente 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 visualizzare un output nel seguente 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 da una riga di comando per aggiornare la versione di Drupal. Consulta anche Updating Drupal Using Drush (Drupal.org).

Per aggiornare l'installazione di 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 di Drupal. Per istruzioni complete, consulta Esegui il backup del portale.

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

  3. Attiva la modalità di manutenzione del sito:
    drush vset --exact maintenance_mode 1
    drush cache-clear all
  4. Installa la versione di Drupal che preferisci utilizzando il seguente comando:
    drush pm-update drupal-version

    Dove version è la versione che vuoi.

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

  5. Riapplica le modifiche apportate a .htaccess, robots.txt o defaults.settings.php (nella directory sites).
  6. Applica nuovamente le modifiche apportate alla directory sites/all .
  7. Disattiva la modalità di manutenzione del sito:
    drush vset --exact maintenance_mode 0
    drush cache-clear all

Esegui l'upgrade dei moduli contrib di PHP e Drupal

Quando esegui l'upgrade di Drupal seguendo le istruzioni riportate sopra in questa sezione, viene eseguito l'upgrade anche dei moduli utilizzati da Drupal, come contrib e PHP. Tuttavia, devi tenerti al corrente degli ultimi moduli Drupal tra le release di cloud privato.

Tieni presente che se il modulo si trova in /profiles/apigee/modules/contrib, puoi sostituirlo con una versione più recente archiviando quest'ultima in /sites/all/modules/contrib. Edge for Private Cloud utilizza la versione più recente in /sites/all/modules/contrib anziché la versione precedente in /profiles/apigee/modules/contrib. Per saperne di più, consulta Aggiornamento dei moduli (Drupal.org).

Se installi una nuova versione di Private Cloud che include una versione più recente del modulo archiviato in precedenza in /sites/all/modules/contrib, rimuovi il modulo da /sites/all/modules/contrib. Per saperne di più, consulta Spostamento di moduli e temi (Drupal.org).

Cosa succede se riscontro 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 eventuali messaggi di errore segnalati durante l'aggiornamento.