パイプラインの詳細と履歴を表示する (CLI) - AWS CodePipeline

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

パイプラインの詳細と履歴を表示する (CLI)

パイプラインとパイプラインの実行の詳細を表示するには、以下のコマンドを実行します。

  • list-pipelines コマンドは、AWS アカウントに関連付けられているすべてのパイプラインの概要を表示します。

  • get-pipeline コマンドは、1 つのパイプラインの詳細を表示します。

  • list-pipeline-executions パイプラインの最新の実行の概要を取得します。

  • get-pipeline-execution パイプラインの実行に関する情報 (アーティファクト、パイプラインの実行 ID、パイプラインの名前、バージョン、ステータスなど) を表示します。

  • get-pipeline-state コマンドでパイプライン、ステージ、およびアクションのステータスを表示します。

  • list-action-executions でパイプラインのアクション実行の詳細を表示します。

パイプラインを表示する (CLI)

パイプラインの詳細を表示できます。

  1. ターミナル (Linux、macOS、Unix) またはコマンドプロンプト (Windows) を開き、AWS CLI を使用して list-pipelines のコマンドを実行します。

    aws codepipeline list-pipelines

    このコマンドは、AWS アカウントに関連付けられているすべてのパイプラインのリストを返します。

  2. パイプラインの詳細を表示するには、パイプラインの一意の名前を指定して、get-pipeline コマンドを実行します。例えば、MyFirstPipeline という名前のパイプラインの詳細を表示するには、以下のように入力します:

    aws codepipeline get-pipeline --name MyFirstPipeline

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

実行の履歴を表示する (CLI)

パイプラインの実行履歴を表示できます。

  • パイプラインの過去の実行の詳細を表示するには、パイプラインの一意の名前を指定して、list-pipeline-executions コマンドを実行します。例えば、MyFirstPipeline という名前のパイプラインの現在の状態の詳細を表示するには、以下のように入力します:

    aws codepipeline list-pipeline-executions --pipeline-name MyFirstPipeline

    このコマンドは、履歴が記録されたすべてのパイプライン実行に関する概要情報を返します。概要には、開始時刻と終了時刻、期間、ステータスが含まれます。

    以下の例では、3 つの実行があった MyFirstPipeline という名前のパイプラインについて返されたデータを示しています。

    { "pipelineExecutionSummaries": [ { "lastUpdateTime": 1496380678.648, "pipelineExecutionId": "7cf7f7cb-3137-539g-j458-d7eu3EXAMPLE", "startTime": 1496380258.243, "status": "Succeeded" }, { "lastUpdateTime": 1496591045.634, "pipelineExecutionId": "3137f7cb-8d494hj4-039j-d84l-d7eu3EXAMPLE", "startTime": 1496590401.222, "status": "Succeeded" }, { "lastUpdateTime": 1496946071.6456, "pipelineExecutionId": "4992f7jf-7cf7-913k-k334-d7eu3EXAMPLE", "startTime": 1496945471.5645, "status": "Succeeded" } ] }

    パイプラインの実行について詳細を表示するには、パイプライン実行の一意の ID を指定して、get-pipeline-execution コマンドを実行します。例えば、前の例の最初の実行の詳細を表示するには、以下のように入力します。

    aws codepipeline get-pipeline-execution --pipeline-name MyFirstPipeline --pipeline-execution-id 7cf7f7cb-3137-539g-j458-d7eu3EXAMPLE

    このコマンドは、パイプラインの実行の概要情報 (アーティファクトの詳細、パイプラインの実行 ID、名前、バージョン、パイプラインのステータスなど) を返します。

    以下の例では、MyFirstPipeline という名前のパイプラインについて返されたデータを示しています。

    { "pipelineExecution": { "pipelineExecutionId": "3137f7cb-7cf7-039j-s83l-d7eu3EXAMPLE", "pipelineVersion": 2, "pipelineName": "MyFirstPipeline", "status": "Succeeded", "artifactRevisions": [ { "created": 1496380678.648, "revisionChangeIdentifier": "1496380258.243", "revisionId": "7636d59f3c461cEXAMPLE8417dbc6371", "name": "MyApp", "revisionSummary": "Updating the application for feature 12-4820" } ] } }

実行のステータスを表示する (CLI)

CLI を使って パイプライン、ステージ、およびアクションのステータスを 表示できます。

  • パイプラインの現在の状態の詳細を表示するには、パイプラインの一意の名前を指定して、get-pipeline-state コマンドを実行します。例えば、MyFirstPipeline という名前のパイプラインの現在の状態の詳細を表示するには、以下のように入力します:

    aws codepipeline get-pipeline-state --name MyFirstPipeline

    このコマンドは、パイプラインのすべてのステージの現在のステータスと、それらのステージでのアクションのステータスを返します。

    以下の例では、MyFirstPipeline という名前の 3 ステージパイプラインについて返されたデータを示しています。ここでは、最初と 2 番目のステージとアクションは成功を示し、3 つ目のステージとアクションは失敗を示しており、2 番目と 3 番目のステージ間の遷移は無効です。

    { "updated": 1427245911.525, "created": 1427245911.525, "pipelineVersion": 1, "pipelineName": "MyFirstPipeline", "stageStates": [ { "actionStates": [ { "actionName": "Source", "entityUrl": "https://console.aws.amazon.com/s3/home?#", "latestExecution": { "status": "Succeeded", "lastStatusChange": 1427298837.768 } } ], "stageName": "Source" }, { "actionStates": [ { "actionName": "Deploy-CodeDeploy-Application", "entityUrl": "https://console.aws.amazon.com/codedeploy/home?#", "latestExecution": { "status": "Succeeded", "lastStatusChange": 1427298939.456, "externalExecutionUrl": "https://console.aws.amazon.com/?#", "externalExecutionId": ""c53dbd42-This-Is-An-Example"", "summary": "Deployment Succeeded" } } ], "inboundTransitionState": { "enabled": true }, "stageName": "Staging" }, { "actionStates": [ { "actionName": "Deploy-Second-Deployment", "entityUrl": "https://console.aws.amazon.com/codedeploy/home?#", "latestExecution": { "status": "Failed", "errorDetails": { "message": "Deployment Group is already deploying deployment ...", "code": "JobFailed" }, "lastStatusChange": 1427246155.648 } } ], "inboundTransitionState": { "disabledReason": "Disabled while I investigate the failure", "enabled": false, "lastChangedAt": 1427246517.847, "lastChangedBy": "arn:aws:iam::80398EXAMPLE:user/CodePipelineUser" }, "stageName": "Production" } ] }

受信実行のステータス(CLI)を表示します。

インバウンドの実行のステータスを表示するのに、CLI を使用できます。トランジションが有効な場合、またはステージが使用可能な場合、InProgress であるインバウンド実行が続き、ステージを入力します。Stopped のステータスを用いたインバウンド実行は、ステージを入力しません。パイプラインが編集されている場合、インバウンド実行ステータスは Failed に変わります。パイプラインを編集すると、進行中のすべての実行は続行されず、実行ステータスは Failed に変わります。

  • パイプラインの現在の状態の詳細を表示するには、パイプラインの一意の名前を指定して、get-pipeline-state コマンドを実行します。例えば、MyFirstPipeline という名前のパイプラインの現在の状態の詳細を表示するには、以下のように入力します:

    aws codepipeline get-pipeline-state --name MyFirstPipeline

    このコマンドは、パイプラインのすべてのステージの現在のステータスと、それらのステージでのアクションのステータスを返します。出力には、各ステージのパイプライン実行 ID、および、無効なトランジションを持つステージのインバウンド実行 ID があるかどうかも表示されます。

    以下の例では、MyFirstPipeline という名前の 2 ステージのパイプラインについて返されたデータを示しています。ここでは、第 1 ステージが有効なトランジションと成功したパイプライン実行を示し、Beta と名付けられた第 2 ステージが無効なトランジションとインバウンド実行 ID を示しています。インバウンドの実行は InProgressStopped、またはFAILED の状態を持つことができます。

    { "pipelineName": "MyFirstPipeline", "pipelineVersion": 2, "stageStates": [ { "stageName": "Source", "inboundTransitionState": { "enabled": true }, "actionStates": [ { "actionName": "SourceAction", "currentRevision": { "revisionId": "PARcnxX_u0SMRBnKh83pHL09.zPRLLMu" }, "latestExecution": { "actionExecutionId": "14c8b311-0e34-4bda-EXAMPLE", "status": "Succeeded", "summary": "Amazon S3 version id: PARcnxX_u0EXAMPLE", "lastStatusChange": 1586273484.137, "externalExecutionId": "PARcnxX_u0EXAMPLE" }, "entityUrl": "https://console.aws.amazon.com/s3/home?#" } ], "latestExecution": { "pipelineExecutionId": "27a47e06-6644-42aa-EXAMPLE", "status": "Succeeded" } }, { "stageName": "Beta", "inboundExecution": { "pipelineExecutionId": "27a47e06-6644-42aa-958a-EXAMPLE", "status": "InProgress" }, "inboundTransitionState": { "enabled": false, "lastChangedBy": "USER_ARN", "lastChangedAt": 1586273583.949, "disabledReason": "disabled" }, "currentRevision": { "actionStates": [ { "actionName": "BetaAction", "latestExecution": { "actionExecutionId": "a748f4bf-0b52-4024-98cf-EXAMPLE", "status": "Succeeded", "summary": "Deployment Succeeded", "lastStatusChange": 1586272707.343, "externalExecutionId": "d-KFGF3EXAMPLE", "externalExecutionUrl": "https://us-west-2.console.aws.amazon.com/codedeploy/home?#/deployments/d-KFGF3WTS2" }, "entityUrl": "https://us-west-2.console.aws.amazon.com/codedeploy/home?#/applications/my-application" } ], "latestExecution": { "pipelineExecutionId": "f6bf1671-d706-4b28-EXAMPLE", "status": "Succeeded" } } ], "created": 1585622700.512, "updated": 1586273472.662 }

ソースリビジョンを表示する (CLI)

パイプラインの実行に使用するソースアーティファクト (パイプラインの最初のステージで生成された出力アーティファクト) に関する詳細を表示できます。この詳細には、コミット ID、チェックインコメント、アーティファクト作成後または更新後の時間、CLI の使用時間、ビルドアクションのバージョン番号などの識別子が含まれます。一部のリビジョンタイプでは、アーティファクトバージョンのコミットの URL を表示して開くことができます。ソースのリビジョンは、以下で構成されます。

  • 概要: アーティファクトの最新のリビジョンに関する概要。GitHub および AWS CodeCommit リポジトリの場合は、コミットメッセージ。Amazon S3 バケットまたはアクションの場合は、オブジェクトメタデータに指定された codepipeline-artifact-revision-summary キーのユーザー指定コンテンツ。

  • revisionUrl: アーティファクトリビジョンのコミット ID。GitHub または AWS CodeCommit リポジトリに保存されているアーティファクトの場合、コミット ID はコミットの詳細ページにリンクされています。

get-pipeline-execution コマンドを実行して、パイプライン実行で追加された最新のソースリビジョンに関する情報を表示できます。get-pipeline-state コマンドを実行して、パイプラインのすべてのステージに関する詳細を取得したら、ソースリビジョンの詳細を必要とするステージに適用される実行 ID を特定します。次に、その実行 ID を get-pipeline-execution コマンドで使用します (パイプラインのステージは、別のパイプラインの実行時に正常に完了している場合があるため、別の実行 ID が割り当てられていることがあります。)

つまり、Staging ステージに現在あるアーティファクトに関する詳細を表示する場合は、get-pipeline-state コマンドを実行し、Staging ステージの現在の実行 ID を特定してから、その実行 ID を使用して get-pipeline-execution コマンドを実行します。

パイプラインのソースリビジョンを表示するには

  1. ターミナル (Linux、macOS、Unix) またはコマンドプロンプト (Windows) を開き、AWS CLI を使用して get-pipeline-state のコマンドを実行します。MyFirstPipeline という名前のパイプラインののために、以下のように入力します:

    aws codepipeline get-pipeline-state --name MyFirstPipeline

    このコマンドは、各ステージの最新のパイプライン実行 ID を含む、パイプラインの最新の状態を返します。

  2. パイプライン実行の詳細を表示するには、get-pipeline-execution コマンドを実行します。この場合、パイプラインの一意の名前と、アーティファクトの詳細を表示する特定の実行のパイプライン実行 ID を指定します。例えば、名前が MyFirstPipeline で、実行 ID が 3137f7cb-7cf7-039j-s83l-d7eu3EXAMPLE のパイプラインの実行に関する詳細を表示するには、以下のように入力します:

    aws codepipeline get-pipeline-execution --pipeline-name MyFirstPipeline --pipeline-execution-id 3137f7cb-7cf7-039j-s83l-d7eu3EXAMPLE

    このコマンドは、パイプライン実行の一部である各ソースリビジョンに関する情報と、パイプラインを識別する情報を返します。実行に含まれていたパイプラインステージに関する情報のみが含まれます。パイプライン実行の一部ではなかった、パイプラインの他のステージが存在する可能性があります。

    以下の例は、MyFirstPipeline という名前のパイプラインの一部に対して返されたデータを示します。ここで、"MyApp" という名前のアーティファクトは GitHub リポジトリに保存されています。

  3. { "pipelineExecution": { "artifactRevisions": [ { "created": 1427298837.7689769, "name": "MyApp", "revisionChangeIdentifier": "1427298921.3976923", "revisionId": "7636d59f3c461cEXAMPLE8417dbc6371", "revisionSummary": "Updating the application for feature 12-4820", "revisionUrl": "https://api.github.com/repos/anycompany/MyApp/git/commits/7636d59f3c461cEXAMPLE8417dbc6371" } //More revisions might be listed here ], "pipelineExecutionId": "3137f7cb-7cf7-039j-s83l-d7eu3EXAMPLE", "pipelineName": "MyFirstPipeline", "pipelineVersion": 2, "status": "Succeeded" } }

アクション実行を表示する (CLI)

パイプラインのアクションの実行に関する詳細として、アクションの実行 ID、入力アーティファクト、出力アーティファクト、実行結果、ステータスなどを表示できます。パイプライン実行のアクションのリストを取得するには、実行 ID フィルターを指定します。

注記

詳細な実行履歴は 2019 年 2 月 21 日以降に実行されたものについて利用できます。

  • パイプラインのアクションの実行を表示するには、以下のいずれかを実行します。

    • パイプラインのすべてのアクション実行に関する詳細を表示するには、パイプラインの一意の名前を指定して、list-action-executions コマンドを実行します。例えば、MyFirstPipeline という名前のパイプラインについてアクションの実行を表示するには、以下のように入力します:

      aws codepipeline list-action-executions --pipeline-name MyFirstPipeline

      以下は、このコマンドの出力例の一部です。

      { "actionExecutionDetails": [ { "actionExecutionId": "ID", "lastUpdateTime": 1552958312.034, "startTime": 1552958246.542, "pipelineExecutionId": "Execution_ID", "actionName": "Build", "status": "Failed", "output": { "executionResult": { "externalExecutionUrl": "Project_ID", "externalExecutionSummary": "Build terminated with state: FAILED", "externalExecutionId": "ID" }, "outputArtifacts": [] }, "stageName": "Beta", "pipelineVersion": 8, "input": { "configuration": { "ProjectName": "java-project" }, "region": "us-east-1", "inputArtifacts": [ { "s3location": { "bucket": "codepipeline-us-east-1-ID", "key": "MyFirstPipeline/MyApp/Object.zip" }, "name": "MyApp" } ], "actionTypeId": { "version": "1", "category": "Build", "owner": "AWS", "provider": "CodeBuild" } } }, . . .
    • パイプラインの実行についてすべてのアクションの実行を表示するには、パイプラインの一意の名前と実行 ID を指定して、list-action-executions コマンドを実行します。例えば、Execution_ID のアクションの実行を表示するには、以下のように入力します。

      aws codepipeline list-action-executions --pipeline-name MyFirstPipeline --filter pipelineExecutionId=Execution_ID
    • 以下は、このコマンドの出力例の一部です。

      { "actionExecutionDetails": [ { "stageName": "Beta", "pipelineVersion": 8, "actionName": "Build", "status": "Failed", "lastUpdateTime": 1552958312.034, "input": { "configuration": { "ProjectName": "java-project" }, "region": "us-east-1", "actionTypeId": { "owner": "AWS", "category": "Build", "provider": "CodeBuild", "version": "1" }, "inputArtifacts": [ { "s3location": { "bucket": "codepipeline-us-east-1-ID", "key": "MyFirstPipeline/MyApp/Object.zip" }, "name": "MyApp" } ] }, . . .