Upgrade Drupal

Dalam penginstalan Edge for Private Cloud di portal Layanan Developer Apigee (atau singkatnya, portal), Anda mungkin mendapatkan notifikasi bahwa versi baru Drupal telah tersedia. Versi baru dapat berarti rilis fitur, patch, update keamanan, atau jenis update Drupal lainnya. Jika ada update keamanan, Anda harus mengupgrade penginstalan Drupal sesegera mungkin untuk memastikan situs Anda tetap aman.

Mengupgrade Drupal core

Prosedur di bawah menjelaskan cara mengupdate penginstalan Drupal 7.x.y di cloud pribadi ke versi minor lain (misalnya, Drupal 7.54 ke 7.59).

Harap perhatikan hal berikut:

• Prosedur ini hanya mengupdate penginstalan Drupal Anda. Tindakan ini tidak mengupdate software Apigee yang disertakan sebagai bagian dari portal. Untuk mengetahui informasi tentang cara mengupgrade software portal Apigee, lihat Mengupgrade portal.

  Jika selama upgrade Private Cloud (misalnya, dari 4.18.05 ke 4.19.01), utilitas update Apigee benar-benar menurunkan versi Drupal Anda, Anda mungkin perlu menjalankan ulang utilitas upgrade Drupal. Untuk mengetahui informasi selengkapnya, lihat Menjalankan ulang upgrade Drupal.

• Anda harus menjalankan perintah Drush (Drupal Shell) dari direktori root 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 Anda saat ini

Sebelum memulai update Drupal, Anda dapat menentukan versi Drupal saat ini dengan menjalankan perintah berikut dari folder penginstalan 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 versi Drupal Anda. Lihat juga Mengupdate Drupal Menggunakan Drush (Drupal.org).

Untuk mengupdate penginstalan Drupal:

1. Ubah ke direktori /opt/apigee/apigee-drupal/wwwroot, atau direktori tempat Anda menginstal portal.
2. Buat cadangan penuh untuk semua file, direktori, dan database. Simpan cadangan di lokasi di luar penginstalan Drupal. Untuk petunjuk lengkap, lihat Mencadangkan portal.

   Jika Anda melakukan modifikasi pada file seperti .htaccess, robots.txt, atau defaults.settings.php (di direktori sites), Anda harus menerapkan kembali perubahan setelah update. Anda juga harus menerapkan kembali penyesuaian yang dibuat di direktori sites/all.

3. Tempatkan situs Anda dalam mode pemeliharaan:

   drush vset --exact maintenance_mode 1

   drush cache-clear all

4. Instal versi Drupal yang diinginkan 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 inti Drupal terbaru. Anda dapat menjalankan drush pm-updatestatus untuk mencantumkan update minor yang tersedia untuk project inti dan kontribusi Drupal.

5. Terapkan kembali perubahan apa pun yang dilakukan pada .htaccess, robots.txt, atau defaults.settings.php (di direktori sites).
6. Terapkan kembali perubahan apa pun yang dilakukan pada direktori sites/all .
7. Keluarkan situs Anda dari mode pemeliharaan:
   

   drush vset --exact maintenance_mode 0

   drush cache-clear all

Mengupgrade modul kontribusi PHP dan Drupal

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

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

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

Bagaimana jika saya mengalami masalah selama update?

Pulihkan situs Anda ke status sebelumnya menggunakan file cadangan yang Anda buat. Hubungi Dukungan Apigee Edge dan berikan pesan error yang dilaporkan selama update.