テンプレートの同期設定 - AWS Proton

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

テンプレートの同期設定

ここでは、あなたが定義した登録済み 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 は、登録が完了するまで登録ステータスをモニタリングします。

特定のテンプレートのマイナーバージョンとメジャーバージョンに対して 1 つずつしか同期できません。同期の進行中にプッシュされた可能性のあるコミットはすべてバッチ処理されます。バッチされたコミットは、前回の同期試行の完了後に同期されます。

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

AWS Proton では、あなたの Git リポジトリから環境テンプレートとサービステンプレートの両方を同期できます。あなたのサービステンプレートを同期するには、あなたのテンプレートバンドルの各メジャーバージョンディレクトリに .template-registration.yaml という名前のファイルを追加します。このファイルには、AWS Proton コミットの後にサービステンプレートバージョンを作成する際に必要な追加情報 (互換性のある環境サポートされているコンポーネントソース) が含まれています。

このファイルのフルパスは service-template-name/major-version/.template-registration.yaml です。詳細については、「サービステンプレートを同期する」を参照してください。

テンプレート同期の設定に関する考慮事項

テンプレート同期設定の使用については、次の考慮事項を確認してください。

  • リポジトリは 250 MB 以下にする必要があります。

  • テンプレート同期を設定するには、まずリポジトリを AWS Proton にリンクします。詳細については、「あなたのリポジトリのリンクを作成して登録する」を参照してください。

  • 同期されたテンプレートから新しいテンプレートバージョンが作成されると、DRAFT 状態になります。

  • 次のいずれかに該当する場合、テンプレートの新しいマイナーバージョンが作成されます。

    • テンプレートバンドルの内容は、最後に同期されたテンプレートマイナーバージョンのものとは異なります。

    • 前回同期したテンプレートのマイナーバージョンが削除されました。

  • 同期を一時停止することはできません。

  • 新しいマイナーバージョンとメジャーバージョンの両方が自動的に同期されます。

  • テンプレート同期設定では、新しい最上位レベルテンプレートを作成することはできません。

  • テンプレート同期設定を使用して、複数のリポジトリから 1 つのテンプレートに同期することはできません。

  • ブランチの代わりにタグを使用することはできません。

  • サービステンプレートを作成する際には、互換性のある環境テンプレートを指定します。

  • 環境テンプレートを作成し、それを同じコミット内であなたのサービステンプレートの互換環境として追加できます。

  • 単一のテンプレートのメジャーバージョンへの同期は 1 つずつ実行されます。同期中に新しいコミットが検出されると、それらはアクティブ同期の終わりでバッチ処理され適用されます。異なるテンプレートのメジャーバージョンへの同期は並行して進行します。

  • テンプレートの同期元のブランチを変更すると、まず古いブランチからの継続的な同期が完了します。次いで、新しいブランチから同期が始まります。

  • テンプレートの同期元のリポジトリを変更すると、古いリポジトリからの継続的な同期が失敗したり、完了するまで実行される可能性があります。同期のどの段階にいるかによって異なります。

詳細については、『AWS Proton サービス API リファレンス』を参照してください。