기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 사용자 지정 쿡북 설치
**중요**
이 AWS OpsWorks Stacks 서비스는 2024년 5월 26일에 수명이 종료되었으며 신규 및 기존 고객 모두에서 비활성화되었습니다. 가능한 한 빨리 워크로드를 다른 솔루션으로 마이그레이션하는 것이 좋습니다. 마이그레이션에 대한 질문이 있는 경우 [AWS re:Post](https://repost.aws/) 또는 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 문의하세요.
스택이 사용자 지정 쿡북을 설치하고 사용하도록 하려면 사용자 지정 쿡북을 활성화하도록 스택을 구성해야 합니다(아직 구성하지 않은 경우). 그런 다음 리포지토리 URL 및 암호 등 모든 관련 정보를 제공해야 합니다.
**중요**
사용자 지정 쿡북을 지원하도록 스택을 구성한 후 OpsWorks Stacks는 시작 시 모든 새 인스턴스에 쿡북을 자동으로 설치합니다. 그러나 사용자 지정 OpsWorks 쿡북 스택 업데이트 명령을 실행하여 기존 인스턴스에 새 쿡북 또는 업데이트된 쿡북을 설치하도록 Stacks에 명시적으로 지시해야 합니다. [****](workingstacks-commands.md) 자세한 내용은 [사용자 지정 쿡북 업데이트](workingcookbook-installingcustom-enable-update.md) 단원을 참조하십시오. 스택에서 **사용자 지정 Chef 쿡북 사용**을 활성화하기 전에, 실행 중인 사용자 지정 및 커뮤니티 쿡북이 스택에서 사용되는 Chef 버전을 지원하는지 확인해야 합니다.
**사용자 지정 쿡북에 맞게 스택을 구성하려면**
1. 스택 페이지에서 [**스택 설정**]를 클릭하여 스택의 [**설정**] 페이지를 표시하고 [**편집**]을 클릭하여 설정을 편집합니다.
1. [**사용자 지정 Chef 쿡북 사용**]을 [**예**]로 전환합니다.
![\[스택 설정 편집 페이지\]](http://docs.aws.amazon.com/ko_kr/opsworks/latest/userguide/images/stack_settings_edit.png)
1. 사용자 지정 쿡북을 구성합니다.
다 마치면 [**저장**]을 클릭하여 업데이트된 스택을 저장합니다.
## 사용자 지정 쿡북 리포지토리 지정
Linux 스택은 다음 리포지토리 유형의 사용자 지정 쿡북을 설치할 수 있습니다.
+ HTTP 또는 Amazon S3 아카이브.
아카이브는 퍼블릭이거나 프라이빗일 수 있지만 프라이빗 아카이브로는 일반적으로 Amazon S3가 선호됩니다.
+ Git 및 하위 버전 리포지토리는 소스 제어 및 다중 버전 기능을 제공합니다.
Windows 스택은 Amazon S3 아카이브와 Git 리포지토리의 사용자 지정 쿡북을 설치할 수 있습니다.
모든 리포지토리 유형에는 다음과 같은 필수 필드가 있습니다.
+ **리포지토리 유형** - 리포지토리 유형
+ **리포지토리 URL** - 리포지토리 URL
OpsWorks Stacks는 [GitHub](https://github.com/) 또는 Bitbucket과 같은 퍼블릭 호스팅 Git 리포지토리 사이트와 프라이빗 호스팅 Git 서버를 지원합니다. [https://bitbucket.org](https://bitbucket.org) Git 리포지토리의 경우, 리포지토리가 퍼블릭인지 프라이빗인지에 따라 다음 URL 형식 중 하나를 사용해야 합니다. Git 하위 모듈의 경우에도 같은 URL 지침을 따르십시오.
퍼블릭 Git 리포지토리의 경우, HTTPS 또는 Git 읽기 전용 프로토콜을 사용하세요.
+ Git 읽기 전용 – `git://github.com/amazonwebservices/opsworks-example-cookbooks.git`.
+ HTTPS – `https://github.com/amazonwebservices/opsworks-example-cookbooks.git`.
프라이빗 Git 리포지토리의 경우, 다음 예제에 나온 것처럼 SSH 읽기/쓰기 형식을 사용해야 합니다.
+ Github 리포지토리 – `git@github.com:project/repository`.
+ Git 서버의 리포지토리 – `user@server:project/repository`
나머지 설정은 리포지토리 유형에 따라 다르며, 다음 섹션에 설명되어 있습니다.
### HTTP 아카이브
**리포지토리 유형**으로 **HTTP 아카이브**를 선택하면 두 가지 추가 설정이 표시되며, 아카이브가 비밀번호로 보호되는 경우 이 설정을 완료해야 합니다.
+ **사용자 이름**—사용자 이름입니다
+ **암호**–사용자 암호
### Amazon S3 아카이브
**리포지토리 유형에** 대해 **S3 아카이브**를 선택하면 다음과 같은 추가 선택적 설정이 표시됩니다. OpsWorks Stacks는 Stacks API를 사용하든 콘솔을 사용하든 Amazon EC2 역할(호스트 운영 체제 관리자 인증)을 사용하여 OpsWorks 리포지토리에 액세스할 수 있습니다.
+ **액세스 키 ID** -와 같은 AWS 액세스 키 ID입니다AKIAIOSFODNN7EXAMPLE.
+ **보안 액세스 키** -와 같은 해당 AWS 보안 액세스 키입니다wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY.
### Git 리포지토리
**소스 제어**에서 **Git**을 선택하면 다음과 같은 추가 옵션 설정이 표시됩니다.
[**리포지토리 SSH 키**]
프라이빗 Git 리포지토리에 액세스하려면 배포 SSH 키를 지정해야 합니다. Git 하위 모듈의 경우, 지정된 키는 이러한 하위 모듈에 액세스할 권한이 있어야 합니다. 자세한 내용은 [Git 리포지토리 SSH 키 사용](workingapps-deploykeys.md) 단원을 참조하십시오.
SSH 키 배포에는 암호가 필요하지 않습니다. OpsWorks Stacks는 암호를 전달할 방법이 없습니다.
**브랜치/개정**
리포지토리에 여러 브랜치가 있는 경우 OpsWorks Stacks는 기본적으로 마스터 브랜치를 다운로드합니다. 특정 브랜치를 지정하려면 브랜치 이름, SHA1 해시 또는 태그 이름을 입력하세요. 특정 커밋을 지정하려면 완전한 40-hexdigit 커밋 ID를 입력합니다.
### 하위 버전 리포지토리
**소스 제어**에서 **하위 버전**을 선택하면 다음과 같은 추가 설정이 표시됩니다.
+ **사용자 이름** - 사용자 이름(프라이빗 리포지토리).
+ **암호** - 사용자 암호(프라이빗 리포지토리).
+ **리전** - [선택 사항] 여러 개정이 있는 경우, 개정 이름.
브랜치 또는 태그를 지정하려면 리포지토리 URL을 수정해야 합니다(예: **http://repository\$1domain/repos/myapp/branches/my-apps-branch** 또는 **http://repository\$1domain\$1name/repos/calc/myapp/my-apps-tag**).