翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
でのセットアップ AWS Proton
を使用して AWS Proton APIs AWS CLI を実行する場合は、インストールされていることを確認します。まだインストールしていない場合、「のセットアップ AWS CLI」を参照してください。
AWS Proton 特定の設定:
-
テンプレートを作成および管理するには
-
テンプレート同期設定で、AWS CodeStar 接続をセットアップします。
-
あるいは、Amazon S3 バケットを設定します。
-
-
インフラストラクチャをプロビジョニングするには
-
セルフマネージド型プロビジョニングでは、AWS CodeStar 接続を設定する必要があります。
-
-
(オプション) パイプラインをプロビジョニングするには
-
AWSマネージドプロビジョニングと CodeBuild ベースのプロビジョニングでは、パイプラインロールを設定します。
-
セルフマネージドプロビジョニングの場合は、パイプラインリポジトリを設定します。
-
プロビジョニングの方法の詳細については、「AWS マネージドプロビジョニングの働き」を参照してください。
Amazon S3 バケットのセットアップ
S3 バケットを設定するには、「ユーザーの最初の S3 バケットを作成する」の手順に従って S3 バケットを設定します。入力を AWS Proton に格納し、 AWS Proton が取得できるようにします。これらの入力はテンプレートバンドルと呼ばれます。詳細については、このガイドで当該セクションを参照してください。
AWS CodeStar 接続のセットアップ
リポジトリ AWS Proton に接続するには、サードパーティーのソースコードリポジトリで新しいコミットが行われたときにパイプラインをアクティブ化する AWS CodeStar 接続を作成します。
AWS Proton は接続を使用して以下を行います。
-
ユーザーのリポジトリソースコードで新しいコミットが発生すると、サービスパイプラインがアクティブになります。
-
Infrastructure as Code リポジトリについてプルリクエストを作成します。
-
テンプレートのリポジトリにコミットがプッシュされるたびに、テンプレートのいずれかを変更する新しいテンプレートマイナーバージョンまたはメジャーバージョンを (バージョンがまだ存在しなければ) 作成します。
Bitbucket、 GitHub、 GitHub Enterprise、 GitHub Enterprise Server リポジトリには CodeConnections で接続できます。詳細については、AWS CodePipeline 「 ユーザーガイド」のCodeConnections」を参照してください。
CodeStar 接続をセットアップするには。
-
AWS Proton コンソール
を開きます。 -
ナビゲーションペインで [Settings (設定)] を選択してから [Repository connections (レポジトリ接続)] を選択すると、[Developer Tools (開発者ツール)] [[Settings (設定)] の [Connections (接続)] ページが表示されます。このページには、接続のリストが表示されます。
-
[Create connection] (接続を作成する) を選択し、指示に従って操作します。
アカウント CI/CD パイプラインの設定
AWS Proton は、アプリケーションコードをサービスインスタンスにデプロイするための CI/CD パイプラインをプロビジョニングできます。パイプラインプロビジョニングに必要な AWS Proton 設定は、パイプラインに選択したプロビジョニング方法によって異なります。
AWSマネージド型および CodeBuild ベースのプロビジョニング — パイプラインロールのセットアップ
AWSマネージドプロビジョニングと CodeBuild プロビジョニングにより、 AWS Proton はパイプラインをプロビジョニングします。したがって、 にはパイプラインのプロビジョニング許可を提供するサービスロール AWS Proton が必要です。これら 2 つのプロビジョニング方法ではそれぞれ独自のサービスロールを使用します。これらのロールはすべての AWS Proton サービスパイプラインで共有され、アカウント設定で 1 回設定します。
コンソールでパイプラインサービスロールを作成する
-
AWS Proton コンソール
を開きます。 -
ナビゲーションペインで、[Settings (設定)] を選択し、[Accounts settings (アカウント設定)] を選択します。
-
[アカウント CI/CD 設定] ページで、[設定] を選択します。
-
次のいずれかを行います。
-
パイプラインサービスロール AWS Proton を作成するには
[パイプラインの AWSマネージドプロビジョニングを有効にするには] - [AWSマネージドプロビジョニングパイプラインロール] セクションの [アカウント設定の設定] ページ:
-
[新しいサービスロール] を選択します。
-
ロールの名前を入力します (例:
myProtonPipelineServiceRole
)。 -
アカウントに管理権限を持つ AWS Proton ロールを作成することに同意するには、チェックボックスをオンにします。
〔パイプラインの CodeBuild ベースのプロビジョニングを有効にするには] アカウント設定の設定ページの CodeBuild パイプラインロールセクションで、既存のサービスロールを選択し、CloudFormation パイプラインロールセクションで作成したサービスロールを選択します。または、 CloudFormation パイプラインロールを割り当てていない場合は、前の 3 つのステップを繰り返して新しいサービスロールを作成します。
-
-
既存のパイプラインサービスロールを選択する
[ AWSパイプラインのマネージドプロビジョニングを有効にするには] - [アカウント設定] ページの [AWSマネージドプロビジョニングパイプラインロール] セクションで、[既存のサービスロール] を選択し、あなたの AWS アカウント内のサービスロールを選択します。
〔パイプラインの CodeBuild プロビジョニングを有効にするには] アカウント設定の設定ページで、CodeBuild パイプラインプロビジョニングロールセクションで、既存のサービスロールを選択し、 AWS アカウントのサービスロールを選択します。
-
-
[Save changes] (変更の保存) をクリックします。
新しいパイプラインサービスロールが [Account settings (アカウント設定)] ページに表示されます。
セルフマネージドプロビジョニング — パイプラインリポジトリを設定する
セルフマネージドプロビジョニングを使用すると、 は設定したプロビジョニングリポジトリにプルリクエスト (PR) AWS Proton を送信し、オートメーションコードはパイプラインのプロビジョニングを担当します。したがって、パイプラインをプロビジョニングするためにサービスロール AWS Proton は必要ありません。代わりに、登録済みのプロビジョニングリポジトリが必要です。リポジトリ内のあなたの自動化コードは、パイプラインをプロビジョニングするための権限を与える適切なロールを引き受ける必要があります。
コンソールでパイプラインプロビジョニングリポジトリを登録する
-
新しいサービス用に CI/CD パイプラインプロビジョニングリポジトリロールを作成していない場合、そのロールを作成します。セルフマネージドプロビジョニングのパイプラインの詳細については、「セルフマネージド型のプロビジョニングの働き」を参照してください。
-
ナビゲーションペインで、[Settings (設定)] を選択し、[Account settings (アカウント設定)] を選択します。
-
[アカウント CI/CD 設定] ページで、[設定] を選択します。
-
[Configure account settings] (アカウント設定の構成) ページの [CI/CD pipeline repository] (CI/CD パイプラインリポジトリ) セクションで以下の操作をします。
-
[新規リポジトリ] を選択し、リポジトリプロバイダーの 1 つを選択します。
-
CodeStar 接続の場合は、接続の 1 つを選択します。
注記
関連するリポジトリプロバイダーアカウントへの接続がまだない場合は、新しい CodeStar 接続を追加を選択し、接続作成プロセスを完了してから、CodeStar 接続メニューの横にある更新ボタンを選択します。これで、メニューであなたの新しい接続を選択できます。
-
[リポジトリ名] には、あなたのパイプラインプロビジョニングリポジトリを選択します。ドロップダウンメニューには、プロバイダーアカウントのリポジトリのリストが表示されます。
-
[ブランチ名] で、リポジトリのブランチを選択します。
-
-
[Save changes (変更の保存)] をクリックします。
あなたのパイプラインリポジトリは [アカウント設定] ページに表示されます。
のセットアップ AWS CLI
を使用して AWS CLI AWS Proton API 呼び出しを行うには、 の最新バージョンがインストールされていることを確認します AWS CLI。詳細については、AWS Command Line Interface ユーザーガイドのAWS CLIの開始を参照してください。次に、 AWS CLI で の使用を開始するには AWS Proton、「」を参照してくださいの開始方法 AWS CLI。