Upgrade Drupal

Edge untuk Private Cloud v4.19.01

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

Mengupgrade core 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 mengupdate penginstalan Drupal Anda. Update ini tidak mengupdate software Apigee yang dikirimkan 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 mendowngrade versi Drupal Anda, Anda mungkin perlu menjalankan ulang utilitas upgrade Drupal. Untuk informasi selengkapnya, lihat Menjalankan kembali upgrade Drupal.

  • Anda harus menjalankan perintah Drush (Drupal Shell) dari direktori utama 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 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 mengubahnya 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. Baca 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 dari semua file, direktori, dan {i>database<i}. Simpan cadangan di lokasi di luar penginstalan Drupal. Untuk mengetahui petunjuk selengkapnya, lihat Mencadangkan portal.

    Jika Anda melakukan modifikasi pada file seperti .htaccess, robots.txt, atau defaults.settings.php (dalam direktori sites), Anda harus menerapkan ulang perubahan setelah update. Anda juga harus menerapkan kembali 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 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 kecil yang tersedia untuk project core dan contrib Drupal.

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

Mengupgrade modul contrib 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 memantau modul Drupal terbaru di antara rilis Private Cloud.

Perlu diketahui 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 untuk Private Cloud menggunakan versi yang lebih baru di /sites/all/modules/contrib, bukan versi lama di /profiles/apigee/modules/contrib. Untuk mengetahui informasi selengkapnya, lihat Mengupdate modul (Drupal.org).

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

Bagaimana jika saya mengalami masalah selama update?

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