Nâng cấp Drupal

Edge cho đám mây riêng tư phiên bản 4.19.01

Trong quá trình cài đặt Edge dành cho đám mây riêng tư của cổng Dịch vụ dành cho nhà phát triển Apigee (hay đơn giản là cổng), bạn có thể nhận được thông báo cho biết đã có phiên bản mới của Drupal. Phiên bản mới có thể là bản phát hành tính năng, bản vá, bản cập nhật bảo mật hoặc một loại bản cập nhật khác của Drupal. Trong trường hợp cần cập nhật bảo mật, bạn nên nâng cấp bản cài đặt Drupal càng sớm càng tốt để đảm bảo rằng trang web của bạn vẫn an toàn.

Nâng cấp Drupal Core

Quy trình dưới đây mô tả cách cập nhật một bản cài đặt Đám mây riêng tư của Drupal 7.x.y lên một phiên bản nhỏ khác (ví dụ: Drupal 7.54 lên 7.59).

Xin lưu ý những điều sau:

  • Quy trình này chỉ cập nhật chế độ cài đặt Drupal của bạn. Chính sách này không cập nhật phần mềm Apigee được cung cấp trong cổng thông tin. Để biết thông tin về cách nâng cấp phần mềm cổng thông tin Apigee, hãy xem phần Nâng cấp cổng thông tin.

    Nếu trong quá trình nâng cấp lên Đám mây riêng tư (ví dụ: từ 4.18.05 lên 4.19.01), tiện ích cập nhật Apigee thực sự hạ cấp phiên bản Drupal, thì bạn có thể cần chạy lại tiện ích nâng cấp Drupal. Để biết thêm thông tin, hãy xem bài viết Chạy lại bản nâng cấp Drupal.

  • Bạn phải thực thi các lệnh Drush (Lỗi Drupal Shell) từ thư mục gốc của trang web cổng thông tin. Theo mặc định, cổng thông tin này được cài đặt tại:
    • /opt/apigee/apigee-drupal/wwwroot (Nginx)
    • /var/www/html (Apache)
    Quy trình dưới đây giả định việc cài đặt máy chủ Nginx tại vị trí mặc định nêu trên.

Xác định phiên bản Drupal hiện tại của bạn

Trước khi bắt đầu cập nhật Drupal, bạn có thể xác định phiên bản Drupal hiện tại bằng cách chạy lệnh sau từ thư mục cài đặt Drupal. Theo mặc định, Drupal được cài đặt trong /opt/apigee/apigee-drupal/wwwroot:

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

Bạn sẽ thấy kết quả dưới dạng:

Drupal version          :  7.54

Nếu bạn đã cài đặt Drupal trong một thư mục khác /opt/apigee/apigee-drupal/wwwroot, hãy nhớ thay đổi sang thư mục đó trước khi chạy lệnh drush.

Cập nhật phiên bản Drupal

Phần này mô tả cách sử dụng các lệnh Drush qua một dòng lệnh để cập nhật phiên bản Drupal. Xem thêm bài viết Cập nhật Drupal bằng Drush (Drupal.org).

Cách cập nhật chế độ cài đặt Drupal:

  1. Thay đổi sang thư mục /opt/apigee/apigee-drupal/wwwroot hoặc thư mục nơi bạn đã cài đặt cổng thông tin.
  2. Sao lưu toàn bộ tệp, thư mục và cơ sở dữ liệu. Lưu bản sao lưu ở một vị trí ngoài quy trình cài đặt Drupal. Để xem hướng dẫn đầy đủ, hãy xem phần Sao lưu cổng thông tin.

    Nếu đã sửa đổi các tệp như .htaccess, robots.txt hoặc defaults.settings.php (trong thư mục sites), bạn sẽ phải áp dụng lại các thay đổi sau khi cập nhật. Bạn cũng cần phải áp dụng lại mọi nội dung tuỳ chỉnh đã thực hiện trong thư mục sites/all.

  3. Đặt trang web của bạn ở chế độ bảo trì: 
    drush vset --exact maintenance_mode 1
    drush cache-clear all
  4. Cài đặt phiên bản Drupal mà bạn muốn bằng cách dùng lệnh sau: 
    drush pm-update drupal-version

    Trong đó version là phiên bản mong muốn.

    Ngoài ra, bạn có thể chạy drush pm-update drupal để cập nhật lên phiên bản cốt lõi mới nhất của Drupal. Bạn có thể chạy drush pm-updatestatus để liệt kê các bản cập nhật nhỏ hiện có cho các dự án đóng góp và dự án cốt lõi của Drupal.

  5. Áp dụng lại mọi thay đổi đã thực hiện cho .htaccess, robots.txt hoặc defaults.settings.php (trong thư mục sites).
  6. Áp dụng lại mọi thay đổi đối với thư mục sites/all .
  7. Chuyển trang web của bạn khỏi chế độ bảo trì: 
    drush vset --exact maintenance_mode 0
    drush cache-clear all

Nâng cấp các mô-đun contrib PHP và Drupal

Khi bạn nâng cấp Drupal theo hướng dẫn ở trên trong phần này, các mô-đun mà Drupal sử dụng như contrib và PHP cũng sẽ được nâng cấp. Tuy nhiên, bạn nên cập nhật những mô-đun Drupal mới nhất giữa các bản phát hành của Đám mây riêng tư.

Lưu ý rằng nếu mô-đun nằm trong /profiles/apigee/modules/contrib, bạn có thể thay thế mô-đun đó bằng một phiên bản mới hơn của mô-đun đó bằng cách lưu trữ phiên bản mới hơn trong /sites/all/modules/contrib. Edge dành cho đám mây riêng tư sử dụng phiên bản mới trong /sites/all/modules/contrib thay vì phiên bản cũ trong /profiles/apigee/modules/contrib. Để biết thêm thông tin, hãy xem bài viết Cập nhật mô-đun (Drupal.org).

Nếu bạn cài đặt một phiên bản Đám mây riêng tư mới bao gồm một phiên bản mới hơn của mô-đun đã lưu trữ trước đó trong /sites/all/modules/contrib, hãy xoá mô-đun khỏi /sites/all/modules/contrib. Để biết thêm thông tin, hãy xem bài viết Di chuyển mô-đun và giao diện (Drupal.org).

Nếu tôi gặp vấn đề trong quá trình cập nhật thì sao?

Khôi phục trang web của bạn về trạng thái trước đó bằng cách sử dụng các tệp sao lưu bạn đã tạo. Liên hệ với Nhóm hỗ trợ Apigee và cung cấp mọi thông báo lỗi được báo cáo trong quá trình cập nhật.