別の AWS アカウントのリソースを使用するパイプラインを CodePipeline で作成する

AccountA AWS Management Console を使用して にサインインし、 AWS KMS コンソールを開きます。

左側で [カスタマー管理キー]を選択します。

[キーの作成] を選択します。[キーの設定] で、[対称] のデフォルトを選択したまま、[次] を選択します。

エイリアス に、このキーに使用するエイリアス(PipelineName-Keyなど)を入力します。必要に応じて、このキーの説明とタグを入力し、[次] を選択します。

[キー管理アクセス許可の定義] で、このキーの管理者となるロールを選択し、[次へ] を選択します。

[キーの利用方法許可の定義] の [このアカウント] で、パイプラインのサービスロールの名前 (例えば CodePipeline_Service_Role など) を選択します。「その他の AWS アカウント」で、「別の AWS アカウントの追加」を選択します。ARN の一部として AccountB のアカウント ID を入力し、[次へ ] を選択します。

[キーポリシーの確認と編集]で、ポリシーを確認し、[完了]を選択します。

キーのリストから、キーのエイリアスを選択し、その ARN (arn:aws:kms:us-east-2:012ID_ACCOUNT_A:key/2222222-3333333-4444-556677EXAMPLEなど) にコピーします。この ARN は、パイプラインの編集時とポリシーの設定時に必要になります。

AccountA AWS Management Console で にサインインし、https://console.aws.amazon.com/s3/ で Amazon S3 コンソールを開きます。

Amazon S3 バケットのリストで、パイプラインのアーティファクトが保存される Amazon S3バケットを選択します。このバケットの名前は です。region はパイプラインを作成した AWS リージョンでcodepipeline-region-1234567EXAMPLE、1234567EXAMPLE はバケット名が一意であることを確認する 10 桁の乱数です (例: codepipeline-us-east-2-1234567890)。

Amazon S3 バケットの詳細ページで、[Properties] を選択します。

プロパティペインで、[アクセス許可] を展開し、[バケットポリシーの追加]を選択します。

バケットポリシーエディタウィンドウで、AccountB にパイプラインアーティファクトへのアクセスを許可し、カスタムソースやビルドアクションなどのアクションがそれらを作成した場合、AccountB に出力アーティファクトを追加できるようにするポリシーを作成します。

[保存] を選択したら、ポリシーエディタを閉じます。

[保存] を選択して、Amazon S3 バケットに対するアクセス権限を保存します。

AccountA AWS Management Console で にサインインし、https://console.aws.amazon.com/iam/ で IAM コンソールを開きます。

ナビゲーションペインで [Roles(ロール)] を選択します。

[ロール名] の下にあるロールのリストで、 CodePipeline のサービスロールの名前を選択します。

[アクセス許可] タブで [インラインポリシーの追加]を選択します。

[JSON] タブをクリックし、次のポリシーを入力して許可します。 AccountB を選択してロールを引き受けることができます。次の例では、012ID_ACCOUNT_Bは、AccountBの ARN です。

[ポリシーの確認]を選択します。

[名前] に、このポリシーの名前を入力します。[Create policy]を選択します。

AccountB AWS Management Console で にサインインし、https://console.aws.amazon.com/iam/ で IAM コンソールを開きます。

ナビゲーションペインで [Roles (ロール)]を選択します。

[ロール名] の下にあるロールのリストで、 CodeDeploy アプリケーションの Amazon EC2 インスタンスロールとして使用するサービスロールの名前を選択します。このロール名はさまざまで、デプロイグループで複数のインスタンスロールを使用できます。詳細については、「Amazon EC2 インスタンスの IAM インスタンスプロファイルを作成する」を参照してください。

[Permissions] (アクセス許可) タブで [Add inline policy] (インラインポリシーの追加) を選択します。

JSON タブで、以下のポリシーを入力して、 Amazon S3 バケットへのアクセスを許可します。AccountA パイプラインのアーティファクトを保存するには (この例では、codepipeline-us-east-2-1234567890):

[ポリシーの確認]を選択します。

[名前] に、このポリシーの名前を入力します。[Create policy]を選択します。

の 2 番目のポリシーを作成します AWS KMS 。ここで、 arn:aws:kms:us-east-1:012ID_ACCOUNT_A:key/2222222-3333333-4444-556677EXAMPLEは AccountA で作成され、AccountB が使用できるように設定されたカスタマーマネージドキーの ARN です。

[ポリシーの確認]を選択します。

[名前] に、このポリシーの名前を入力します。[Create policy]を選択します。

AccountB AWS Management Console で にサインインし、https://console.aws.amazon.com/iam で IAM コンソールを開きます。

ナビゲーションペインで Roles (ロール) を選択してください。[ロールの作成] を選択します。

[Select type of trusted entity](信頼できるエンティティのタイプを選択) で、[Another AWS account](別のアカウント) を選択します。このロールを使用できるアカウントを指定する のアカウント ID に、CodePipeline ( AWS AccountAccountA) でパイプラインを作成するアカウントのアカウント ID を入力し、次へ: アクセス許可を選択します。

[Attach permissions policies (アクセス許可ポリシーのアタッチ)] ページで、[AmazonS3ReadOnlyAccess]、[Next :タグ] の順に選択します。

[Next: Review (次へ: レビュー)]を選択します。ロール名 に (CrossAccount_Roleなど) のロールを名前に入力します。IAMの命名規則に従う限り、このロールの名前は任意に指定できます。ロールの目的が明確になる名前を付けることを検討してください。[Create Role]を選択します。

ロールのリストから、作成したポリシー (CrossAccount_Role など) を選択して、そのロールの [Summary] ページを開きます。

[Permissions] (アクセス許可) タブで [Add inline policy] (インラインポリシーの追加) を選択します。

[JSON] タブで、以下のポリシーを入力して、CodeDeploy リソースへのアクセスを許可します。

[ポリシーの確認]を選択します。

[名前] に、このポリシーの名前を入力します。[ Create policy]を選択します。

[Permissions] (アクセス許可) タブで [Add inline policy] (インラインポリシーの追加) を選択します。

[JSON] タブを選択し、 以下のポリシーを入力して、このロールに AccountA の Amazon S3 バケットに対する入力アーティファクトの取得と出力アーティファクトの保存を許可します。

[ポリシーの確認]を選択します。

[名前] に、このポリシーの名前を入力します。[Create policy]を選択します。

リポジトリの [アクセス許可] タブで、[ポリシー名]から AmazonS3ReadOnlyAccess を探して、ポリシーの横にある[削除] アイコン (X) を選択します。プロンプトが表示されたら、[Detach]を選択します。

[信頼関係] タブ、[信頼ポリシーを編集] の順に選択します。左側の列で [プリンシパルを追加] オプションを選択します。[プリンシパルタイプ] で、[IAM ロール] を選択し、AccountA の CodePipeline サービスロールの ARN を指定します。[AWS プリンシパル] のリストから arn:aws:iam::Account_A:root を削除し、[ポリシーを更新] を選択します。

ターミナル ( Linux, macOS , or Unix ) またはコマンドプロンプト ( Windows ) で、リソースを追加するパイプラインに対して get-pipeline コマンドを実行します。コマンドの出力を JSON ファイルにコピーします。例えば、MyFirstPipeline という名前のパイプラインに対しては、以下のようなコマンドを入力します。

aws codepipeline get-pipeline --name MyFirstPipeline >pipeline.json

出力は、pipeline.json ファイルを開きます。

任意のプレーンテキストエディタで JSON ファイルを開きます。アーティファクトストアの "type": "S3" の後に、KMS 暗号化キー、ID、タイプ情報を追加します。ここで、codepipeline-us-east-2-1234567890 は、Amazon S3 バケット名で使用されるパイプラインのアーティファクトの保存にされ、arn:aws:kms:us-east-1:012ID_ACCOUNT_A:key/2222222-3333333-4444-556677EXAMPLE は、先ほど作成したカスタマー管理キーの ARN です。

{
  "artifactStore”: {
    "location": "codepipeline-us-east-2-1234567890", 
    "type": "S3",
    "encryptionKey": {
      "id": "arn:aws:kms:us-east-1:012ID_ACCOUNT_A:key/2222222-3333333-4444-556677EXAMPLE",
      "type": "KMS"
    }
  },

AccountB に関連付けられている CodeDeploy リソースを使用するためのデプロイアクションをステージに追加して、roleArn 値など作成したクロスアカウントロール (CrossAccount_Role) に指定します。

以下の例では、ExternalDeployという名前のデプロイアクションを追加する JSON を示しています。また、AccountBで作成された CodeDeploy リソースを Staging という名前のステージで使用しています。以下の例では、AccountBの ARN は012ID_ACCOUNT_Bです。

,
            {
                "name": "Staging",
                "actions": [
                    {
                        "inputArtifacts": [
                            {
                                "name": "MyAppBuild"
                            }
                        ],
                        "name": "ExternalDeploy",
                        "actionTypeId": {
                            "category": "Deploy",
                            "owner": "AWS",
                            "version": "1",
                            "provider": "CodeDeploy"
                        },
                        "outputArtifacts": [],
                        "configuration": {
                            "ApplicationName": "AccountBApplicationName",
                            "DeploymentGroupName": "AccountBApplicationGroupName"
                        },
                        "runOrder": 1,
                        "roleArn": "arn:aws:iam::012ID_ACCOUNT_B:role/CrossAccount_Role"
                    }
                ]
            }

metadata コマンドが使用できるように、ファイルから update-pipeline 行を削除する必要があります。JSON ファイルのパイプライン構造からセクションを削除します ("metadata": { } 行と、"created"、"pipelineARN"、および"updated"フィールド)。

例えば、構造から以下の行を削除します。

"metadata": {  
  "pipelineArn": "arn:aws:codepipeline:region:account-ID:pipeline-name",
  "created": "date",
  "updated": "date"
  }

ファイルを保存します。

変更を適用するには、以下のように、パイプライン JSON ファイルを指定して、 update-pipeline コマンドを実行します。

aws codepipeline update-pipeline --cli-input-json file://pipeline.json

このコマンドは、編集したパイプラインの構造全体を返します。

ターミナル ( Linux, macOS , or Unix ) またはコマンドプロンプト ( Windows ) で、以下のように、パイプラインの名前を指定して、start-pipeline-execution コマンドを実行します。

aws codepipeline start-pipeline-execution --name MyFirstPipeline

詳細については、「パイプラインを手動で開始する」を参照してください。

AccountA AWS Management Console で にサインインし、http://console.aws.amazon.com/codesuite/codepipeline/home で CodePipeline コンソールを開きます。

AWS アカウントに関連付けられているすべてのパイプラインの名前が表示されます。

[Name]で、先ほど編集したパイプラインの名前を選択します。これにより、パイプラインの詳細ビューが開いて、パイプラインの各ステージの各アクションの状態などがわかります。

パイプラインの進行状況を監視します。別の AWS アカウントに関連付けられたリソースを使用するアクションの成功メッセージを待ちます。