지원 종료 알림: 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)를 참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 템플릿 동기화 구성
정의한 등록된 git 리포지토리에 있는 템플릿 번들에서 AWS Proton 동기화하도록 템플릿을 구성하는 방법을 알아봅니다. 커밋이 리포지토리로 푸시되면 AWS Proton 은 리포지토리 템플릿 번들의 변경 사항을 확인합니다. 템플릿 번들 변경을 감지하면 해당 버전이 아직 존재하지 않는 경우 템플릿의 새 마이너 또는 메이저 버전이 생성됩니다.는 AWS Proton 현재 GitHub, GitHub Enterprise 및 BitBucket을 지원합니다.
## 커밋을 동기화된 템플릿 번들로 푸시하기
템플릿 중 하나로 추적되는 브랜치에 커밋을 푸시하면 AWS Proton 은 리포지토리를 복제하고 동기화하는 데 필요한 템플릿을 결정합니다. 디렉토리의 파일을 스캔하여 `{template-name}/{major-version}/`의 규칙과 일치하는 디렉터리를 찾습니다.
가 리포지토리 및 브랜치와 연결된 템플릿과 메이저 버전을 AWS Proton 결정하면 모든 템플릿을 병렬로 동기화하려고 시도하기 시작합니다.
특정 템플릿에 동기화할 때마다 AWS Proton 먼저는 마지막으로 동기화가 성공한 이후 템플릿 디렉터리의 내용이 변경되었는지 확인합니다. 콘텐츠가 변경되지 않으면 중복 번들 등록을 AWS Proton 건너뜁니다. 이렇게 하면 템플릿 번들의 콘텐츠가 변경될 경우 새 템플릿 마이너 버전이 생성됩니다. 템플릿 번들의 내용이 변경되면 번들이에 등록됩니다 AWS Proton.
템플릿 번들이 등록된 후는 등록이 완료될 때까지 등록 상태를 AWS Proton 모니터링합니다.
특정 템플릿 마이너 버전과 메이저 버전은 한 번에 한 번만 동기화할 수 있습니다. 동기화가 진행되는 동안 푸시되었을 수 있는 모든 커밋은 일괄 처리됩니다. 일괄 처리된 커밋은 이전 동기화 시도가 완료된 후에 동기화됩니다.
## 서비스 템플릿 동기화
AWS Proton 는 git 리포지토리에서 환경 및 서비스 템플릿을 모두 동기화할 수 있습니다. 서비스 템플릿을 동기화하려면 템플릿 번들의 각 메이저 버전 디렉터리에 이름이 지정된 `.template-registration.yaml` 추가 파일을 추가합니다. 이 파일에는 커밋 후 서비스 템플릿 버전을 생성할 AWS Proton 때 *필요한 호환 환경* 및 *지원되는 구성 요소 소스* 등의 추가 세부 정보가 포함되어 있습니다.
파일의 전체 경로는 `service-template-name/major-version/.template-registration.yaml`입니다. 자세한 내용은 [서비스 템플릿 동기화](create-template-sync.md#create-template-sync-service-templates) 단원을 참조하세요.
## 템플릿 동기화 구성 고려 사항
템플릿 동기화 구성 사용에 대한 다음 고려 사항을 검토하세요.
+ 리포지토리는 250MB를 넘지 않아야 합니다.
+ 템플릿 동기화를 구성하려면 먼저 리포지토리를 AWS Proton에 연결합니다. 자세한 내용은 [리포지토리로 연결되는 링크를 생성합니다.](ag-create-repo.md) 단원을 참조하십시오.
+ 동기화된 템플릿에서 새 템플릿 버전을 만들면 `DRAFT` 상태가 됩니다.
+ 다음 중 하나에 해당하는 경우 템플릿의 새 마이너 버전이 생성됩니다.
+ 템플릿 번들 컨텐츠는 마지막으로 동기화된 템플릿 마이너 버전의 컨텐츠와 다릅니다.
+ 이전에 마지막으로 동기화된 템플릿 마이너 버전이 삭제되었습니다.
+ 동기화를 일시 중지할 수는 없습니다.
+ 새 마이너 버전과 메이저 버전 모두 자동으로 동기화됩니다.
+ 템플릿 동기화 구성으로는 새 최상위 템플릿을 만들 수 없습니다.
+ 템플릿 동기화 구성을 사용하면 여러 리포지토리의 템플릿 하나에 동기화할 수 없습니다.
+ 브랜치 대신 태그를 사용할 수는 없습니다.
+ [서비스 템플릿을 만들](template-create.md#svc-template-v1) 때는 호환되는 환경 템플릿을 지정합니다.
+ 환경 템플릿을 만든 다음 동일한 커밋에서 서비스 템플릿과 호환되는 환경으로 추가할 수 있습니다.
+ 단일 템플릿 메이저 버전과의 동기화는 한 번에 하나씩 실행됩니다. 동기화 중에 새 커밋이 감지되면 일괄 처리되어 활성 동기화가 끝날 때 적용됩니다. 다른 템플릿 메이저 버전과의 동기화는 병렬로 이루어집니다.
+ 템플릿이 동기화되는 브랜치를 변경하면 이전 브랜치에서 진행 중인 모든 동기화가 먼저 완료됩니다. 그러면 새 브랜치부터 동기화가 시작됩니다.
+ 템플릿을 동기화하는 데 사용할 리포지토리를 변경하면 이전 리포지토리에서 진행 중인 모든 동기화가 실패하거나 완료될 수 있습니다. 동기화 단계에 따라 다릅니다.
자세한 내용은 [https://docs.aws.amazon.com/proton/latest/APIReference/Welcome.html](https://docs.aws.amazon.com/proton/latest/APIReference/Welcome.html) 참조를 참조하세요.
**Topics**
+ [
## 커밋을 동기화된 템플릿 번들로 푸시하기
](#ag-commits)
+ [
## 서비스 템플릿 동기화
](#syncing-service-templates)
+ [
## 템플릿 동기화 구성 고려 사항
](#sync-considerations)
+ [
# 템플릿 동기화 구성을 생성합니다.
](create-template-sync.md)
+ [
# 템플릿 동기화 구성 세부 정보 보기
](view-template-sync.md)
+ [
# 템플릿 동기화 구성 편집
](update-template-sync.md)
+ [
# 템플릿 동기화 구성 삭제
](delete-template-sync.md)
# 템플릿 동기화 구성을 생성합니다.
를 사용하여 템플릿 동기화 구성을 생성하는 방법을 알아봅니다 AWS Proton.
**템플릿 동기화 구성 전제 조건을 생성하기:**
+ AWS Proton와 [리포지토리 연결](ag-create-repo.md)했습니다..
+ [템플릿 번들](ag-template-authoring.md#ag-template-bundles)은 리포지토리에 있습니다.
**리포지토리 링크는 다음 구성 요소로 이루어져 있습니다.**
+ 리포지토리에 액세스하고 알림을 구독할 수 있는 AWS Proton 권한을 부여하는 CodeConnections 연결입니다.
+ [서비스 연결 역할](using-service-linked-roles.md) 리포지토리를 연결하면 서비스 연결 역할이 자동으로 만들어집니다.
첫 번째 템플릿 동기화 구성을 생성하기 전에 다음 디렉토리 레이아웃과 같이 템플릿 번들을 저장소에 푸시하세요.
```
/templates/ # subdirectory (optional)
/templates/my-env-template/ # template name
/templates/my-env-template/v1/ # template version
/templates/my-env-template/v1/infrastructure/ # template bundle
/templates/my-env-template/v1/schema/
```
첫 번째 템플릿 동기화 구성을 만든 후 업데이트된 템플릿 번들을 새 버전 에 추가하는 커밋을 푸시하면 새 템플릿 버전이 자동으로 생성됩니다(예: `/my-env-template/v2/` 아래).
```
/templates/ # subdirectory (optional)
/templates/my-env-template/ # template name
/templates/my-env-template/v1/ # template version
/templates/my-env-template/v1/infrastructure/ # template bundle
/templates/my-env-template/v1/schema/
/templates/my-env-template/v2/
/templates/my-env-template/v2/infrastructure/
/templates/my-env-template/v2/schema/
```
단일 커밋에 하나 이상의 동기화 구성 템플릿에 대한 새 템플릿 번들 버전을 포함할 수 있습니다.는 커밋에 포함된 각 새 템플릿 번들 버전에 대해 새 템플릿 버전을 AWS Proton 생성합니다.
템플릿 동기화 구성을 생성한 후에도 콘솔에서 또는 S3 버킷에서 템플릿 번들을 업로드 AWS CLI 하여를 사용하여 새 버전의 템플릿을 수동으로 생성할 수 있습니다. 템플릿 동기화는 리포지토리에서 로 한 방향으로만 작동합니다 AWS Proton. 수동으로 생성한 템플릿 버전은 동기화되지 *않습니다*.
템플릿 동기화 구성을 설정한 후는 리포지토리의 AWS Proton 변경 사항을 수신합니다. 변경 사항이 푸시될 때마다 템플릿과 이름이 같은 디렉토리를 찾습니다. 그런 다음 해당 디렉터리 내부에서 메이저 버전과 같은 디렉터리를 찾습니다.는 템플릿 번들을 해당 템플릿 메이저 버전에 AWS Proton 등록합니다. 새 버전은 항상 `DRAFT` 상태를 유지합니다. 콘솔 또는 [를 사용하여 새 버전을 게시](template-create.md)할 수 있습니다 AWS CLI.
예를 들어 `my-env-template`이라는 템플릿이 다음과 같은 레이아웃으로 브랜치 `main`의 `my-repo/templates`에서 동기화되도록 구성되어 있다고 가정해 보겠습니다.
```
/code
/code/service.go
README.md
/templates/
/templates/my-env-template/
/templates/my-env-template/v1/
/templates/my-env-template/v1/infrastructure/
/templates/my-env-template/v1/schema/
/templates/my-env-template/v2/
/templates/my-env-template/v2/infrastructure/
/templates/my-env-template/v2/schema/
```
AWS Proton 는의 내용을 `/templates/my-env-template/v1/`에 동기화`my-env-template:1`하고의 내용을 `/templates/my-env-template/v2/`에 동기화합니다`my-env-template:2`. 아직 존재하지 않는 경우 다음과 같은 메이저 버전이 생성됩니다.
AWS Proton 에서 템플릿 이름과 일치하는 첫 번째 디렉터리를 찾았습니다. 템플릿 동기화 구성을 생성하거나 편집할 `subdirectoryPath` 때를 지정하여 디렉터리 AWS Proton 검색을 제한할 수 있습니다. 예를 들어, `subdirectoryPath`에 대해 `/production-templates/`로 지정할 수 있습니다.
콘솔 또는 CLI를 사용하여 서비스 동기화 구성을 만들 수 있습니다.
------
#### [ AWS Management Console ]
**콘솔을 사용하여 템플릿 및 템플릿 동기화 구성을 생성합니다.**
1. [AWS Proton 콘솔](https://console.aws.amazon.com//proton/)에서 **환경 템플릿**을 선택합니다.
1. **환경 템플릿 생성**을 선택합니다.
1. **환경 템플릿 생성** 페이지의 **템플릿 옵션** 단원에서 **새 환경을 프로비저닝하기 위한 템플릿 생성**을 선택합니다.
1. **템플릿 번들 소스** 단원에서 **Git에서 템플릿 동기화**를 선택합니다.
1. **소스 코드 리포지토리**에서,
1. **리포지토리**의 경우 템플릿 번들이 포함된 연결된 리포지토리를 선택합니다.
1. **브랜치**의 경우 동기화할 리포지토리 브랜치를 선택합니다.
1. (선택 사항) **템플릿 번들 디렉터리**의 경우 디텍터리의 이름을 입력하여 템플릿 번들 검색 범위를 좁힙니다.
1. **템플릿 세부 정보** 단원에서.
1. **템플릿 이름**을 입력합니다.
1. (선택 사항) **템플릿 표시 이름**을 입력합니다.
1. (선택 사항) 환경 템플릿에 대한 ** 템플릿 설명**을 입력합니다.
1. (선택 사항) **암호화 설정** 단원에서 **암호화 설정 사용자 지정(고급)** 확인란을 선택하여 고유한 암호화 키를 제공하세요.
1. (선택 사항) **태그** 단원에서 **새 태그 추가**를 선택하고 키와 값을 입력하여 고객 관리형 태그를 생성합니다.
1. **환경 템플릿 생성**을 선택합니다.
이제 새 환경 템플릿의 상태 및 세부 정보를 표시하는 새 페이지가 열립니다. 이러한 세부 정보에는 AWS 관리형 및 고객 관리형 태그 목록이 포함됩니다.는 AWS Proton 리소스를 생성할 때 AWS 관리형 태그를 AWS Proton 자동으로 생성합니다. 자세한 내용은 [AWS Proton 리소스 및 태그 지정](resources.md) 단원을 참조하십시오.
1. 템플릿 세부 정보 페이지에서 **동기화** 탭을 선택하여 템플릿 동기화 구성 세부 정보 데이터를 확인합니다.
1. **템플릿 버전** 탭을 선택하면 상태 세부 정보가 포함된 템플릿 버전을 볼 수 있습니다.
1. 새 환경 템플릿 상태의 상태는 **초안** 상태에서 시작됩니다. 사용자 및 `proton:CreateEnvironment` 권한이 있는 다른 사용자가 보고 액세스할 수 있습니다. 다음 단계에 따라 다른 사람이 템플릿을 사용할 수 있도록 합니다.
1. **템플릿 버전** 단원에서 방금 만든 템플릿의 마이너 버전 왼쪽에 있는 라디오 버튼 (1.0) 을 선택합니다. 또는 정보 알림에서 **게시**를 선택하고 다음 단계를 건너뛸 수도 있습니다.
1. **템플릿 버전** 단원에서 **게시**를 선택합니다.
1. 템플릿 상태가 **게시됨**으로 변경됩니다. 템플릿의 최신 및 **권장** 버전입니다.
1. 탐색 창에서 **환경 템플릿**을 선택하여 환경 템플릿 및 세부 정보 목록을 확인합니다.
서비스 템플릿과 템플릿 동기화 구성을 만드는 절차는 비슷합니다.
------
#### [ AWS CLI ]
**AWS CLI를 사용하여 템플릿 및 템플릿 동기화 구성을 생성합니다.**
1.
**템플릿 생성 이 예시에서는 환경 템플릿이 생성됩니다.**
다음 명령을 실행합니다.
```
$ aws proton create-environment-template \
--name "env-template"
```
응답은 다음과 같습니다.
```
{
"environmentTemplate": {
"arn": "arn:aws:proton:us-east-1:123456789012:environment-template/env-template",
"createdAt": "2021-11-07T23:32:43.045000+00:00",
"displayName": "env-template",
"lastModifiedAt": "2021-11-07T23:32:43.045000+00:00",
"name": "env-template",
"status": "DRAFT",
"templateName": "env-template"
}
}
```
1.
**다음을 AWS CLI 제공하여와 템플릿 동기화 구성을 생성합니다.**
+ 동기화할 템플릿입니다. 템플릿 동기화 구성을 만든 후에도 콘솔에서 또는 AWS CLI를 사용하여 수동으로 새 버전을 만들 수 있습니다.
+ 템플릿 이름입니다.
+ 템플릿 유형.
+ 동기화하려는 링크된 리포지토리
+ 연결된 저장소 제공자.
+ 템플릿 번들이 있는 브랜치입니다.
+ (선택 사항) 템플릿 번들이 포함된 디렉터리의 경로입니다. 기본적으로는 템플릿 이름과 일치하는 첫 번째 디렉터리를 AWS Proton 찾습니다.
다음 명령을 실행합니다.
```
$ aws proton create-template-sync-config \
--template-name "env-template" \
--template-type "ENVIRONMENT" \
--repository-name "myrepos/templates" \
--repository-provider "GITHUB" \
--branch "main" \
--subdirectory "env-template/"
```
응답은 다음과 같습니다.
```
{
"templateSyncConfigDetails": {
"branch": "main",
"repositoryName": "myrepos/templates",
"repositoryProvider": "GITHUB",
"subdirectory": "templates",
"templateName": "env-template",
"templateType": "ENVIRONMENT"
}
}
```
1. **템플릿 버전을 게시하려면 [템플릿 등록 및 게시](template-create.md)을 참조하세요.**
------
## 서비스 템플릿 동기화
위 예제는 환경 템플릿을 동기화하는 방법을 보여줍니다. 서비스 템플릿도 비슷합니다. 서비스 템플릿을 동기화하려면 템플릿 번들의 각 메이저 버전 디렉터리에 이름이 지정된 `.template-registration.yaml` 추가 파일을 추가합니다. 이 파일에는 커밋 후 서비스 템플릿 버전을 생성할 때 AWS Proton 필요한 추가 세부 정보가 포함되어 있습니다. AWS Proton 콘솔 또는 API를 사용하여 서비스 템플릿 버전을 명시적으로 생성하는 경우 이러한 세부 정보를 입력으로 제공하면이 파일이 템플릿 동기화를 위해 이러한 입력을 대체합니다.
```
./templates/ # subdirectory (optional)
/templates/my-svc-template/ # service template name
/templates/my-svc-template/v1/ # service template version
/templates/my-svc-template/v1/.template-registration.yaml # service template version properties
/templates/my-svc-template/v1/instance_infrastructure/ # template bundle
/templates/my-svc-template/v1/schema/
```
`.template-registration.yaml` 파일에는 다음 코드가 포함되어 있습니다.
+ **호환되는 환경**[필수] - 이러한 환경 템플릿 및 메이저 버전을 기반으로 하는 환경은 이 서비스 템플릿 버전을 기반으로 하는 서비스와 호환됩니다.
+ **지원되는 구성 요소 소스**[선택 사항] - 이러한 소스를 사용하는 구성 요소는 이 서비스 템플릿 버전을 기반으로 하는 서비스와 호환됩니다. 지정하지 않으면 구성 요소를 이러한 서비스에 연결할 수 없습니다. 구성 요소에 대한 자세한 내용은 [AWS Proton 구성 요소](ag-components.md)를 참조하세요.
파일의 YAML 구문은 다음과 같습니다.
```
compatible_environments:
- env-templ-name:major-version
- ...
supported_component_sources:
- DIRECTLY_DEFINED
```
하나 이상의 환경 템플릿/메이저 버전 조합을 지정합니다. `supported_component_sources` 지정은 선택 사항이며 지원되는 값은 `DIRECTLY_DEFINED`뿐입니다.
**Example .template-registration.yaml**
이 예제에서 서비스 템플릿 버전은 `my-env-template` 환경 템플릿의 메이저 버전 1 및 2와 호환됩니다. 또한 `another-env-template` 환경 템플릿의 주요 버전 1 및 3과도 호환됩니다. 파일은 `supported_component_sources`을 지정하지 않으므로 이 서비스 템플릿 버전을 기반으로 하는 서비스에 구성 요소를 연결할 수 없습니다.
```
compatible_environments:
- my-env-template:1
- my-env-template:2
- another-env-template:1
- another-env-template:3
```
**참고**
이전에는에서 호환되는 환경을 지정하기 `.compatible-envs`위해 다른 파일를 AWS Proton 정의했습니다. AWS Proton 는 이전 버전과의 호환성을 위해 해당 파일과 형식을 지원합니다. 확장이 불가능하고 구성 요소와 같은 최신 기능을 지원할 수 없으므로 더 이상 사용하지 않는 것이 좋습니다.
# 템플릿 동기화 구성 세부 정보 보기
콘솔 또는 CLI를 사용하여 템플릿 동기화 구성 세부 데이터를 확인합니다.
------
#### [ AWS Management Console ]
**콘솔을 사용하여 템플릿 동기화 구성 세부 정보를 확인합니다.**
1. 탐색 창에서 **(환경 또는 서비스) 템플릿**을 선택합니다.
1. 세부 데이터를 보려면 템플릿 동기화 구성을 만든 템플릿의 이름을 선택합니다.
1. 템플릿의 세부 정보 페이지에서 **동기화** 탭을 선택하여 템플릿 동기화 구성 세부 정보 데이터를 확인합니다.
------
#### [ AWS CLI ]
** AWS CLI 를 사용하여 동기화된 템플릿을 봅니다.**
다음 명령을 실행합니다.
```
$ aws proton get-template-sync-config \
--template-name "svc-template" \
--template-type "SERVICE"
```
응답은 다음과 같습니다.
```
{
"templateSyncConfigDetails": {
"branch": "main",
"repositoryProvider": "GITHUB",
"repositoryName": "myrepos/myrepo",
"subdirectory": "svc-template",
"templateName": "svc-template",
"templateType": "SERVICE"
}
}
```
** AWS CLI 를 사용하여 템플릿 동기화 상태를 가져옵니다.**
`template-version`에 템플릿 메이저 버전을 입력합니다.
다음 명령을 실행합니다.
```
$ aws proton get-template-sync-status \
--template-name "env-template" \
--template-type "ENVIRONMENT" \
--template-version "1"
```
------
# 템플릿 동기화 구성 편집
`template-name`및 `template-type`를 제외한 모든 템플릿 동기화 구성 파라미터를 편집할 수 있습니다.
콘솔 또는 CLI를 사용하여 템플릿 동기화 구성을 편집하는 방법을 알아보세요.
------
#### [ AWS Management Console ]
콘솔을 사용하여 템플릿 동기화 구성 브랜치를 편집합니다.
**템플릿 목록에서.**
1. [AWS Proton 콘솔](https://console.aws.amazon.com//proton/)에서 **(환경 또는 서비스) 템플릿**을 선택합니다.
1. 템플릿 목록에서 편집하려는 템플릿 동기화 구성이 포함된 템플릿의 이름을 선택합니다.
1. 템플릿 세부 정보 페이지에서 **템플릿 동기화** 탭을 선택합니다.
1. **템플릿 동기화 세부 정보** 단원에서 **편집**을 선택합니다.
1. **편집** 페이지의 **소스 코드 리포지토리** 단원에서 **브랜치ㅌ**을 대해 브랜치를 선택한 다음 **구성 저장**을 선택합니다.
------
#### [ AWS CLI ]
**다음 예제 명령 및 응답은 CLI를 사용하여 템플릿 동기화 구성 `branch`를 편집하는 방법을 보여줍니다.**
다음 명령을 실행합니다.
```
$ aws proton update-template-sync-config \
--template-name "env-template" \
--template-type "ENVIRONMENT" \
--repository-provider "GITHUB" \
--repository-name "myrepos/templates" \
--branch "fargate" \
--subdirectory "env-template"
```
응답은 다음과 같습니다.
```
{
"templateSyncConfigDetails": {
"branch": "fargate",
"repositoryProvider": "GITHUB",
"repositoryName": "myrepos/myrepo",
"subdirectory": "templates",
"templateName": "env-template",
"templateType": "ENVIRONMENT"
}
}
```
마찬가지로 AWS CLI 를 사용하여 동기화된 서비스 템플릿을 업데이트할 수 있습니다.
------
# 템플릿 동기화 구성 삭제
콘솔 또는 CLI를 사용하여 템플릿 동기화 구성을 삭제합니다.
------
#### [ AWS Management Console ]
**콘솔을 사용하여 템플릿 동기화 구성을 삭제합니다.**
1. 템플릿 세부 정보 페이지에서 **동기화** 탭을 선택합니다.
1. **동기화 세부 정보** 단원에서 **연결 해제**를 선택합니다.
------
#### [ AWS CLI ]
**다음 예제 명령 및 응답은를 사용하여 동기화된 템플릿 구성을 삭제 AWS CLI 하는 방법을 보여줍니다.**
다음 명령을 실행합니다.
```
$ aws proton delete-template-sync-config \
--template-name "env-template" \
--template-type "ENVIRONMENT"
```
응답은 다음과 같습니다.
```
{
"templateSyncConfig": {
"templateName": "env-template",
"templateType": "ENVIRONMENT"
}
}
```
------