템플릿 동기화 구성을 생성합니다.

를 사용하여 템플릿 동기화 구성을 만드는 방법을 알아보십시오 AWS Proton.

첫 번째 템플릿 동기화 구성을 생성하기 전에 다음 디렉토리 레이아웃과 같이 템플릿 번들을 저장소에 푸시하세요.

 /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 상태를 유지합니다. 콘솔이나 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 to의 my-env-template:1 내용과 /templates/my-env-template/v1/ to의 /templates/my-env-template/v2/ 내용을 my-env-template:2 동기화합니다. 아직 존재하지 않는 경우 다음과 같은 메이저 버전이 생성됩니다.

AWS Proton 템플릿 이름과 일치하는 첫 번째 디렉터리를 찾았습니다. 템플릿 동기화 구성을 만들거나 편집할 subdirectoryPath 때 a를 지정하여 디렉토리 AWS Proton 검색을 제한할 수 있습니다. 예를 들어, subdirectoryPath에 대해 /production-templates/로 지정할 수 있습니다.

콘솔 또는 CLI를 사용하여 서비스 동기화 구성을 만들 수 있습니다.

서비스 템플릿 동기화

위 예제는 환경 템플릿을 동기화하는 방법을 보여줍니다. 서비스 템플릿도 비슷합니다. 서비스 템플릿을 동기화하려면 템플릿 번들의 각 메이저 버전 디렉터리에 이름이 지정된 .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 파일에는 다음 코드가 포함되어 있습니다.

파일의 YAML 구문은 다음과 같습니다.

compatible_environments:
  - env-templ-name:major-version
  - ...
supported_component_sources:
  - DIRECTLY_DEFINED

하나 이상의 환경 템플릿/메이저 버전 조합을 지정합니다. supported_component_sources 지정은 선택 사항이며 지원되는 값은 DIRECTLY_DEFINED뿐입니다.

compatible_environments:
  - my-env-template:1
  - my-env-template:2
  - another-env-template:1
  - another-env-template:3