Uaktualnij Drupal

Podczas instalacji portalu usług dla programistów Apigee (lub portalu) w Edge for Private Cloud możesz zobaczyć powiadomienie o dostępnej nowej wersji Drupala. Nowa wersja może oznaczać wydanie funkcji Drupala, poprawkę, aktualizację zabezpieczeń lub inny rodzaj aktualizacji w tym systemie. W przypadku aktualizacji zabezpieczeń warto jak najszybciej uaktualnić instalację Drupala, aby zapewnić bezpieczeństwo witryny.

Uaktualnienie Drupal Core

Procedura poniżej opisuje, jak zaktualizować instalację Private Cloud pakietu Drupal 7.x.y do innej wersji podrzędnej (na przykład Drupal 7.54 do 7.59).

Uwaga:

  • Ta procedura powoduje tylko zaktualizowanie instalacji Drupal. Nie aktualizuje oprogramowania Apigee wysyłanego w ramach portalu. Więcej informacji o uaktualnianiu oprogramowania portalu Apigee znajdziesz w artykule Uaktualnianie portalu.

    Jeśli podczas uaktualniania Private Cloud (np. z 4.18.05 na 4.19.01) narzędzie aktualizacji Apigee faktycznie zmniejszy Twoją wersję Drupala, może być konieczne ponowne uruchomienie tego narzędzia. Więcej informacji znajdziesz w artykule o ponownym uruchamianiu uaktualnienia Drupal.

  • Polecenia Drush (Drupal Shell) musisz wykonać z katalogu głównego witryny portalu. Domyślnie portal jest instalowany tutaj:
    • /opt/apigee/apigee-drupal/wwwroot (Nginx)
    • /var/www/html (Apache)
    Poniższa procedura zakłada instalację serwera Nginx w domyślnej lokalizacji opisanej powyżej.

Określanie obecnej wersji Drupala

Zanim rozpoczniesz aktualizację Drupal, możesz sprawdzić używaną wersję, uruchamiając poniższe polecenie z folderu instalacyjnego Drupal. Drupal jest domyślnie instalowany w przeglądarce /opt/apigee/apigee-drupal/wwwroot:

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

Dane wyjściowe powinny mieć postać:

Drupal version          :  7.54

Jeśli zainstalowano Drupal w katalogu innym niż /opt/apigee/apigee-drupal/wwwroot, przed uruchomieniem polecenia drush przejdź do tego katalogu.

Aktualizowanie wersji Drupal

W tej sekcji opisaliśmy, jak aktualizować wersję Drupala przy użyciu poleceń Drush w wierszu poleceń. Zapoznaj się też z informacjami na temat aktualizowania serwisu Drupal za pomocą aplikacji Drush (Drupal.org).

Aby zaktualizować instalację Drupal:

  1. Przejdź do katalogu /opt/apigee/apigee-drupal/wwwroot lub katalogu, w którym zainstalowano portal.
  2. Utwórz pełną kopię zapasową wszystkich plików, katalogów i baz danych. Zapisz kopię zapasową w lokalizacji poza instalacją Drupala. Pełne instrukcje znajdziesz w artykule o tworzeniu kopii zapasowej portalu.

    Jeśli wprowadzisz zmiany w plikach, takich jak .htaccess, robots.txt lub defaults.settings.php (w katalogu sites), musisz je ponownie zastosować po zakończeniu aktualizacji. Musisz też ponownie zastosować wszystkie dostosowania wprowadzone w katalogu sites/all.

  3. Włącz tryb konserwacji witryny:
    drush vset --exact maintenance_mode 1
    drush cache-clear all
  4. Zainstaluj żądaną wersję Drupala, korzystając z tego polecenia:
    drush pm-update drupal-version

    Gdzie version to wymagana wersja.

    Możesz też uruchomić drush pm-update drupal, aby zaktualizować pakiet Drupal do najnowszej wersji. Możesz uruchomić drush pm-updatestatus, aby wyświetlić listę dostępnych mniejszych aktualizacji podstawowych i współtworzonych projektów Drupal.

  5. Zastosuj ponownie wszystkie zmiany wprowadzone w atrybutach .htaccess, robots.txt lub defaults.settings.php (w katalogu sites).
  6. Zastosuj ponownie wszystkie zmiany wprowadzone w katalogu sites/all .
  7. Wyłącz witrynę z trybu konserwacji:
    drush vset --exact maintenance_mode 0
    drush cache-clear all

Uaktualnij moduły Contrib PHP i Drupal

Gdy uaktualnisz Drupala, korzystając z podanych wyżej instrukcji z tej sekcji, uaktualnione zostaną również moduły używane w tej platformie, takie jak contrib i PHP. Między kolejnymi wersjami Private Cloud należy jednak śledzić najnowsze moduły Drupala.

Pamiętaj, że jeśli moduł jest w języku /profiles/apigee/modules/contrib, możesz zastąpić go nowszą wersją, zapisując nowszą wersję w usłudze /sites/all/modules/contrib. Edge dla chmury prywatnej używa nowszej wersji /sites/all/modules/contrib, a nie starszej wersji w /profiles/apigee/modules/contrib. Więcej informacji znajdziesz w artykule o aktualizowaniu modułów (Drupal.org).

Jeśli instalujesz nową wersję Private Cloud, która zawiera nowszą wersję modułu wcześniej zapisaną w usłudze /sites/all/modules/contrib, usuń moduł z /sites/all/modules/contrib. Więcej informacji znajdziesz w artykule o przenoszeniu modułów i motywów (Drupal.org).

Co się stanie, jeśli podczas aktualizacji napotkam problem?

Przywróć witrynę do poprzedniego stanu przy użyciu utworzonych przez siebie plików z kopią zapasową. Skontaktuj się z zespołem pomocy Apigee Edge i podaj komunikaty o błędach zgłoszone podczas aktualizacji.