環境を作成する

AWS Proton コンソールで、[環境] を選択します。

[Create environment (環境の作成)] を選択します。

[Choose an environment template (環境テンプレートを選択する)] ページでテンプレートを選択して [Configure (設定)] を選択します。

[Configure environment (環境を設定する)] ページの [Provisioning (プロビジョニング)] セクションで [AWS マネージドプロビジョニング] を選択します。

[Deployment account (デプロイアカウント)] セクションで、[この AWS アカウント] を選択します。

[Configure environment (環境の設定)] ページの [Environment settings (環境設定)] セクションで [Environment name] に環境名を入力します。

(オプション) この環境についての説明を入力します。

[Environment roles (環境ロール)] セクションで、AWS Proton サービスロールの設定 の一部としてあなたが作成した AWS Proton サービスロールを選択します。

(オプション) [コンポーネントロール] セクションで、直接定義したコンポーネントを環境内で実行できるようにするサービスロールを選択し、プロビジョニングできるリソースの範囲を絞り込みます。詳細については、「AWS Proton コンポーネント」を参照してください。

(オプション) [Tags (タグ)] セクションで [Add new tag (新しいタグを追加)] を選択し、キーと値を入力してカスタマーマネージドタグを作成します。

[Next (次へ)] を選択します。

[Configure environment custom settings (環境カスタム設定の構成)] ページでは、required パラメータの値を入力してください。optional パラメータの値を入力するか、表示されるデフォルト値を使用します。

[Next (次へ)] を選択して入力を見直します。

[Create (作成)] を選択します。

環境の詳細とステータス、ならびに環境に関する AWS マネージドタグとカスタマーマネージドタグ。

ナビゲーションペインで [Environments (環境)] を選択します。

新しいページには、ステータスやその他の環境の詳細とともに環境のリストが表示されます。

環境アカウント内で環境アカウント接続を作成し、それを使用して管理アカウントへの接続リクエストを送信します。

1. AWS Proton コンソールでナビゲーションペインにある [Environment account connections (環境アカウント接続)] を選択します。

2. [Environment account connections (環境アカウント接続)] ページで[Request to connect (接続のリクエスト)] を選択します。

   注記

   [Environment account connection (環境アカウント接続ページ)] の見出しに挙がっているアカウント ID が、事前に識別されたあなたの環境アカウント ID と一致することを確認してください。

3. [Request to connect (接続のリクエスト)] ページでの [Environment role (環境ロール)] セクションで [Existing service role (既存のサービスロール)] および環境用に作成したサービスロールの名前を選択します。

4. 「管理アカウントへの接続」セクションに、環境の管理アカウント ID と環境名を入力します AWS Proton 。後で使用できるように名前をコピーします。

5. ページの右下にある [Request to connect (接続のリクエスト)] を選択します。

6. リクエストは [Environment connections sent to a management account (管理アカウントに送信される環境接続)] テーブルに [Pending] (保留中) として表示され、モーダルに管理アカウントからのリクエストを受け入れる方法が示されます。

管理アカウント内で、環境アカウントからの接続リクエストを受け入れ諾ます。

1. 管理アカウントにログインし、 AWS Proton コンソールで環境アカウント接続を選択します。

2. [Environment account connections (環境アカウント接続の)] ページの [Environment account connection requests (環境アカウント接続リクエスト)] テーブルで、事前に識別された環境アカウント ID と一致する環境アカウント ID を持つ環境アカウント接続を選択します。

   注記

   [Environment account connection (環境アカウント接続ページ)] の見出しに挙がっているアカウント ID が、事前に識別されたあなたの管理アカウント ID と一致することを確認してください。

3. [Accept (承諾)] を選択します。ステータスが [Pending (保留中)] から [Connected (接続済み)] に変わります。

管理アカウント内で環境を作成します。

1. ナビゲーションペインで [Environment templates (環境テンプレート)] を選択します。

2. [Environment templates (環境テンプレート)] ページで [Create environment template (環境テンプレートを作成する)] を選択します。

3. [Choose an environment template (環境テンプレートを選択する)] ページで環境テンプレートを選択します。

4. [Configure environment (環境を設定する)] ページの [Provisioning (プロビジョニング)] セクションで [AWS マネージドプロビジョニング] を選択します。

5. デプロイアカウントセクションで、別の AWS アカウントを選択します。

6. [Environment details (環境の詳細)] セクションで、[環境アカウント接続] と [環境名] を選択します。

7. [Next (次へ)] をクリックします。

8. フォームに必要な値を入力し、[Review and Create (確認と作成)] ページが表示されるまで [Next (次へ)] を選択します。

9. 内容を見直して [Create environment (環境を作成する)] を選択します。

AWS Proton コンソールで、[環境] を選択します。

[Create environment (環境の作成)] を選択します。

[Choose an environment template (環境テンプレートを選択する)] ページで、Terraform テンプレートを選択して [Configure (設定)] を選択します。

[Configure environment (環境を設定する)] ページの [Provisioning] (プロビジョニング)] セクションで [Self-managed provisioning (セルフマネージドプロビジョニング)] を選択します。

[プロビジョニングリポジトリの詳細] セクション:

1. プロビジョニングリポジトリをまだリンク AWS Protonしていない場合は、新しいリポジトリを選択し、リポジトリプロバイダーの 1 つを選択し、CodeStar 接続の場合は接続の 1 つを選択します。

   注記

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

   リポジトリを既にリンクしている場合は AWS Proton、「既存のリポジトリ」を選択します。

2. [Repository name (リポジトリ名)] で、リポジトリを選択します。ドロップダウンメニューには、既存のリポジトリの場合はリンクされたリポジトリ、新規リポジトリの場合はプロバイダーアカウントのリポジトリのリストが表示されます。

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

[Environment Settings (環境の設定)] セクションで [Environment name] に環境名を入力します。

(オプション) この環境についての説明を入力します。

(オプション) [Tags (タグ)] セクションで [Add new tag (新しいタグを追加)] を選択し、キーと値を入力してカスタマーマネージドタグを作成します。

[Next (次へ)] を選択します。

[Configure environment custom settings (環境カスタム設定の構成)] ページでは、required パラメータの値を入力してください。optional パラメータの値を入力するか、表示されるデフォルト値を使用します。

[Next (次へ)] を選択して入力内容を見直します。

[Create (作成)] を選択してプルリクエストを送信します。

環境の詳細とステータス、環境の AWS マネージドタグとカスタマーマネージドタグを表示します。

ナビゲーションペインで [Environments (環境)] を選択します。

新しいページには、ステータスやその他の環境の詳細とともに環境のリストが表示されます。

環境を作成し、見直しと承認の対象としてリポジトリにプルリクエストを送信します。

次の例では、環境テンプレートスキーマファイルに基づいて 2 つの入力値を定義する YAML 形式の仕様ファイルを示します。get-environment-template-minor-version コマンドを実行して、環境テンプレートスキーマを表示します。

仕様:

proton: EnvironmentSpec
spec:
  ssm_parameter_value: "test"

次のコマンドを実行して、環境を作成します。

$ aws proton create-environment \
    --name "pr-environment" \
    --template-name "pr-env-template" \
    --template-major-version "1" \
    --provisioning-repository="branch=main,name=myrepos/env-repo,provider=GITHUB" \
    --spec "file://env-spec.yaml"

レスポンス:>

{
    "environment": {
        "arn": "arn:aws:proton:region-id:123456789012:environment/pr-environment",
        "createdAt": "2021-11-18T17:06:58.679000+00:00",
        "deploymentStatus": "IN_PROGRESS",
        "lastDeploymentAttemptedAt": "2021-11-18T17:06:58.679000+00:00",
        "name": "pr-environment",
        "provisioningRepository": {
            "arn": "arn:aws:proton:region-id:123456789012:repository/github:myrepos/env-repo",
            "branch": "main",
            "name": "myrepos/env-repo",
            "provider": "GITHUB"
        },
        "templateName": "pr-env-template"
    }

リクエストを見直します。

プロビジョニングステータスを非同期的に に提供します AWS Proton。次の の例では AWS Proton 、プロビジョニングが成功したことを に通知します。

$ aws proton notify-resource-deployment-status-change \
    --resource-arn "arn:aws:proton:region-id:123456789012:environment/pr-environment" \
    --status "SUCCEEDED"