テンプレート同期設定を作成する

を使用してテンプレート同期設定を作成する方法について説明します 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/

1 つ以上の同期設定済みテンプレートの新しいテンプレートバンドルバージョンを 1 つのコミットに含めることができます。 は、コミットに含まれていた新しいテンプレートバンドルバージョンごとに新しいテンプレートバージョン AWS Proton を作成します。

テンプレート同期設定を作成した後も、S3 バケットからテンプレートバンドルをアップロード AWS CLI することで、コンソールまたは でテンプレートの新しいバージョンを手動で作成できます。テンプレートの同期は、リポジトリから への 1 つの方向でのみ機能します 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 は の内容を /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 を使用して作成できます。

サービステンプレートを同期する

前の例では、環境テンプレートを同期する方法を示します。サービステンプレートも同様です。サービステンプレートを同期するには、あなたのテンプレートバンドルの各メジャーバージョンディレクトリに .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

1 つ以上の環境テンプレートとメジャーバージョンの組み合わせを指定します。supported_component_sources の指定はオプションです。サポートされている値は DIRECTLY_DEFINED だけです。

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