Menu
AWS CodePipeline
User Guide (API Version 2015-07-09)

View Pipelines in AWS CodePipeline

You can use the AWS CodePipeline console or the AWS CLI to view details about pipelines associated with your AWS account.

View a Pipeline (Console)

You can use the AWS CodePipeline console to view a list of all of the pipelines in your account. You can also view details for each pipeline, including when actions last ran in the pipeline, whether a transition between stages is enabled or disabled, whether any actions have failed, and other information.

Note

After an hour, the detailed view of a pipeline will stop refreshing automatically in your browser. To view current information, refresh the page.

To view a pipeline

  1. Sign in to the AWS Management Console and open the AWS CodePipeline console at http://console.aws.amazon.com/codepipeline.

    The names of all pipelines associated with your AWS account will be displayed.

  2. To see details for a single pipeline, in Name, choose the name of the pipeline. This opens a detailed view of the pipeline, including the state of each action in each stage and the state of the transitions.

    Note

    It might take a few seconds for changes to appear in the AWS CodePipeline console.

    
                        The console view of the pipeline indicates the state of each action
                            in each stage and the state of the transitions.

    The graphical view displays the following information for each stage:

    • The name of the stage.

    • Every action configured for the stage.

    • The state of transitions between stages (enabled or disabled), as indicated by the state of the arrow between stages. An enabled transition is indicated by a plain arrow; a disabled transition is indicated by a gray arrow and icon.

    The graphical view also displays the following information about actions in each stage:

    • The name of the action.

    • The provider of the action, such as AWS CodeDeploy.

    • When the action was last run.

    • Whether the action succeeded or failed.

    • Links to other details about the last run of the action, where available.

    • Details about the source revisions that are running through the latest pipeline execution in the stage or, for AWS CodeDeploy deployments, the latest source revisions that were deployed to target instances.

  3. To see the configuration details for a particular action in a stage of a pipeline, choose or hover over the information icon next to that action.

  4. To view the details of the provider of the action, choose the name of the provider. This will open the AWS console page for that provider. For example, in the preceding example pipeline, choosing AWS CodeDeploy in either the Staging or Production stages will open the AWS CodeDeploy console page for the deployment group configured for that stage.

  5. To see the progress details for a particular action in a stage, choose Details when it is displayed next to an action in progress (indicated by an In Progress message). If the action is in progress, you will see the incremental progress and the steps or actions as they occur.

    Note

    Details are available for source actions involving GitHub repositories, but not those involving Amazon S3 buckets or AWS CodeCommit repositories.

  6. To approve or reject actions that have been configured for manual approval, choose Review.

  7. To retry actions in a stage that were not completed successfully, choose Retry.

  8. To get more information about errors or failures for a completed action in a stage, choose Details. You will see details from the last time the action ran, including the results of that action, Succeeded or Failed.

  9. To view details about source artifacts (output artifact that originated in the first stage of a pipeline) that are used the latest pipeline execution for a stage, click in the details information area at the bottom of the stage. You can view details about identifiers, such as commit IDs, check-in comments, and the time since the artifact was created or updated. For more information, see View Current Source Revision Details in a Pipeline.

View a Pipeline (CLI)

You can run the list-pipelines command to view a summary of all of the pipelines associated with your AWS account or the get-pipeline command to review details of a single pipeline, respectively.

Note

For information about using the CLI to view details about the source revisions used in the latest pipeline execution for a stage, see View Current Source Revision Details in a Pipeline (CLI).

To view a pipeline

  1. Open a terminal (Linux, macOS, or Unix) or command prompt (Windows) and use the AWS CLI to run the list-pipelines command, as follows:

    Copy
    aws codepipeline list-pipelines

    This command returns a list of all of the pipelines associated with your AWS account.

  2. To view details about a pipeline, run the get-pipeline command, specifying the unique name of the pipeline. For example, to view details about a pipeline named MyFirstPipeline, you would type the following:

    Copy
    aws codepipeline get-pipeline --name MyFirstPipeline

    This command returns the structure of the pipeline.

  3. To view details about the current state of a pipeline, run the get-pipeline-state command, specifying the unique name of the pipeline. For example, to view details about the current state of a pipeline named MyFirstPipeline, you would type the following:

    Copy
    aws codepipeline get-pipeline-state --name MyFirstPipeline

    This command returns the current status of all stages of the pipeline and the status of the actions within those stages.

    The following example shows the returned data for a three-stage pipeline named MyFirstPipeline, where the first two stages and actions show success, the third shows failure, and the transition between the second and third stages is disabled:

    Copy
    { "updated": 1427245911.5250001, "created": 1427245911.5250001, "pipelineVersion": 1, "pipelineName": "MyFirstPipeline", "stageStates": [ { "actionStates": [ { "actionName": "Source", "entityUrl": "https://console.aws.amazon.com/s3/home?#", "latestExecution": { "status": "Succeeded", "lastStatusChange": 1427298837.7679999 } } ], "stageName": "Source" }, { "actionStates": [ { "actionName": "Deploy-CodeDeploy-Application", "entityUrl": "https://console.aws.amazon.com/codedeploy/home?#", "latestExecution": { "status": "Succeeded", "lastStatusChange": 1427298939.4560001, "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.8469999, "lastChangedBy": "arn:aws:iam::80398EXAMPLE:user/CodePipelineUser" }, "stageName": "Production" } ] }