CodePipeline でパイプラインを編集する

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

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

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

パイプライン詳細ページで、[編集] を選択します。

パイプラインタイプを編集するには、[編集: パイプラインのプロパティ] カードで [編集: を選択します。次のいずれかのオプションを選択し、[完了] を選択します。

パイプラインのタイプによって特徴および価格が異なります。詳細については、「パイプラインのタイプ」を参照してください。

パイプライン変数を編集するには、[編集: 変数] カードの[変数の編集] を選択します。パイプラインレベルの変数を追加または変更し、[完了] を選択します。

パイプラインレベルの変数の詳細については、「変数リファレンス」を参照してください。パイプラインの実行時に渡されるパイプラインレベルの変数のチュートリアルについては、「チュートリアル: パイプラインレベルの変数を使用する」を参照してください。

パイプライントリガーを編集するには、[編集: トリガー] カードで [トリガーの編集] を選択します。トリガーを追加または変更し、[完了] を選択します。

トリガーの追加の詳細については、Bitbucket Cloud、GitHub (GitHub アプリ経由）、GitHub Enterprise Server、GitLab.com,または などの GitLab セルフマネージドへの接続を作成する手順を参照してくださいGitHub コネクション。

[編集] ページでステージとアクションを編集するには、次のいずれかの操作を行います。

たとえば、パイプラインのステージにシリアルアクションを追加する場合は、以下のようにします。

パイプラインの編集が終わったら、[保存] を選択して概要ページに戻ります。

アクションをテストするには、[Release change] を選択して、パイプラインによりそのコミットを処理し、パイプラインのソースステージで指定したソースに変更をコミットします。またはパイプラインを手動で開始する、「」の手順に従って、 AWS CLI を使用して手動で変更をリリースします。

ターミナルセッション (Linux、macOS または Unix) またはコマンドプロンプト (Windows) を開き、get-pipeline コマンドを実行して、パイプライン構造を JSON ファイルにコピーします。たとえば、MyFirstPipeline という名前のパイプラインに対して、以下のコマンドを入力します。

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

このコマンドは何も返しませんが、作成したファイルは、コマンドを実行したディレクトリにあります。

任意のプレーンテキストエディタで JSON ファイルを開き、パイプラインに加える変更を反映するようにファイルの構造を変更します。たとえば、ステージを追加または削除すること、または、既存のステージに別のアクションを追加することができます。

以下の例では、pipeline.json ファイルに別のデプロイステージを追加する方法を示しています。このステージは、Staging という名前の最初のデプロイステージの後に実行されます。

,      
        {
            "name": "Staging",
            "actions": [
                    {
                        "inputArtifacts": [
                            {
                                "name": "MyApp"
                            }
                        ],
                        "name": "Deploy-CodeDeploy-Application",
                        "actionTypeId": {
                            "category": "Deploy",
                            "owner": "AWS",
                            "version": "1",
                            "provider": "CodeDeploy"
                        },
                        "outputArtifacts": [],
                        "configuration": {
                            "ApplicationName": "CodePipelineDemoApplication",
                            "DeploymentGroupName": "CodePipelineDemoFleet"
                        },
                        "runOrder": 1
                    }
                ]
             },      
        {
            "name": "Production",
            "actions":  [
                    {
                        "inputArtifacts": [
                            {
                                "name": "MyApp"
                            }
                        ],
                        "name": "Deploy-Second-Deployment",
                        "actionTypeId": {
                            "category": "Deploy",
                            "owner": "AWS",
                            "version": "1",
                            "provider": "CodeDeploy"
                        },
                        "outputArtifacts": [],
                        "configuration": {
                        "ApplicationName": "CodePipelineDemoApplication",
                        "DeploymentGroupName": "CodePipelineProductionFleet"
                        },
                        "runOrder": 1
                    }
                ]
        }
    ]
}

CLI を使用して承認アクションをパイプラインに追加する方法については、「CodePipeline でパイプラインにマニュアルの承認アクションを追加する 」を参照してください。

JSON ファイルの PollForSourceChanges パラメータが次のように設定されていることを確認します。

                "PollForSourceChanges": "false",

CodePipeline は、Amazon CloudWatch Events を利用して、CodeCommit ソースリポジトリやブランチ、または Amazon S3 ソースバケットの変更を検出します。次のステップには、手動でこれらのリソースを作成する手順が含まれています。フラグを false に設定すると、定期的なチェックが無効になります。これは、推奨される変更検出メソッドを使用する場合には必須ではありません。

パイプラインとは異なるリージョンにビルド、テスト、またはデプロイアクションを追加するには、パイプライン構造に以下を追加する必要があります。詳細な手順については、「CodePipeline にクロスリージョンアクションを追加する」を参照してください。

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

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

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

ファイルを保存します。

パイプラインの編集に CLI を使用する場合には、推奨される変更検出リソースを手動でパイプライン用に管理する必要があります。

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

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

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

CodePipeline コンソールを開き、編集したパイプラインを選択します。

そのパイプラインには、行った変更が示されます。ソース場所を次に変更すると、修正した構造のパイプラインによりそのリビジョンが実行されます。

修正した構造のパイプラインによりその最新のリビジョンを手動で実行するには、start-pipeline-execution コマンドを実行します。詳細については、「パイプラインを手動で開始する」を参照してください。