AWS CloudFormation Git 동기화 연습
다음 연습을 통해 Git 동기화를 사용하는 방법을 알아봅니다. 시작하기 전에 Git 동기화 사전 조건을 완료해야 합니다.
1단계: 스택 생성
-
CloudFormation 콘솔
에 액세스합니다. -
스택 생성을 선택합니다.
-
스택 생성 대시보드의 사전 조건 - 템플릿 준비 패널에서 준비된 템플릿이 선택되어 있는지 확인합니다.
-
템플릿 지정 패널에서 Git에서 동기화를 선택합니다.
-
다음을 선택하여 스택 세부 정보를 지정합니다.
2단계: 스택 세부 정보 지정
-
스택 이름 제공 패널에 스택의 이름을 입력합니다. 스택 이름에는 문자(A~Z 및 a~z), 숫자(0~9), 대시(-)를 포함할 수 있습니다.
-
스택 배포 파일에는 두 가지 옵션이 있습니다.
-
다음 파라미터를 사용하여 파일을 생성하고 내 리포지토리에 배치합니다.
Git 동기화에서 스택 배포 파일을 생성하고 리포지토리에 배치하도록 하려면 이 옵션을 선택하세요.
-
내 리포지토리에 자체 파일을 제공합니다.
직접 스택 배포 파일을 생성하고 리포지토리에 추가한 경우 이 옵션을 선택하세요.
자세한 내용은 스택 배포 파일 섹션을 참조하세요.
-
-
템플릿 정의 리포지토리 패널에는 두 가지 옵션이 있습니다.
-
연결된 Git 리포지토리 선택
-
Git 리포지토리 연결
Git 리포지토리를 CloudFormation에 이미 연결한 경우 연결된 Git 리포지토리 선택을 선택하고 다음 단계로 진행합니다. 그러지 않은 경우 다음 하위 단계를 수행하여 Git 리포지토리를 연결합니다.
-
Git 리포지토리 연결을 선택합니다.
-
다음 중에서 Git 리포지토리 공급자를 선택합니다.
GitHub
GitHub Enterprise
GitLab
Bitbucket
-
목록에서 연결을 선택합니다. 연결 목록에 옵션이 표시되지 않는 경우 연결 콘솔
로 이동하여 리포지토리에 대한 연결을 생성합니다.
-
-
리포지토리 목록에서 스택 템플릿 파일이 포함된 Git 리포지토리를 선택합니다.
-
브랜치 목록에서 Git 동기화에서 모니터링하려는 브랜치를 선택합니다.
참고
Git 동기화는 선택한 브랜치에서 CloudFormation 템플릿 및 스택 배포 파일의 변경 사항만 모니터링합니다. 스택에 적용하려는 모든 변경 사항은 이 브랜치에 커밋해야 합니다.
-
배포 파일 경로에 리포지토리 브랜치의 루트를 기준으로 스택 배포 파일 이름을 포함한 전체 경로를 지정합니다.
CloudFormation에서 파일을 생성하는 경우 이 경로는 리포지토리에서 파일이 커밋되는 위치입니다. 파일을 직접 제공하는 경우 이 경로는 리포지토리에서 파일의 위치입니다.
-
IAM 역할을 추가합니다. IAM 역할에는 CloudFormation에서 Git 리포지토리의 스택을 동기화하는 데 필요한 권한이 포함됩니다. 새 IAM 역할을 선택하여 새 역할을 생성하거나 기존 IAM 역할을 선택하여 CloudFormation 계정에서 기존 역할을 선택할 수 있습니다. 새 역할을 생성하도록 선택하면 필요한 권한이 역할에 포함됩니다.
참고
Git 동기화에 필요한 권한 및 신뢰 정책에 대한 중요한 정보는 필요한 권한를 참조하세요.
-
템플릿 파일 경로에 스택 템플릿 파일에 대한 리포지토리 루트를 기준으로 전체 경로를 지정합니다.
-
스택 배포 파일에서 설정하려는 스택에 대한 파라미터를 추가합니다. 파라미터는 키–값 페어입니다. 예를 들어, 스택 배포 파일에 포트 파라미터를 추가하려면 다음 작업을 진행합니다.
-
Add parameter(파라미터 추가)를 선택합니다.
-
키(Key)에
port
를 입력합니다. -
값에
8080
을(를) 입력합니다. -
스택 배포 파일에서 사용할 수 있도록 하려는 모든 스택 파라미터에 대해 이전 단계를 반복합니다.
-
-
(선택 사항) 태그를 추가합니다. 태그는 스택의 리소스를 식별하고 분류하는 데 사용할 수 있는 키-값 페어입니다. 스택 배포에 태그를 추가하려면 파라미터를 추가할 때와 동일한 프로세스를 따릅니다.
-
다음을 선택하여 스택 옵션 구성을 계속 진행합니다.
3단계: 스택 옵션 구성
스택 옵션의 구성에 대한 자세한 내용은 AWS CloudFormation 스택 옵션 설정을 참조하세요.
구성을 완료했으면 다음을 선택하여 검토 및 배포로 계속 진행합니다.
4단계: 검토 및 배포
-
스택 설정을 검토하고 다음을 확인합니다.
-
스택 템플릿이 올바르게 구성되고 Git에서 동기화로 설정되어 있습니다.
-
배포 파일이 올바르게 구성되어 있습니다.
-
템플릿 정의 리포지토리가 올바르게 구성되어 있고, 특히 리포지토리와 브랜치 이름이 올바르게 선택되어 있습니다.
-
배포 파일의 미리 보기가 정확하며 필요한 파라미터와 값을 포함하고 있습니다.
-
-
제출을 선택하여 스택을 생성합니다.
중요
제출을 선택하면 Git 리포지토리에서 풀 요청이 자동으로 생성됩니다. 이 풀 요청을 Git 리포지토리에 병합하여 프로세스를 완료해야 합니다. 풀 요청을 병합하면 스택이 생성되고 Git 동기화에서 CloudFormation 템플릿과 스택 배포 파일의 변경 사항을 모니터링하여 스택을 업데이트합니다.
스택 수정
이전 단계를 완료하면 새 스택이 생성되고 CloudFormation에서 Git 리포지토리의 변경 사항을 모니터링합니다.
스택을 수정하려면 스택 배포 파일을 직접 변경합니다. 그런 다음 Git 동기화에서 스택에 대해 구성한 리포지토리 및 브랜치에 커밋합니다.
CloudFormation 대시보드에서 스택을 선택하고 Git 동기화 탭을 선택하여 스택 및 동기화 이벤트의 상태에 대한 정보를 볼 수 있습니다. 자세한 내용은 AWS CloudFormation Git 동기화 상태 대시보드 섹션을 참조하세요.