変数の操作

変数を使用してパイプラインを作成するには

1. AWS Management Console にサインインして、CodePipeline コンソール (https://console.aws.amazon.com/codesuite/codebuild/home) を開きます。

2. パイプラインの作成 を選択します。パイプラインに名前を入力し、[Next (次へ)] を選択します。

3. [ソース] の [プロバイダ] で、[CodeCommit] を選択します。ソースアクションの CodeCommit リポジトリとブランチを選択し、[Next (次へ)] を選択します。

4. [ビルド] の [プロバイダ] で [CodeBuild] を選択します。既存の CodeBuild ビルドプロジェクト名を選択するか、[Create project (プロジェクトを作成)] を選択します。[Create build project (ビルドプロジェクトを作成)] で、ビルドプロジェクトを作成し、[Return to CodePipeline (CodePipeline に戻る)] を選択します。

   [環境変数] の下で、[Add environment variables (環境変数を追加)] を選択します。例えば、実行 ID を変数構文 #{codepipeline.PipelineExecutionId} で入力し、コミット ID を変数構文 #{SourceVariables.CommitId} で入力します。

   注記

   変数構文は、ウィザードの任意のアクション設定フィールドに入力できます。

5. [作成] を選択します。

6. パイプラインが作成されたら、ウィザードによって作成された名前空間を表示できます。パイプラインで、名前空間を表示するステージのヘルプペインアイコンを選択します。この例では、ソースアクションの自動生成された名前空間、SourceVariables が表示されます。

   

既存のアクションの名前空間を編集するには

1. AWS Management Console にサインインして、CodePipeline コンソール (https://console.aws.amazon.com/codesuite/codebuild/home) を開きます。

2. 編集するパイプラインを選択して [編集] を選択します。ソースステージで、[Edit stage (ステージを編集)] を選択します。CodeCommit アクションを追加します。

3. [アクションの編集] で、[Variable namespace (変数の名前空間)] フィールドを表示します。既存のアクションが以前に作成された場合、またはウィザードを使用せずに作成された場合は、名前空間を追加する必要があります。[Variable namespace (変数の名前空間)] に名前空間名を入力し、[Save (保存)] を選択します。

出力変数を表示するには

1. AWS Management Console にサインインして、CodePipeline コンソール (https://console.aws.amazon.com/codesuite/codebuild/home) を開きます。

2. パイプラインが作成され、正常に実行できたら、アクションの実行詳細ページで変数の値を表示することもできます。詳細については、変数を表示する (コンソール) を参照してください。

名前空間でアクションを設定するには

1. 「パイプライン、ステージ、アクションを作成する」の手順 に従って、CLI を使用してパイプラインを作成します。入力ファイルを起動して、create-pipeline コマンドに --cli-input-json パラメータを指定します。パイプライン構造で、namespace パラメータを追加し、SourceVariables などの名前を指定します。

   . . . 
   {
             "inputArtifacts": [],
             "name": "Source",
             "region": "us-west-2",
             "namespace": "SourceVariables",
             "actionTypeId": {
               "category": "Source",
               "owner": "AWS",
               "version": "1",
               "provider": "CodeCommit"
             },
             "outputArtifacts": [
   
   . . . 

2. MyPipeline.json のような名前でファイルを保存します。

3. ターミナル (Linux、macOS、UNIX) またはコマンドプロンプト (Windows) で、create-pipelineコマンドを実行し、パイプラインを作成します。

   create-pipeline コマンドを実行したときに作成したファイルを呼び出します。例:

   aws codepipeline create-pipeline --cli-input-json file://MyPipeline.json

変数を消費するダウンストリームアクションを設定するには

1. 入力ファイルを編集して、update-pipeline コマンドに --cli-input-json パラメータを指定します。ダウンストリームアクションで、そのアクションの設定に変数を追加します。変数は、ピリオドで区切られた名前空間とキーで構成されます。たとえば、パイプライン実行 ID とソースコミット ID の変数を追加するには、変数 #{codepipeline.PipelineExecutionId} に変数の名前空間 codepipeline を指定します。変数の #{SourceVariables.CommitId} 名前空間 SourceVariables を指定します。

   {
       "name": "Build",
       "actions": [
           {
               "outputArtifacts": [
                   {
                       "name": "BuildArtifacts"
                   }
               ],
               "name": "Build",
               "configuration": {
                   "EnvironmentVariables": "[{\"name\":\"Execution_ID\",\"value\":\"#{codepipeline.PipelineExecutionId}\",\"type\":\"PLAINTEXT\"},{\"name\":\"Commit_ID\",\"value\":\"#{SourceVariables.CommitId}\",\"type\":\"PLAINTEXT\"}]",
                   "ProjectName": "env-var-test"
               },
               "inputArtifacts": [
                   {
                       "name": "SourceArtifact"
                   }
               ],
               "region": "us-west-2",
               "actionTypeId": {
                   "provider": "CodeBuild",
                   "category": "Build",
                   "version": "1",
                   "owner": "AWS"
               },
               "runOrder": 1
           }
       ]
   },

2. MyPipeline.json のような名前でファイルを保存します。

3. ターミナル (Linux、macOS、UNIX) またはコマンドプロンプト (Windows) で、create-pipelineコマンドを実行し、パイプラインを作成します。

   create-pipeline コマンドを実行したときに作成したファイルを呼び出します。例:

   aws codepipeline create-pipeline --cli-input-json file://MyPipeline.json

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

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

2. [Name] で、パイプラインの名前を選択します。

3. [View history (履歴の表示)] を選択します。

4. パイプラインが正常に実行されると、ソースアクションによって生成された変数を表示できます。[View history (履歴の表示)] を選択します。パイプライン実行のアクションリストで [ソース] を選択して、CodeCommit アクションのアクション実行の詳細を表示します。アクションの詳細画面で、[Output variables (出力変数)] の下の変数を表示します。

   

5. パイプラインが正常に実行されると、ビルドアクションによって消費される変数を表示できます。[View history (履歴の表示)] を選択します。パイプライン実行のアクションリストで、[ビルド] を選択して、CodeBuild アクションのアクション実行の詳細を表示します。アクションの詳細ページで、[アクション設定] の下にある変数を表示します。自動生成された名前空間が表示されます。

   

   デフォルトでは、[アクション設定] には変数の構文が表示されます。[Show resolved configuration (解決された設定を表示)] を選択して、アクションの実行中に生成された値を表示するようにリストを切り替えることができます。

   

1. 以下のコマンドを使用します。

   
   aws codepipeline list-action-executions

   出力には、次に示すように outputVariables パラメータが表示されます。

   "outputVariables": {
                       "BranchName": "main",
                       "CommitMessage": "Updated files for test",
                       "AuthorDate": "2019-11-08T22:24:34Z",
                       "CommitId": "d99b0083cc10EXAMPLE",
                       "CommitterDate": "2019-11-08T22:24:34Z",
                       "RepositoryName": "variables-repo"
                   },
               

2. 以下のコマンドを使用します。

   
   aws codepipeline get-pipeline --name <pipeline-name>

   CodeBuild アクションのアクション設定で、変数を表示できます。

   {
       "name": "Build",
       "actions": [
           {
               "outputArtifacts": [
                   {
                       "name": "BuildArtifact"
                   }
               ],
               "name": "Build",
               "configuration": {
                   "EnvironmentVariables": "[{\"name\":\"Execution_ID\",\"value\":\"#{codepipeline.PipelineExecutionId}\",\"type\":\"PLAINTEXT\"},{\"name\":\"Commit_ID\",\"value\":\"#{SourceVariables.CommitId}\",\"type\":\"PLAINTEXT\"}]",
                   "ProjectName": "env-var-test"
               },
               "inputArtifacts": [
                   {
                       "name": "SourceArtifact"
                   }
               ],
               "region": "us-west-2",
               "actionTypeId": {
                   "provider": "CodeBuild",
                   "category": "Build",
                   "version": "1",
                   "owner": "AWS"
               },
               "runOrder": 1
           }
       ]
   },

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

   AWS アカウントに関連付けられているすべてのパイプラインの名前が表示されます。承認を追加するパイプラインを選択します。

2. パイプラインを編集するには、[編集] を選択します。ソースアクションの後に、手動承認を追加します。[アクション名] に、承認処理の名前を入力します。

3. [アクションプロバイダ] で、[手動承認] を選択します。

4. [レビュー用の URL] で、CommitId の変数構文を CodeCommit URL に追加します。ソースアクションに割り当てられた名前空間をかならず使用してください。例えば、デフォルトの名前空間で SourceVariables CodeCommit アクションに対する変数構文は、#{SourceVariables.CommitId} です。

   [コメント] で、CommitMessage にコミットメッセージを入力します。

   Please approve this change. Commit message: #{SourceVariables.CommitMessage}

5. パイプラインが正常に実行されると、承認メッセージに変数の値を表示できます。

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

   AWS アカウントに関連付けられているすべてのパイプラインの名前が表示されます。承認を追加するパイプラインを選択します。

2. パイプラインを編集するには、[編集] を選択します。CodeBuild アクションを含むステージで、[ステージの編集] を選択します。

3. アイコンを選択して CodeBuild アクションを編集します。

4. [編集アクション] ページの 環境変数 で、次のように入力します。

   • [名前]に、環境変数の名前を入力します。

   • [値]に、パイプライン出力変数の変数構文を入力します。これには、ソースアクションに割り当てられた名前空間が含まれます。たとえば、デフォルトの名前空間で SourceVariables GitHub アクションに対する出力変数構文は、#{SourceVariables.BranchName} です。

   • [タイプ]に、プレーンテキストを選択します。

5. パイプラインが正常に実行されると、解決された出力変数が環境変数の値になることがわかります。以下のうちのひとつを選択します。

   • CodePipeline コンソール: パイプラインを選択してから、履歴 を選択します。最新のパイプライン実行を選択します。

     • [タイムライン]で、[送信元] のセレクタを選択します。これは GitHub 出力変数を生成するソースアクションです。View execution details (実行の詳細を表示)を選択 [出力変数]で、このアクションによって生成された出力変数のリストを表示します。

     • [タイムライン]で、[ビルド]のセレクタを選択します。これは、ビルドプロジェクトの CodeBuild 環境変数を指定するビルドアクションです。View execution details (実行の詳細を表示) を選択 [アクション設定]で、CodeBuild 環境変数を表示します。解決済み設定を表示 を選択。環境変数の値は解決済みです。GitHub ソースアクションから BranchName 変数を出力します。この例では、この値は main です。

       詳細については、「変数を表示する (コンソール)」を参照してください。

   • CodeBuild コンソール: ビルドプロジェクトを選択し、ビルド実行のリンクを選択します。[環境変数] の場合、解決された出力変数は CodeBuild 環境変数の値です。この例では、環境変数の値の [Name] は BranchName で、GitHub ソースアクションから [Value] 解決済み BranchName 出力変数を表示します。この例では、この値は main です。