Acquia의 지원

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

Apigee는 웹사이트 관리 서비스인 Acquia를 사용하여 개발자 서비스 포털의 클라우드 기반 버전을 호스팅합니다. Acquia는 Drupal과 연동하여 안전한 환경에서 포털을 개발, 테스트, 게시할 수 있도록 설계되었습니다.

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

Acquia Cloud 인터페이스 액세스

Acquia Cloud 계정이 설정된 후에는 Acquia Cloud 인터페이스(https://cloud.acquia.com/)를 통해 포털에 액세스할 수 있습니다.

처음 로그인하면 다음 그림과 같이 애플리케이션 페이지가 표시됩니다.

액세스 권한이 있고 Acquia Cloud에서 호스팅되는 모든 애플리케이션이 애플리케이션 페이지에 표시됩니다. 애플리케이션은 Drupal 기반 포털 사이트와 같이 Acquia Cloud에서 관리하는 소프트웨어 항목입니다.

다음 섹션에서는 Acquia Cloud 인터페이스를 사용하여 포털 콘텐츠를 관리하는 방법을 설명합니다.

Acquia Cloud 인터페이스에 대한 자세한 내용은 Acquia Cloud 문서의 Acquia Cloud 인터페이스에 로그인과 Acquia Cloud로 애플리케이션 관리를 참고하세요.

환경 관리

Acquia Cloud 인터페이스에 액세스하고 애플리케이션 페이지에서 포털 사이트와 연결된 관리를 클릭하여 대시보드에 액세스합니다.

워크플로를 관리하기 위해 다음 표에 설명된 대로 포털 개발, 테스트, 게시를 위한 세 가지 환경이 제공됩니다. 포털은 각 환경에 배포되지만 고유한 코드 브랜치 또는 태그, 데이터베이스 등이 포함된 다른 상태일 수 있습니다. 포털 환경에 코드 배포를 참조하세요.

환경	설명	기본 URL
개발	새로운 기능을 개발하고 포털을 맞춤설정하세요.	http://{application-name}xxxxxx.devcloud.acquia-sites.com/ 여기서 application-name은 애플리케이션의 이름이고 xxxxxx는 Dev와 Stage를 구분하는 데 사용되는 고유한 문자열입니다.
단계	최신 코드를 프로덕션 환경에 푸시하기 전에 테스트합니다.	http://{application-name}yyyyyy.devcloud.acquia-sites.com/ 여기서 application-name은 애플리케이션의 이름이고 yyyyyy는 Dev와 Stage를 구분하는 데 사용되는 고유한 문자열입니다.
프로덕션	포털을 프로덕션 (실시간)에 게시합니다.	http://{application-name}.devcloud.acquia-sites.com/ 여기서 application-name은 애플리케이션의 이름입니다. 참고: 커스텀 도메인 구성도 참조하세요.

자세한 내용은 Acquia Cloud 문서의 환경 작업을 참조하세요.

포털 개발

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

• Git 저장소 개요
• 코드 액세스
• 포털 환경에 코드 배포
• 맞춤 모듈 및 테마 추가
• Drupal 프로필 모듈 및 테마 재정의

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

원하는 작업	개발자는	추가 정보
사이트 디자인 변경	기본 - 포털 사이트의 디자인 메뉴 항목을 사용하여 로고 및 사이트 색상 수정과 같은 변경을 할 수 있습니다.	모양 맞춤설정을 참고하세요.
	고급 - 사이트의 전체 디자인과 분위기를 수정하려면 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에서 코드 저장소에 액세스하려면 다음 섹션에 설명된 작업을 실행해야 합니다.

• 서버에 SSH 액세스 사용 설정
• Git에서 코드 저장소에 액세스

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

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

Git을 사용하여 Drupal 코드를 관리하려면 먼저 SSH를 사용 설정하여 서버에 액세스해야 합니다. 자세한 내용은 Acquia Cloud 문서에서 SSH 액세스 사용 설정을 참조하세요.

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

1. https://accounts.acquia.com에서 Acquia Accounts 인터페이스에 로그인합니다.
2. 사용자 인증 정보를 클릭합니다.
3. 메시지가 표시되면 비밀번호를 다시 입력하여 신원을 확인합니다.
4. SSH 키 아래에서 SSH 키 추가를 클릭합니다.
5. 다음 정보를 입력합니다.

   필드	설명
   닉네임	SSH 키의 닉네임입니다. 닉네임에는 영숫자 문자와 밑줄을 포함할 수 있습니다.
   공개 키	공개 키입니다. SSH 공개 키 생성에 대한 자세한 내용은 Acquia Cloud 문서의 SSH 공개 키 생성을 참조하세요.

6. 키 추가를 클릭합니다.

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

Git 저장소에는 포털 사이트의 모든 코드가 포함됩니다. 새 코드를 추가하거나 기존 코드를 맞춤설정하여 포털을 구성할 수 있습니다. 자세한 내용은 Acquia Cloud 문서의 코드 저장소 사용을 참조하세요.

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

1. https://cloud.acquia.com/에서 Acquia Cloud 인터페이스에 로그인합니다.
2. 애플리케이션 페이지에서 관리를 클릭하여 포털의 세부정보를 봅니다.
3. 탐색 메뉴에서 애플리케이션 정보를 클릭합니다.

   

4. 애플리케이션 정보 대화상자에서 클론 명령어를 복사합니다.
5. 다음 Git 명령어 중 하나를 실행하여 Git 저장소를 로컬 환경으로 클론합니다.

   Git 저장소를 클론하고 새 브랜치를 만들려면 다음 안내를 따르세요.

   > git clone --branch [branch] myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]

   master 브랜치에서 Git 저장소를 클론하려면 다음 안내를 따르세요.

   > git clone myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]

6. 애플리케이션 창에 표시된 관련 명령어를 사용하여 변경사항을 스테이징, 커밋, Git 저장소에 푸시할 준비가 되면 이 단계를 반복합니다.
   

   브랜치를 저장소에 커밋하면 Acquia Cloud가 해당 코드 브랜치를 실행하는 환경을 업데이트합니다. 다음 섹션의 설명대로 포털 환경에 코드를 배포할 수 있습니다.

포털 환경에 코드 배포

포털 환경에서 코드를 배포, 전환 또는 되돌리거나, 환경 간에 코드를 이동하거나, 저장소 구조 및 권장 워크플로에 대해 자세히 알아보려면 Acquia Cloud 문서의 Aquia Cloud에서 사이트 작업을 참조하세요. 환경에 새 코드를 배포할 때는 update.php를 실행하여 필요한 데이터베이스 업데이트를 수행해야 합니다.

맞춤 모듈 및 테마 추가

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

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

모듈/테마	Git 저장소의 폴더	추가 정보 (Drupal 문서)
커스텀 모듈	sites/all/modules/custom	커스텀 모듈 생성
맞춤 테마	sites/all/themes	테마 맞춤설정 Drual 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에서 유지관리하는 프로필 테마를 사용하려면 이 폴더에 추가한 중복 모듈을 삭제하세요.

SSL 사용 설정

HTTPS를 사용하여 사이트에 안전하게 액세스하려면 SSL을 사용 설정해야 합니다.

SSL을 사용 설정하려면 다음 안내를 따르세요.

1. 인증 기관 (CA) 또는 SSL 인증서 공급업체에서 SSL 인증서를 가져옵니다. SSL 사용 설정을 참조하세요.
2. Acquia Cloud 인터페이스의 SSL 페이지에서 SSL 인증서를 업로드합니다. SSL 인증서 관리를 참조하세요.

프로덕션 환경 보안

애플리케이션을 처음 만들 때 프로덕션 환경을 자유롭게 관리하고 개발 및 스테이징 환경에서 변경사항을 전파할 수 있습니다. 콘텐츠를 게시한 후에는 콘텐츠에 대한 무단 또는 실수로 인한 업데이트를 방지하기 위해 프로덕션 환경을 잠그는 것이 좋습니다. 자세한 내용은 Acquia Cloud 문서의 프로덕션 모드를 사용하여 실시간 애플리케이션 보호를 참조하세요.

프로덕션 환경을 보호하려면 다음 안내를 따르세요.

1. https://cloud.acquia.com/에서 Acquia Cloud 인터페이스에 로그인합니다.
2. 애플리케이션 페이지에서 관리를 클릭하여 포털 사이트의 세부정보를 봅니다.
3. Prod를 클릭하여 프로덕션 환경 세부정보를 확인합니다.
4. 탐색 메뉴에서 프로덕션 모드를 클릭합니다.
5. 사용 설정을 클릭하여 프로덕션 모드를 사용 설정합니다.

포털에 모듈 및 테마 업데이트 적용

Apigee는 주기적으로 포털의 모듈과 테마를 최신 버전으로 자동 업데이트합니다. Dev 환경만 업데이트되며 다른 포털 환경으로 이전해야 함을 나타내도록 태그가 지정됩니다.

사이트가 Apigee Acquia 결제 조직에 속하지 않은 경우 (예: 다른 호스팅 업체에서 내 조직으로 새 사이트를 마이그레이션한 새 사이트) 자동화된 Devportal 업데이트 푸시를 받으려면 Apigee가 Git 저장소에 액세스하도록 허용해야 합니다. 자세한 내용은 Apigee 지원팀에 문의하세요.

맞춤 모듈이나 테마를 추가한 경우 수동으로 업데이트해야 합니다.

다음 표에는 모듈 및 테마 업데이트를 포털에 적용하는 데 필요한 단계가 요약되어 있습니다.

모듈/테마	설명
Apigee Edge 모듈	Apigee는 개발 환경에만 업데이트를 자동으로 적용합니다. 업데이트를 테스트한 후 포털 환경에 코드 배포에 설명된 대로 개발에서 단계, 프로덕션 환경으로 업데이트를 마이그레이션합니다.
Apigee 반응형 테마	Apigee는 개발 환경에만 업데이트를 자동으로 적용합니다. 업데이트를 테스트한 후 포털 환경에 코드 배포에 설명된 대로 개발에서 단계, 프로덕션 환경으로 업데이트를 마이그레이션합니다.
Drupal 핵심 모듈 및 기여 모듈	Apigee는 개발 환경에만 업데이트를 자동으로 적용합니다. 업데이트를 테스트한 후 포털 환경에 코드 배포에 설명된 대로 개발에서 단계, 프로덕션 환경으로 업데이트를 마이그레이션합니다.
맞춤 모듈 및 테마	맞춤 모듈 및 테마 추가에 설명된 대로 포털에 맞춤 모듈과 테마를 추가한 경우 업데이트를 수동으로 설치해야 합니다. 수동으로 또는 Drush를 사용하여 최신 버전을 로컬 디렉터리에 다운로드합니다. 그런 다음 업데이트를 스테이징, 커밋, Git 저장소에 푸시합니다. 업데이트를 테스트한 후 포털 환경에 코드 배포에 설명된 대로 개발에서 단계, 프로덕션 환경으로 업데이트를 마이그레이션합니다.

맞춤 기능 이전

포털에 커스텀 코드나 구성을 추가하는 경우에는 이를 유지관리하고 Dev에서 Stage, Prod 환경으로 이전해야 합니다.

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

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

메서드	설명
코드로 구성 내보내기	많은 일반적인 구성은 기능 모듈을 사용하여 코드로 '내보낼 수' 있습니다. 예를 들어 뷰, 패널, 이미지 캐시 등이 있습니다.
hook_update_N() 함수 구현	Drupal은 hook_update_N() 함수를 사용하여 데이터베이스 및 구성 변경사항을 관리합니다. 커스텀 모듈이 있는 경우 다음을 수행할 수 있습니다. 모듈의 .install 파일에 hook_update_N() 함수를 추가하여 변경사항을 처리합니다. 코드와 함께 이러한 변경사항을 배포합니다. update.php를 실행하여 스테이지 및 프로덕션 환경의 변경사항을 마이그레이션합니다.

커스텀 도메인 구성

환경 관리의 설명대로 포털 환경의 기본 도메인 이름은 모두 acquia-sites.com로 끝납니다. 사이트의 목적을 맞춤설정하고 더 정확하게 전달하는 자체 커스텀 도메인 이름을 제공하는 것이 좋습니다. 예를 들어 일반적인 대안은 다음과 같습니다.

https://developers.mycompany.com

커스텀 도메인을 구성하려면 다음 안내를 따르세요.

1. 포털 사이트 환경에 도메인을 추가합니다. Acquia Cloud 문서의 도메인 관리를 참조하세요.
2. 도메인 이름의 DNS 레코드 항목이 acquia-sites.com 도메인이 아닌 공개 IP 주소를 가리키도록 설정하여 DNS 제공업체를 통해 커스텀 도메인을 설정합니다. Acquia Cloud 문서에서 DNS 레코드가 공개 IP 주소를 가리키도록 지정을 참조하세요.

   참고: 도메인 이름의 CNAME 항목을 acquia-sites.com 도메인으로 설정하지 마세요. 이렇게 하면 포털 사이트에 지연 시간 문제 또는 다운타임이 발생할 수 있습니다.

Acquia Insight를 사용하여 포털 모니터링

Acquia Insight는 성능, 보안, 검색엔진 최적화를 모니터링하여 포털 사이트를 최적화할 수 있는 도구 모음입니다. 자세한 내용은 Acquia Insight를 참고하세요.

포털 백업

다음 표에는 포털 구성요소를 백업하는 데 사용할 수 있는 옵션이 요약되어 있습니다.

구성요소	백업 세부정보	Acquia Cloud 문서에서 추가 정보
코드	코드는 버전 제어 시스템에 의해 관리되며 커밋할 때마다 태그가 지정됩니다. 언제든지 특정 태그로 동기화하거나 되돌릴 수 있습니다.	코드 백업
데이터베이스	일일 백업은 3일 동안 수행되고 유지보수됩니다. 자동 및 주문형 백업을 예약합니다. 모든 데이터의 내부 재해 스냅샷은 매시간 만들어집니다.	데이터베이스 백업 예약된 작업을 사용하여 애플리케이션 유지관리
Files	수동 백업을 수행하거나 크론 작업을 예약합니다.	파일 백업 예약된 작업을 사용하여 애플리케이션 유지관리
전체 애플리케이션	Drush를 사용하여 수동 백업을 실행합니다.	전체 애플리케이션 백업 예약된 작업을 사용하여 애플리케이션 유지관리
Drupal 파일 시스템	다음 옵션 중 하나를 사용하여 수동 백업을 수행합니다. FTP 클라이언트 또는 명령줄 도구 (rsync 및 scp)를 사용하여 파일을 복사합니다. Drush를 사용하여 압축된 보관 파일을 만듭니다. 참고: 백업 및 마이그레이션 모듈은 Acquia Cloud에서 지원되지 않습니다. 자세한 내용은 Acquia Cloud에서 백업 및 마이그레이션 모듈이 지원되지 않음을 참고하세요.	Drual 파일 시스템 백업 예약된 작업을 사용하여 애플리케이션 유지관리

활동 알림 보기

활동 알림을 확인하여 설치 또는 환경 간에 코드 설치 또는 복사, 데이터베이스 업데이트 및 백업, 서버 변경 등 포털 사이트에서 발생하는 중요한 작업을 추적할 수 있습니다. 자세한 내용은 Acquia Cloud 문서의 활동 알림 보기를 참조하세요.

알림 목록을 보려면 다음 단계를 따르세요.

1. https://cloud.acquia.com/에서 Acquia Cloud 인터페이스에 로그인합니다.
2. 애플리케이션 페이지에서 관리를 클릭하여 포털 사이트의 세부정보를 확인합니다.
3. 탐색 메뉴의 오른쪽 상단에 있는 종 모양 아이콘을 클릭하여 최근 알림을 확인합니다.

   

4. 알림 옆에 있는 화살표를 클릭하면 활동에 대한 자세한 정보를 볼 수 있습니다.

상태 업데이트 구독

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

Acquia 상태 업데이트를 구독하면 서비스 중단, 긴급 유지보수 또는 플랫폼 보안 업데이트에 대한 알림을 받을 수 있습니다. Acquia Cloud 업데이트를 구독하려면 다음 안내를 따르세요.

1. 획득 상태 페이지로 이동합니다.
2. 업데이트 구독을 클릭합니다.
3. 이메일, SMS 등 업데이트를 받는 데 사용할 방법을 선택합니다.
4. 알림 페이지에서 상태 업데이트를 받을 제품을 선택합니다. 예: Acquia Cloud Enterprise
5. 환경설정 업데이트를 클릭합니다.