Upgrade Drupal

Dalam penginstalan Edge for Private Cloud dari portal Layanan Developer Apigee (atau cukup dengan portal), Anda mungkin mendapatkan notifikasi bahwa Drupal versi baru telah tersedia. Versi baru dapat berarti fitur Drupal rilis, patch, update keamanan, atau jenis update Drupal lainnya. Dalam kasus sekuritas Anda ingin mengupgrade penginstalan Drupal sesegera mungkin untuk memastikan bahwa situs tetap aman.

Mengupgrade inti Drupal

Prosedur di bawah ini menjelaskan cara mengupdate penginstalan Private Cloud Drupal 7.x.y ke versi minor lainnya (misalnya, Drupal 7.54 hingga 7.59).

Harap perhatikan hal berikut:

  • Prosedur ini hanya memperbarui penginstalan Drupal Anda. Proses ini tidak mengupdate Apigee perangkat lunak yang dikirimkan sebagai bagian dari portal. Untuk mengetahui informasi tentang mengupgrade portal Apigee software-nya, lihat Mengupgrade portal.

    Jika selama upgrade Private Cloud (misalnya, dari 4.18.05 ke 4.19.01), update Apigee utilitas sebenarnya telah mendowngrade versi Drupal, Anda mungkin perlu menjalankan ulang Utilitas upgrade Drupal. Untuk informasi selengkapnya, lihat Jalankan kembali upgrade Drupal.

  • Anda harus menjalankan Drush (Drupal Shell) dari direktori {i>root<i} situs portal. Secara default, portal diinstal di:
    • /opt/apigee/apigee-drupal/wwwroot (NGINX)
    • /var/www/html (Apache)
    Prosedur di bawah mengasumsikan penginstalan server NGINX di lokasi default di atas.

Menentukan versi Drupal saat ini

Sebelum memulai update Drupal, Anda dapat menentukan versi Drupal saat ini dengan menjalankan perintah berikut dari folder instalasi Drupal. Secara default, Drupal diinstal di /opt/apigee/apigee-drupal/wwwroot:

cd /opt/apigee/apigee-drupal/wwwroot
 
drush status | grep 'Drupal version'

Anda akan melihat output dalam bentuk:

Drupal version          :  7.54

Jika Anda menginstal Drupal di direktori selain /opt/apigee/apigee-drupal/wwwroot, pastikan untuk mengubah ke direktori tersebut sebelum menjalankan perintah drush.

Mengupdate versi Drupal

Bagian ini menjelaskan cara menggunakan perintah Drush dari command line untuk mengupdate Drupal . Lihat juga Mengupdate Drupal Menggunakan Drush (Drupal.org).

Untuk mengupdate penginstalan Drupal:

  1. Ubah ke /opt/apigee/apigee-drupal/wwwroot direktori, atau direktori tempat Anda menginstal portal.
  2. Buat cadangan penuh dari semua file, direktori, dan {i>database<i}. Menyimpan cadangan di lokasi di luar instalasi Drupal. Untuk petunjuk selengkapnya, lihat Cadangkan portal.

    Jika Anda mengubah file seperti .htaccess, robots.txt, atau defaults.settings.php (di sites direktori), Anda harus menerapkan kembali perubahan setelah pembaruan. Anda juga perlu menerapkan kembali setiap penyesuaian yang dibuat di direktori sites/all.

  3. Setel situs Anda ke mode pemeliharaan: 
    drush vset --exact maintenance_mode 1
     
    drush cache-clear all
  4. Instal versi Drupal yang diinginkan dengan menggunakan perintah berikut: 
    drush pm-update drupal-version

    Dengan version adalah versi yang diinginkan.

    Atau, Anda dapat menjalankan drush pm-update drupal untuk mengupdate ke versi terbaru Versi inti Drupal. Anda dapat menjalankan drush pm-updatestatus untuk mencantumkan yang tersedia update minor pada project inti dan contrib Drupal.

  5. Terapkan kembali perubahan yang dibuat pada .htaccess, robots.txt, atau defaults.settings.php (di direktori sites).
  6. Terapkan kembali perubahan apa pun yang dibuat pada direktori sites/all .
  7. Alihkan situs Anda dari mode pemeliharaan: 
    drush vset --exact maintenance_mode 0
     
    drush cache-clear all

Mengupgrade modul contrib PHP dan Drupal

Jika Anda mengupgrade Drupal menggunakan petunjuk di atas di bagian ini, modul yang digunakan oleh Drupal seperti contrib dan PHP juga diupgrade. Namun, Anda harus terus mendapatkan update Drupal terbaru modul di antara rilis Private Cloud.

Perhatikan bahwa jika modul berada dalam /profiles/apigee/modules/contrib, Anda dapat mengganti dengan versi yang lebih baru dari modul tersebut dengan menyimpan versi yang lebih baru di /sites/all/modules/contrib. Edge untuk Private Cloud menggunakan versi yang lebih baru di /sites/all/modules/contrib, bukan versi yang lebih lama di /profiles/apigee/modules/contrib. Untuk informasi selengkapnya, lihat Memperbarui modul (Drupal.org).

Jika Anda menginstal versi Private Cloud baru yang menyertakan versi modul yang lebih baru yang sebelumnya disimpan di /sites/all/modules/contrib, hapus modul dari /sites/all/modules/contrib. Untuk informasi selengkapnya, lihat Pindahan modul dan tema (Drupal.org).

Bagaimana jika saya mengalami masalah selama perbarui?

Pulihkan situs Anda ke keadaan sebelumnya menggunakan file cadangan yang Anda buat. Kontak Dukungan Apigee Edge dan memberikan pesan error apa pun yang dilaporkan selama update.