지원 종료 알림: 2026년 10월 7일에 AWS 에 대한 지원이 종료됩니다 AWS Proton. 2026년 10월 7일 이후에는 AWS Proton 콘솔 또는 AWS Proton 리소스에 더 이상 액세스할 수 없습니다. 배포된 인프라는 그대로 유지됩니다. 자세한 내용은 [AWS Proton 서비스 사용 중단 및 마이그레이션 안내서](https://docs.aws.amazon.com/proton/latest/userguide/proton-end-of-support.html)를 참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 를 사용하여 설정 AWS Proton
AWS CLI 를 사용하여 AWS Proton APIs 실행하려면 설치했는지 확인합니다. 항목을 설치하지 않은 경우 [설정 AWS CLI](#ag-setting-up-cli)을 참조하세요.
**AWS Proton 특정 구성:**
+ **템플릿을 생성 및 관리하려면:**
+ [템플릿 동기화 구성](ag-template-sync-configs.md)을 사용하는 경우 [AWS CodeStar 연결](#setting-up-vcontrol)을 설정합니다.
+ 그렇지 않으면 [S3 버킷](#setting-up-bucket)을 설정합니다.
+ **인프라 프로비저닝:**
+ [자체 관리형 프로비저닝](ag-works-prov-methods.md#ag-works-prov-methods-self)의 경우 [AWS CodeStar 연결](#setting-up-vcontrol)을 설정해야 합니다.
+ **(선택 사항) 파이프라인을 프로비저하기:**
+ AWS관리형 프로비저닝과 [CodeBuild 기반 프로비저닝](ag-works-prov-methods.md#ag-works-prov-methods-codebuild)의 경우 [파이프라인 역할](#setting-up-pr-role)을 설정합니다.
+ [자체 관리형 프로비저닝](ag-works-prov-methods.md#ag-works-prov-methods-self)의 경우 [파이프라인 리포지토리](#setting-up-pr-repo)를 설정합니다.
프로비저닝 방법에 대한 자세한 내용은 [AWS관리형 프로비저닝 작동 방식](ag-works-prov-methods.md#ag-works-prov-methods-direct)을 참조하세요.
## S3 버킷 설정
S3 버킷을 설정하려면 [첫 번째 S3 버킷 생성](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html)의 지침에 따라 S3 버킷을 설정하세요. 가 입력을 검색할 AWS Proton 수 있는 버킷의 AWS Proton 에 입력을 배치합니다. 이러한 입력을 템플릿 번들이라고 합니다. 이 가이드의 다른 섹션의 자세한 내용은 이 가이드의 다른 섹션의 내용을 참조하세요.
## AWS CodeStar 연결 설정
리포지토리 AWS Proton 에 연결하려면 타사 소스 코드 리포지토리에서 새 커밋이 생성될 때 파이프라인을 활성화하는 AWS CodeStar 연결을 생성합니다.
**AWS Proton 는 연결을 사용하여 다음을 수행합니다.**
+ 리포지토리 소스 코드를 새로 커밋하면 서비스 파이프라인을 활성화합니다.
+ 인프라형 코드 리포지토리에서 풀 리퀘스트를 생성합니다.
+ 템플릿 중 하나를 변경하는 템플릿 리포지토리로 커밋이 푸시될 때마다(해당 버전이 아직 없는 경우) 새 템플릿 마이너 또는 메이저 버전을 만드세요.
CodeConnections를 사용하여 Bitbucket, GitHub, GitHub Enterprise 및 GitHub Enterprise Server 리포지토리에 연결할 수 있습니다. 자세한 내용은 *AWS CodePipeline 사용 설명서*의 [CodeConnections](https://docs.aws.amazon.com/codepipeline/latest/userguide/action-reference-CodestarConnectionSource.html)를 참조하세요.
**CodeStar 연결을 설정하기.**
1. [AWS Proton 콘솔](https://console.aws.amazon.com//proton/)을 엽니다.
1. 탐색 창에서 **설정**을 선택한 다음 **리포지토리 연결**을 선택하면 **개발자 도구** **설정**의 **연결** 페이지로 이동합니다. 이 페이지에는 연결 목록이 표시됩니다.
1. **연결 생성**을 선택하고 지침을 따릅니다.
## 계정 CI/CD 파이프라인 설정 설정
AWS Proton 는 애플리케이션 코드를 서비스 인스턴스에 배포하기 위한 CI/CD 파이프라인을 프로비저닝할 수 있습니다. 파이프라인 프로비저닝에 필요한 AWS Proton 설정은 파이프라인에 대해 선택한 프로비저닝 방법에 따라 다릅니다.
### AWS관리형 프로비저닝과 CodeBuild 기반 프로비저닝의 경우, 파이프라인 역할을 설정합니다.
관리[AWS형 프로비저닝](ag-works-prov-methods.md#ag-works-prov-methods-direct) 및 [CodeBuild 프로비저닝을](ag-works-prov-methods.md#ag-works-prov-methods-codebuild) 사용하면 파이프라인을 AWS Proton 프로비저닝할 수 있습니다. 따라서 파이프라인 프로비저닝 권한을 제공하는 서비스 역할이 AWS Proton 필요합니다. 이 두 가지 프로비저닝 방법은 각각 고유한 서비스 역할을 사용합니다. 이러한 역할은 모든 AWS Proton 서비스 파이프라인에서 공유되며 계정 설정에서 한 번 구성합니다.
**콘솔을 사용하여 파이프라인 서비스 역할 생성하기**
1. [AWS Proton 콘솔](https://console.aws.amazon.com//proton/)을 엽니다.
1. 탐색 창에서 **설정**을 선택한 다음 **계정 설정**을 선택합니다.
1. **계정 CI/CD 설정** 페이지에서 **구성**을 선택합니다.
1. 다음 중 하나를 수행하세요.
+ **파이프라인 서비스 역할을 AWS Proton 생성하려면**
[파이프라인의 AWS관리형 프로비저닝을 활성화하려면] **계정 설정 구성** 페이지의 **AWS관리형 프로비저닝 파이프라인 역할** 단원에서,
1. **새 서비스 역할**을 선택합니다.
1. 역할의 이름을 입력합니다(예: **myProtonPipelineServiceRole**).
1. 계정에 관리 권한이 있는 AWS Proton 역할을 생성하는 데 동의하려면 확인란을 선택합니다.
[CodeBuild 기반 파이프라인 프로비저닝을 활성화하려면] **계정 설정 구성** 페이지의 **CodeBuild 파이프라인 역할** 단원에서 **기존 서비스 역할**을 선택하고 **CloudFormation 파이프라인 역할** 단원에서 생성한 서비스 역할을 선택합니다. 또는 CloudFormation 파이프라인 역할을 할당하지 않은 경우 이전 3단계를 반복하여 새 서비스 역할을 생성합니다.
+ **기존 파이프라인 서비스 역할을 선택하기**
[파이프라인의 AWS관리형 프로비저닝을 활성화하려면 **계정 설정 구성** 페이지의 **AWS관리형 프로비저닝 파이프라인 역할** 단원에서 **기존 서비스 역할**을 선택하고 AWS 계정의 서비스 역할을 선택합니다.
[파이프라인의 CodeBuild 프로비저닝을 활성화하려면] **계정 설정 구성** 페이지의 **CodeBuild 파이프라인 프로비저닝 역할** 섹션에서 **기존 서비스 역할을** 선택하고 AWS 계정에서 서비스 역할을 선택합니다.
1. **변경 사항 저장**을 선택합니다.
새 파이프라인 서비스 역할은 **계정 설정** 페이지에 표시됩니다.
### 자체 관리형 프로비저닝 - 파이프라인 리포지토리를 설정합니다.
[자체 관리형 프로비저닝을](ag-works-prov-methods.md#ag-works-prov-methods-self) 사용하면는 설정한 프로비저닝 리포지토리에 풀 요청(PR)을 AWS Proton 전송하고 자동화 코드는 파이프라인 프로비저닝을 담당합니다. 따라서 파이프라인을 프로비저닝하는 데 서비스 역할이 필요하지 AWS Proton 않습니다. 대신 등록된 프로비저닝 리포지토리가 필요합니다. 리포지토리의 자동화 코드는 프로비저닝 파이프라인에 대한 권한을 제공하는 적절한 역할을 맡아야 합니다.
**콘솔을 사용하여 파이프라인 프로비저닝 리포지토리를 등록하려면**
1. CI/CD 파이프라인 프로비저닝 리포지토리를 아직 만들지 않았다면 생성합니다. 자체 관리형 프로비저닝의 파이프라인에 대한 자세한 내용은 [자체 관리형 프로비저닝의 작동 방식](ag-works-prov-methods.md#ag-works-prov-methods-self)을 참조하세요.
1. 탐색 창에서 **설정**을 선택한 다음 **계정 설정**을 선택합니다.
1. **계정 CI/CD 설정** 페이지에서 **구성**을 선택합니다.
1. **계정 설정 구성** 페이지의 **CI/CD** 파이프라인 리포지토리 단원에서:
1. **새 리포지토리**를 선택한 다음 리포지토리 제공자 중 하나를 선택합니다.
1. **CodeStar 연결**의 경우 연결 중 하나를 선택합니다.
**참고**
관련 리포지토리 공급자 계정에 아직 연결되지 않은 경우 **새 CodeStar 연결 추가**를 선택하고 연결 생성 프로세스를 완료한 다음 **CodeStar 연결** 메뉴 옆에 있는 새로 고침 버튼을 선택합니다. 이제 메뉴에서 새 연결을 선택할 수 있을 것입니다.
1. **리포지토리 이름**에서 파이프라인 프로비저닝 리포지토리를 선택합니다. 드롭다운 메뉴에는 제공자 계정의 리포지토리 목록이 표시됩니다.
1. **브랜치 이름**에서 리포지토리 브랜치 중의 하나를 선택합니다.
1. **변경 사항 저장**을 선택합니다.
파이프라인 리포지토리 역할은 **계정 설정** 페이지에 표시됩니다.
## 설정 AWS CLI
AWS CLI 를 사용하여 AWS Proton API를 호출하려면 최신 버전의를 설치했는지 확인합니다 AWS CLI. 자세한 내용은 *AWS Command Line Interface 사용 설명서*에서 [AWS CLI시작하기](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)를 참조하세요. 그런 다음 AWS CLI 에서 사용을 시작하려면 섹션을 AWS Proton참조하세요[시작하기 AWS CLI](ag-getting-started-cli.md).