Drupal 업그레이드

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

Drupal 코어 업그레이드

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

다음에 유의하세요.

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

    프라이빗 클라우드 업그레이드 중에 (예: 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

Drupal을 /opt/apigee/apigee-drupal/wwwroot이 아닌 다른 디렉터리에 설치한 경우 이 디렉터리로 변경한 후 drush 명령어를 실행해야 합니다.

Drupal 버전 업데이트

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

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

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

    sites 디렉터리에 있는 .htaccess, robots.txt, defaults.settings.php와 같은 파일을 수정한 경우 업데이트 후 변경사항을 다시 적용해야 합니다. 또한 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. sites 디렉터리의 .htaccess, robots.txt 또는 defaults.settings.php에 적용된 변경사항을 다시 적용합니다.
  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에 최신 버전을 저장하여 모듈의 최신 버전으로 대체할 수 있습니다. Private Cloud용 Edge는 /profiles/apigee/modules/contrib의 이전 버전이 아닌 /sites/all/modules/contrib의 최신 버전을 사용합니다. 자세한 내용은 모듈 업데이트 (Drupal.org)를 참고하세요.

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

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

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