でのセットアップ AWS Proton - AWS Proton
Amazon S3 バケットのセットアップ AWS CodeStar 接続のセットアップアカウント CI/CD パイプラインの設定のセットアップ AWS CLI

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

でのセットアップ AWS Proton

を使用して AWS Proton APIs AWS CLI を実行する場合は、インストールされていることを確認します。まだインストールしていない場合、「のセットアップ AWS CLI」を参照してください。

AWS Proton 特定の設定：

プロビジョニングの方法の詳細については、「AWSマネージドプロビジョニングの仕組み」を参照してください。

Amazon S3 バケットのセットアップ

S3 バケットを設定するには、「ユーザーの最初の S3 バケットを作成する」の手順に従って S3 バケットを設定します。入力を が取得 AWS Proton できるバケット AWS Proton に に配置します。これらの入力はテンプレートバンドルと呼ばれます。詳細については、このガイドで当該セクションを参照してください。

AWS CodeStar 接続のセットアップ

リポジトリ AWS Proton に接続するには、サードパーティーのソースコードリポジトリで新しいコミットが行われたときにパイプラインをアクティブ化する AWS CodeStar 接続を作成します。

AWS Proton は接続を使用して以下を行います。

  • ユーザーのリポジトリソースコードで新しいコミットが発生すると、サービスパイプラインがアクティブになります。

  • Infrastructure as Code リポジトリについてプルリクエストを作成します。

  • テンプレートのリポジトリにコミットがプッシュされるたびに、テンプレートのいずれかを変更する新しいテンプレートマイナーバージョンまたはメジャーバージョンを (バージョンがまだ存在しなければ) 作成します。

CodeConnections を使用して Bitbucket、GitHub、GitHub Enterprise、GitHub Enterprise Server リポジトリに接続できます。詳細については、「 AWS CodePipeline ユーザーガイド」のCodeConnections」を参照してください。

CodeStar 接続をセットアップするには

  1. AWS Proton コンソールを開きます。

  2. ナビゲーションペインで [Settings (設定)] を選択してから [Repository connections (レポジトリ接続)] を選択すると、[Developer Tools (開発者ツール)] [[Settings (設定)] の [Connections (接続)] ページが表示されます。このページには、接続のリストが表示されます。

  3. [Create connection] (接続を作成する) を選択し、指示に従って操作します。

アカウント CI/CD パイプラインの設定

AWS Proton は、アプリケーションコードをサービスインスタンスにデプロイするための CI/CD パイプラインをプロビジョニングできます。パイプラインのプロビジョニングに必要な AWS Proton 設定は、パイプラインに選択したプロビジョニング方法によって異なります。

AWSマネージドプロビジョニングと CodeBuild ベースプロビジョニング — パイプラインロールの設定

AWSマネージドプロビジョニングと CodeBuild プロビジョニングを使用すると、 はパイプラインを AWS Proton プロビジョニングします。したがって、 にはパイプラインをプロビジョニングするためのアクセス許可を提供するサービスロール AWS Proton が必要です。これら 2 つのプロビジョニング方法ではそれぞれ独自のサービスロールを使用します。これらのロールはすべての AWS Proton サービスパイプラインで共有され、アカウント設定で 1 回設定します。

コンソールでパイプラインサービスロールを作成する

  1. AWS Proton コンソールを開きます。

  2. ナビゲーションペインで、[Settings (設定)] を選択し、[Accounts settings (アカウント設定)] を選択します。

  3. [アカウント CI/CD 設定] ページで、[設定] を選択します。

  4. 次のいずれかを行います：

    • でパイプラインサービスロール AWS Proton を作成するには

      [パイプラインの AWSマネージドプロビジョニングを有効にするには] - [AWSマネージドプロビジョニングパイプラインロール] セクションの [アカウント設定の設定] ページ:

      1. [新しいサービスロール] を選択します。

      2. ロールの名前を入力します (例: myProtonPipelineServiceRole)。

      3. アカウントの管理者権限を持つ AWS Proton ロールを作成することに同意するには、チェックボックスをオンにします。

      [CodeBuild ベースのパイプラインのプロビジョニングを有効にするには] - [アカウント設定の設定] ページの [CodeBuild パイプラインロール] セクションで [既存のサービスロール] を選択し、[CloudFormation パイプラインロール] セクションで作成したサービスロールを選択します。CloudFormation パイプラインロールを割り当てていない場合は、前の 3 つのステップを繰り返して新しいサービスロールを作成します。

    • 既存のパイプラインサービスロールを選択する

      [ AWSパイプラインのマネージドプロビジョニングを有効にするには] - [アカウント設定] ページの [AWSマネージドプロビジョニングパイプラインロール] セクションで、[既存のサービスロール] を選択し、あなたの AWS アカウント内のサービスロールを選択します。

      〔パイプラインの CodeBuild プロビジョニングを有効にするには] アカウント設定の設定ページで、CodeBuild パイプラインプロビジョニングロールセクションで、既存のサービスロールを選択し、 AWS アカウントのサービスロールを選択します。

  5. [Save changes] (変更の保存) をクリックします。

    新しいパイプラインサービスロールが [Account settings (アカウント設定)] ページに表示されます。

セルフマネージドプロビジョニング — パイプラインリポジトリを設定する

セルフマネージドプロビジョニングでは、 は設定したプロビジョニングリポジトリにプルリクエスト (PR) AWS Proton を送信し、自動化コードがパイプラインのプロビジョニングを担当します。したがって、パイプラインをプロビジョニングするためにサービスロール AWS Proton は必要ありません。代わりに、登録済みのプロビジョニングリポジトリが必要です。リポジトリ内のあなたの自動化コードは、パイプラインをプロビジョニングするための権限を与える適切なロールを引き受ける必要があります。

コンソールでパイプラインプロビジョニングリポジトリを登録する

  1. 新しいサービス用に CI/CD パイプラインプロビジョニングリポジトリロールを作成していない場合、そのロールを作成します。セルフマネージドプロビジョニングのパイプラインの詳細については、「セルフマネージド型のプロビジョニングの働き」を参照してください。

  2. ナビゲーションペインで、[Settings (設定)] を選択し、[Account settings (アカウント設定)] を選択します。

  3. [アカウント CI/CD 設定] ページで、[設定] を選択します。

  4. [Configure account settings] (アカウント設定の構成) ページの [CI/CD pipeline repository] (CI/CD パイプラインリポジトリ) セクションで以下の操作をします。

    1. [新規リポジトリ] を選択し、リポジトリプロバイダーの 1 つを選択します。

    2. [CodeStar connection (CodeStar 接続)] であなたの接続のいずれかを選択します。

      注記

      関連するリポジトリプロバイダーアカウントにまだ接続していない場合は、[新しい CodeStar 接続を追加] を選択し、接続作成プロセスを完了してから、[CodeStar 接続] メニューの横にある更新ボタンを選択します。これで、メニューであなたの新しい接続を選択できます。

    3. [リポジトリ名] には、あなたのパイプラインプロビジョニングリポジトリを選択します。ドロップダウンメニューには、プロバイダーアカウントのリポジトリのリストが表示されます。

    4. [ブランチ名] で、リポジトリのブランチを選択します。

  5. [Save changes (変更の保存)] をクリックします。

    あなたのパイプラインリポジトリは [アカウント設定] ページに表示されます。

のセットアップ AWS CLI

を使用して AWS Proton API コールを行う AWS CLI には、最新バージョンの がインストールされていることを確認します AWS CLI。詳細については、AWS Command Line Interface ユーザーガイドのAWS CLIの開始を参照してください。次に、 AWS CLI で の使用を開始するには AWS Proton、「」を参照してくださいの開始方法 AWS CLI。