テンプレートの同期設定 - 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 リファレンス」を参照してください。

トピック