Pantheon 작업

현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동
정보

Apigee는 웹사이트 관리 서비스인 Pantheon을 사용하여 개발자 서비스 포털의 클라우드 기반 버전을 호스팅합니다. Pantheon은 Drupal과 호환되어 안전한 환경에서 포털을 개발, 테스트, 게시할 수 있도록 설계되었습니다. Pantheon의 웹사이트 관리 서비스는 호스팅 및 개발 작업을 필요로 하는 전 세계의 고객에게 제공됩니다.

다음 섹션에서는 Pantheon을 사용하여 포털을 개발하고 관리하는 방법을 설명합니다.

Pantheon 대시보드 액세스

Apigee에서 포털의 URL을 전송하면 Pantheon 대시보드의 URL(https://dashboard.getpantheon.com/)도 수신됩니다.

Pantheon 대시보드에 처음 로그인하면 아래와 같이 Sites 페이지로 이동합니다.

대시보드에서 사이트에 액세스하고, 계정을 구성하고, 기타 작업을 수행할 수 있습니다.

사이트의 이미지 (예: apigeedocs)를 선택하여 사이트의 대시보드를 엽니다.

환경 관리

Pantheon 대시보드 페이지 상단에는 개발, 테스트, 실시간의 세 가지 환경이 나열되어 있습니다. 다음 표에 각 항목이 설명되어 있습니다.

환경

설명

개발자

Dev 환경이 Git 저장소에 연결됩니다. Git에 푸시하는 모든 변경사항은 Dev 환경에 즉시 표시됩니다.

이 사이트의 URL은 아래 형식으로 되어 있으며, 여기에서 org_name은 조직의 이름입니다.

http://dev-{org_name}.devportal.apigee.io/

테스트

테스트 환경은 실시간 환경의 데이터 사본으로 최신 코드를 테스트하는 데 사용됩니다. 이 환경에서 코드 변경사항을 실제 환경에 푸시하기 전에 테스트합니다.

이 사이트의 URL은 아래 형식으로 되어 있으며, 여기에서 org_name은 조직의 이름입니다.

http://test-{org_name}.devportal.apigee.io/

Live

실시간 환경은 고객이 액세스할 수 있도록 설정하는 프로덕션 환경입니다.

이 사이트의 URL은 아래 형식으로 되어 있으며, 여기에서 org_name은 조직의 이름입니다.

http://live-{org_name}.devportal.apigee.io/

포털 콘텐츠 개발

다음 섹션에서는 포털 콘텐츠를 개발하는 방법을 설명합니다.

또한 포털 맞춤설정에 대한 자세한 내용은 다음 섹션을 참조하세요.

원하는 작업

개발자는

추가 정보

사이트 디자인 변경

기본 - 포털 사이트의 디자인 메뉴 항목을 사용하여 로고 및 사이트 색상 수정과 같은 변경을 할 수 있습니다.

모양 맞춤설정을 참고하세요.

고급 - 사이트의 전체 디자인과 분위기를 수정하려면 Apigee 반응형 테마를 확장하세요.

테마 맞춤설정을 참고하세요.

사이트 기능의 동작 변경

기본 - 포털의 관리자 설정을 사용하여 사이트 동작 방식을 변경/구성합니다.

Apigee 문서 보기(자세한 내용은 여기 참조)

고급 - 맞춤 모듈을 만들어 사이트의 동작을 변경합니다.

Drupal 문서에서 커스텀 모듈 만들기를 참고하세요.

Git 저장소 개요

Drupal 코드의 Git 저장소에는 모든 포털 코드가 포함되며 다음 구조로 구성됩니다.

참고: /sites/all 디렉터리의 콘텐츠만 수정하세요. /sites/all 디렉터리 외부의 콘텐츠를 수정하는 경우 새 버전으로 업그레이드할 때 문제가 발생하고 Git의 변경사항을 확인할 때 병합 충돌이 발생할 수 있습니다.

Git 저장소의 폴더

설명

/profiles/apigee

Apigee에서 유지관리하는 모듈과 테마는 다음과 같습니다.

  • /profiles/apigee/modules/contrib: Apigee에서 유지관리하는 Drupal contrib 모듈입니다.
  • /profiles/apigee/themes/contrib: Apigee에서 유지관리하는 Drupal contrib 테마
  • /profiles/apigee/modules/custom: Apigee에서 만든 커스텀 모듈
  • /profiles/apigee/themes/custom: Apigee에서 만든 커스텀 테마

참고: /profiles/apigee 디렉터리의 콘텐츠를 수정하면 새 버전으로 업그레이드할 때 문제가 발생하고 Git에 변경사항을 검사할 때 병합 충돌이 발생할 수 있습니다. Drupal 권장사항은 코어 해킹 금지를 참고하세요.

/sites/all

맞춤 Drupal 모듈 및 테마 이 폴더의 콘텐츠 관리에 관한 자세한 내용은 맞춤 모듈 및 테마 추가Drupal 프로필 모듈 및 테마 재정의를 참고하세요.

참고: /sites/all 디렉터리 내의 콘텐츠만 수정하세요.

코드 액세스

Git에서 코드 저장소에 액세스하려면 다음 섹션에 설명된 작업을 실행해야 합니다.

Drupal 7 개발자 포털 소스 코드에 액세스하려면 어떻게 해야 하나요?도 참고하세요.

서버에 대한 SSH 액세스 사용 설정

Git을 사용하여 Drupal 코드를 관리하려면 먼저 SSH 키를 Pantheon에 업로드하여 SSH가 서버에 액세스하도록 사용 설정해야 합니다.

서버에 대한 SSH 액세스를 사용 설정하려면 다음 안내를 따르세요.

  1. https://dashboard.getpantheon.com/에서 Pantheon에 로그인합니다.
  2. 대시보드에서 계정을 선택합니다.
  3. 왼쪽 메뉴에서 SSH 키를 선택합니다.
  4. 키를 추가하고 키 추가를 선택합니다.
    도움이 필요하면 SSH 키 생성 방법 알아보기 링크를 선택하세요.

Git에서 코드 저장소에 액세스

참고: Git 저장소 구조에 대한 개요는 Git 저장소 개요를 참고하세요.

Git에서 코드 저장소에 액세스하려면 다음 안내를 따르세요.

  1. Pantheon 대시보드에 로그인합니다.
  2. 기본 사이트 페이지에서 포털 아이콘을 선택합니다.
  3. Git 저장소의 URL은 이전 그림에 표시된 것처럼 Connection Mode 오른쪽 페이지에 나타납니다.
  4. Git 저장소의 URL을 복사하고 다음 명령어를 사용하여 로컬 개발 환경에 클론합니다.
    > git clone gitURL sitename
    예:
    > git clone ssh://codeserver.dev.12@codeserver.dev.12.drush.in:2222/~/repository.git devportal

Git 저장소에 푸시하는 모든 코드 변경사항은 포털의 개발 환경에 즉시 표시됩니다.

포털 환경에 코드 배포

포털 환경에 코딩하려면 다음 안내를 따르세요.

  1. 코드 업데이트를 Git에 푸시하면 Dev 환경이 즉시 업데이트됩니다.
  2. Pantheon에 로그인하고 사이트를 선택합니다.
  3. Dev 환경을 선택합니다.
  4. 왼쪽 메뉴에서 </>Code를 선택하여 커밋 로그에서 코드 변경에 대한 메시지를 확인합니다.
  5. 페이지 상단에서 테스트 환경을 선택합니다.
    1. DevTest에 아직 업로드하지 않았다면 지금 업로드하라는 메시지가 표시됩니다.
    2. 이미 Test 환경이 있다면 Dev에서 배포할 준비가 된 커밋이 있음을 나타내는 메시지가 표시됩니다.
  6. 이미 사이트를 실시간 환경에 푸시한 경우 세 번째 체크박스를 선택하여 실시간 데이터베이스 및 개발자가 업로드한 모든 파일을 복사하여 Live에서 테스트할 수 있습니다. 실시간에서 제공되는 최신 데이터를 기준으로 코드 변경사항을 테스트하려는 경우에 유용합니다.
  7. 배포에서 코드 배포 버튼을 선택합니다.
  8. 테스트 환경에서 포털을 테스트합니다.
  9. Dev 환경의 코드를 수정하고 파일을 다시 테스트에 푸시하여 테스트합니다.
  10. 테스트가 완료되면 페이지 상단에서 실시간 환경을 선택합니다.
    1. TestLive에 아직 업로드하지 않았다면 지금 업로드하라는 메시지가 표시됩니다.
    2. 실시간 환경이 이미 있다면 배포할 준비가 된 Test의 커밋이 있음을 나타내는 메시지가 표시됩니다. Dev에서 Test에 변경사항을 배포한 것과 동일한 방식으로 이러한 변경사항을 배포합니다. 테스트가 완료되면 코드를 실시간 환경에 푸시합니다.

자세히 알아보기:

  • Pantheon은 이 프로세스에 관한 실시간 스트리밍 기사 모음을 제공하며 여기에서 확인할 수 있습니다. 가장 중요한 것 중 하나는 사이트를 개발, 테스트, 푸시하는 방법에 관한 개요를 제공하는 Pantheon 워크플로 사용 문서입니다.

맞춤 모듈 및 테마 추가

다음 표에 나열된 폴더에 고유한 맞춤 모듈과 테마를 추가하여 포털의 기능을 확장할 수 있습니다.

참고: /sites/all 디렉터리 내의 콘텐츠만 수정하세요. /sites/all 디렉터리 외부의 콘텐츠를 수정하는 경우 Git 변경사항을 확인할 때 병합 충돌이 발생할 수 있습니다.

모듈/테마 Git 저장소의 폴더 추가 정보 (Drupal 문서)
커스텀 모듈 sites/all/modules/custom 커스텀 모듈 생성
맞춤 테마 sites/all/themes 테마 맞춤설정
Drupal 7 테마 설정

개발자 환경에서 커스텀 모듈이나 테마를 추가한 후에는 포털 환경에 코드 배포에 설명된 대로 테스트를 위해 테스트에 배포하고 프로덕션의 경우 라이브 환경에 배포할 수 있습니다.

Drupal 프로필 모듈 및 테마 재정의

다음 디렉터리의 모듈과 테마는 /profiles/apigee의 Apigee에서 유지관리 및 배포하는 Drupal 프로필 모듈과 테마를 재정의합니다. Git 저장소 개요를 참조하세요.

예를 들어 다음 시나리오에서는 Apigee Drupal 배포의 모듈을 재정의할 수 있습니다.

  • 특정 모듈의 다른 버전을 사용하려는 경우.
  • 예정된 다음 Apigee 출시 전에 보안 업데이트를 구현하려고 합니다.
모듈/테마 Git 저장소의 폴더 추가 정보 (Drupal 문서)
Drupal 참여 모듈

sites/all/modules/contrib

참고: /sites/all/modules 아래에 저장된 모듈은 Apigee Drupal 배포 모듈을 재정의합니다.

참여 모듈

참고: 이 디렉터리의 Drupal 제공 모듈은 /profiles/apigee/modules의 Apigee에서 유지관리하고 배포하는 상응하는 모듈을 재정의합니다. Apigee에서 유지관리하는 Drupal 프로필 모듈을 사용하려면 이 폴더에 추가한 중복 모듈을 삭제하세요.

Drupal 참여 테마 sites/all/themes 참여한 주제

참고: 이 디렉터리의 Drupal 제공 테마는 /profiles/apigee/themes의 Apigee에서 유지관리 및 배포하는 상응하는 모듈을 재정의합니다. Apigee에서 유지관리하는 프로필 테마를 사용하려면 이 폴더에 추가한 중복 모듈을 삭제하세요.

settings.php 파일 정보

Drupal settings.php은 Apigee Drupal 개발자 포털 업스트림 Git 저장소에 커밋됩니다. sites/default/settings.php 파일을 변경하려면 파일을 직접 수정하지 마세요. 대신 sites/default/settings.local.php라는 파일을 만들고 여기에 커스텀 코드를 삽입합니다. sites/default/settings.local.phpsettings.php 파일에 포함됩니다.

예를 들어 Pantheon에서 제공한 안내에 따라 라이브 사이트의 맞춤 도메인을 설정할 때 settings.php 파일을 직접 수정하는 대신 sites/default/settings.local.php에 필수 업데이트를 추가합니다.

포털 보안

개발, 테스트, 라이브 환경과 연결된 포털 사이트는 기본적으로 공개적으로 액세스할 수 있습니다. 즉, 사이트 URL이 있으면 누구나 계정에 액세스할 수 있지만 계정을 등록하거나 사이트에 로그인하지 못할 수도 있습니다. 사용자 등록을 제어하는 방법에 관한 자세한 내용은 사용자 계정 추가 및 관리를 참고하세요.

개발테스트 사이트는 공개하지 않고 개발을 완료할 때까지 실시간 사이트를 숨기는 것이 좋습니다. Pantheon을 사용하면 사용자 이름/비밀번호 제어를 추가하여 적절한 사용자 인증 정보를 가진 사람만 액세스할 수 있도록 사이트를 잠글 수 있습니다.

환경의 왼쪽 메뉴에서 보안을 선택하여 세 환경 중 하나에 잠금을 추가합니다. 자세한 내용은 사이트 잠그기를 참조하세요.

사이트에 TLS/SSL을 사용 설정하려면 포털에서 TLS 사용을 참고하세요.

포털에 Apigee 업데이트 적용

Apigee가 포털의 새 출시 버전을 게시하면 Pantheon 대시보드에 메시지가 표시됩니다.

일반적으로 업데이트를 Dev 환경에 적용하고 자체 코드 변경사항을 테스트하는 것과 동일한 방식으로 이러한 변경사항을 테스트합니다. 예를 들어 Dev 환경을 Test에 푸시하고 실시간 데이터를 Live에서 Test로 푸시한 다음 업데이트를 테스트합니다.

업데이트를 적용하려면 다음 단계를 따르세요.

  1. https://dashboard.getpantheon.com/에서 Pantheon에 로그인하고 사이트를 선택합니다.
  2. Dev 환경을 선택합니다.
  3. 왼쪽에서 </>Code 메뉴 항목을 선택합니다. 사용 가능한 Apigee 업데이트가 있으면 나열됩니다.
  4. 다음과 같이 업데이트를 적용합니다.
    1. 코드 가져오기 후 update.php 실행 체크박스를 선택합니다.
    2. 사용 가능한 경우 코드 가져오기 후 캐시 삭제 체크박스를 선택합니다.
    3. 코드 배포 버튼을 선택합니다.
  5. 업데이트가 완료되면 대시보드 왼쪽에 있는 상태 메뉴 항목을 선택합니다.
  6. 환경의 상태 영역에서 아래와 같이 데이터베이스 업데이트 오류를 확인할 수 있습니다.

    환경에서 이 오류가 발생하면 데이터베이스를 수동으로 업데이트하세요.

    1. 관리자 또는 콘텐츠 생성 권한이 있는 사용자로 포털에 로그인합니다.
    2. 포털 왼쪽 상단에 있는 홈 아이콘 > 업데이트 실행을 선택합니다.
    3. 안내에 따라 데이터베이스를 업데이트합니다.
  7. 위에서 설명한 대로 코드 변경사항을 테스트 환경에 푸시한 다음 실시간에 푸시합니다.

맞춤 기능 이전

포털에 커스텀 코드 또는 기능을 추가하는 경우 유지보수 방법과 이를 개발에서 테스트, 라이브 환경으로 이동하는 방법을 결정해야 합니다.

Git 저장소 코드의 경우 포털 환경에 코드 배포에 설명된 프로세스에 따라 코드를 개발에서 테스트, 라이브로 마이그레이션할 수 있습니다.

커스텀 구성을 만든 경우 다음 방법 중 하나를 사용하여 이를 마이그레이션합니다.

메서드 설명
코드로 구성 내보내기 많은 일반적인 구성은 기능 모듈을 사용하여 코드로 '내보낼 수' 있습니다. 예를 들어 뷰, 패널, 이미지 캐시 등이 있습니다.
hook_update_N() 함수 구현 Drupal은 hook_update_N() 함수를 사용하여 데이터베이스 및 구성 변경사항을 관리합니다.

커스텀 모듈이 있는 경우 다음을 수행할 수 있습니다.

  • 모듈의 .install 파일에 hook_update_N() 함수를 추가하여 변경사항을 처리합니다.
  • 코드와 함께 이러한 변경사항을 배포합니다.
  • update.php를 실행하여 스테이지 및 프로덕션 환경의 변경사항을 마이그레이션합니다.

사이트를 개발, 테스트, 푸시하는 방법의 개요를 제공하는 Pantheon 워크플로 사용도 참고하세요. 이 문서에는 구성 관리에 관한 섹션이 포함되어 있습니다.

커스텀 도메인 구성

Apigee가 포털에 제공하는 도메인 이름의 기본값은 환경 관리에 설명된 대로 apigee.io이며, 이는 고객에게 노출하는 것이 아닐 수도 있습니다.

유료 포털 요금제는 포털에 커스텀 도메인 이름을 구성할 수 있습니다 (개발자 또는 무료 계정은 커스텀 도메인을 만들 수 없음). 커스텀 도메인을 사용하려면 DNS에 CNAME을 만들고 도메인이 edge.apigee.getpantheon.com을 가리킵니다.

예를 들어 Mytech라는 회사의 커스텀 도메인을 구성하려면 다음 안내를 따르세요.

  1. 다음 DNS 설정을 구성합니다.
    developer.mytech.com. 3600 IN CNAMEedge.apigee.getpantheon.com
    DNS 변경사항이 모든 클라이언트 기기에 적용되는 데 최대 48시간이 걸릴 수 있습니다.
  2. 대시보드 왼쪽에 있는 도메인 / SSL 메뉴 항목을 사용하여 이 도메인을 라이브 환경 전용 Pantheon 대시보드에 추가합니다.
    대부분의 경우 DNS는 개발테스트가 아닌 라이브 환경에만 구성합니다. 프로덕션에 Dev 또는 Test 환경을 사용해서는 안 됩니다.

자세한 내용은 여기에서 Pantheon 문서를 참고하세요.

포털 관리자 추가

Apigee로부터 포털이 준비되었다는 이메일을 받으면 Apigee에서 이미 포털 관리자 목록을 구성한 것입니다. 사이트 대시보드의 오른쪽 상단에 있는 링크를 선택하면 해당 목록을 볼 수 있습니다.

관리자를 추가하려면 관리자 만들기를 참고하세요.

포털 백업

포털을 백업하려면 Pantheon 대시보드의 Backups 탭을 사용하세요. 주문형 또는 자동 백업을 만들 수 있습니다. Pantheon에서 백업은 데이터베이스, 파일, 코드라는 세 가지 개별 보관 파일로 구성됩니다.

자세한 내용은 Pantheon 문서의 백업 도구를 참고하세요.

상태 업데이트 구독

status.apigee.com에서 Apigee 출시 버전 및 상태 업데이트를 구독할 수 있습니다. 업데이트 구독을 클릭하고 메시지가 표시되면 이메일 주소와 같은 연락처 정보를 입력한 후 구독을 클릭합니다. 이메일 알림 관리 페이지에서 개발자 포털이 선택되었는지 확인하고 필요에 따라 다른 알림 설정을 전환한 후 환경설정 업데이트를 클릭합니다.

http://status.getpantheon.com에서 Pantheon 상태 업데이트와 서비스 중단 등 이슈 보고서를 구독할 수 있습니다. 가입하려면 업데이트 구독을 클릭하세요.