Drupal 업그레이드

Apigee Developer Services 포털 (또는 간단히 포털)의 프라이빗 클라우드용 Edge 설치에서 새 버전의 Drupal을 사용할 수 있다는 알림이 표시될 수 있습니다. 새 버전은 Drupal 기능 출시, 패치, 보안 업데이트 또는 다른 유형의 Drupal 업데이트를 의미할 수 있습니다. 보안 업데이트의 경우 사이트의 보안을 유지하기 위해 가능한 한 빨리 Drupal 설치를 업그레이드해야 합니다.

Drupal 코어 업그레이드

아래 절차에서는 Drupal 7.x.y의 프라이빗 클라우드 설치를 다른 마이너 버전 (예: Drupal 7.54에서 7.59로)으로 업데이트하는 방법을 설명합니다.

다음 사항을 참고하세요.

  • 이 절차는 Drupal 설치만 업데이트합니다. 포털의 일부로 제공되는 Apigee 소프트웨어는 업데이트되지 않습니다. Apigee 포털 소프트웨어 업그레이드에 대한 자세한 내용은 포털 업그레이드를 참조하세요.

    Private Cloud 업그레이드 중에 (예: 4.18.05에서 4.19.01로) Apigee 업데이트 유틸리티가 실제로 Drupal 버전을 다운그레이드하는 경우 Drupal 업그레이드 유틸리티를 다시 실행해야 할 수 있습니다. 자세한 내용은 Drupal 업그레이드 다시 실행을 참조하세요.

  • 포털 사이트의 루트 디렉터리에서 Drush(Drupal Shell) 명령어를 실행해야 합니다. 기본적으로 포털은 다음 위치에 설치됩니다.
    • /opt/apigee/apigee-drupal/wwwroot (Nginx)
    • /var/www/html (Apache)
    아래 절차에서는 위의 기본 위치에 Nginx 서버가 설치되어 있다고 가정합니다.

현재 Drupal 버전 확인

Drupal 업데이트를 시작하기 전에 Drupal 설치 폴더에서 다음 명령어를 실행하여 현재 Drupal 버전을 확인할 수 있습니다. 기본적으로 Drupal은 /opt/apigee/apigee-drupal/wwwroot에 설치됩니다.

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

다음과 같은 형식으로 출력이 표시됩니다.

Drupal version          :  7.54

/opt/apigee/apigee-drupal/wwwroot 이외의 디렉터리에 Drupal을 설치한 경우 drush 명령어를 실행하기 전에 해당 디렉터리로 변경해야 합니다.

Drupal 버전 업데이트

이 섹션에서는 명령줄에서 Drush 명령어를 사용하여 Drupal 버전을 업데이트하는 방법을 설명합니다. Drush를 사용하여 Drupal 업데이트 (Drupal.org)도 참조하세요.

Drupal 설치를 업데이트하려면 다음 안내를 따르세요.

  1. /opt/apigee/apigee-drupal/wwwroot 디렉터리 또는 포털을 설치한 디렉터리로 변경합니다.
  2. 모든 파일, 디렉터리, 데이터베이스를 전체 백업합니다. Drupal 설치 외부 위치에 백업을 저장합니다. 자세한 안내는 포털 백업을 참조하세요.

    .htaccess, robots.txt 또는 defaults.settings.php (sites 디렉터리)와 같은 파일을 수정한 경우 업데이트 후 변경사항을 다시 적용해야 합니다. 또한 sites/all 디렉터리에서 수행한 맞춤설정을 다시 적용해야 합니다.

  3. 사이트를 유지보수 모드로 전환합니다.
    drush vset --exact maintenance_mode 1
    drush cache-clear all
  4. 다음 명령어를 사용하여 원하는 Drupal 버전을 설치합니다.
    drush pm-update drupal-version

    여기서 version은 원하는 버전입니다.

    또는 drush pm-update drupal를 실행하여 최신 Drupal 코어 버전으로 업데이트할 수 있습니다. drush pm-updatestatus를 실행하여 Drupal 코어 및 contrib 프로젝트에 사용 가능한 마이너 업데이트를 나열할 수 있습니다.

  5. .htaccess, robots.txt 또는 defaults.settings.php (sites 디렉터리)에 적용된 변경사항을 다시 적용합니다.
  6. sites/all 디렉터리에 적용된 변경사항을 다시 적용합니다.
  7. 사이트의 유지보수 모드를 해제합니다.
    drush vset --exact maintenance_mode 0
    drush cache-clear all

PHP 및 Drupal contrib 모듈 업그레이드

이 섹션의 위 안내에 따라 Drupal을 업그레이드하면 contrib 및 PHP와 같이 Drupal에서 사용하는 모듈도 업그레이드됩니다. 하지만 프라이빗 클라우드 출시 버전 간에 최신 Drupal 모듈을 계속 사용해야 합니다.

모듈이 /profiles/apigee/modules/contrib에 있는 경우 최신 버전을 /sites/all/modules/contrib에 저장하여 해당 모듈의 최신 버전으로 대체할 수 있습니다. 프라이빗 클라우드용 Edge는 /profiles/apigee/modules/contrib의 이전 버전이 아닌 /sites/all/modules/contrib의 최신 버전을 사용합니다. 자세한 내용은 모듈 업데이트 (Drupal.org)를 참조하세요.

이전에 /sites/all/modules/contrib에 저장된 모듈의 최신 버전이 포함된 새 프라이빗 클라우드 버전을 설치하는 경우 /sites/all/modules/contrib에서 모듈을 삭제합니다. 자세한 내용은 모듈 및 테마 이동 (Drupal.org)을 참조하세요.

업데이트 중에 문제가 발생하면 어떻게 해야 하나요?

생성한 백업 파일을 사용하여 사이트를 이전 상태로 복원합니다. Apigee Edge 지원팀에 문의하고 업데이트 중에 보고된 오류 메시지를 제공합니다.