Start a pipeline in CodePipeline - Amazon CodePipeline
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Start a pipeline in CodePipeline

When a pipeline execution starts, it runs a revision through every stage and action in the pipeline.

There are three ways to start a pipeline execution in Amazon CodePipeline:

  • When a source changes: Your pipeline starts when someone makes a change to your source repository or source location.

    Note

    Your pipeline runs automatically only when something changes in the source repository and branch that you have defined.

  • Manually: You can use the console or the Amazon CLI to start a pipeline manually. For information, see Start a pipeline manually.

  • On a schedule: You can set up a schedule that starts your pipeline. See Start a pipeline on a schedule.

Source actions and change detection methods

When you add a source action to your pipeline, the actions work with additional resources described in the table.

Note

The CodeCommit and S3 source actions require either a configured change detection resource (a CloudWatch Events rule) or use the option to poll the repository for source changes. For pipelines with a Bitbucket, GitHub, or GitHub Enterprise Server source action, you do not have to set up a webhook or default to polling. The connections action manages change detection for you.

Source Uses additional resources? Steps
Amazon S3 This source action uses additional resources. When you use the CLI or CloudFormation to create this action, you also create and manage these resources. See Create a pipeline in CodePipeline and Amazon S3 source actions and CloudWatch Events
Bitbucket This source action uses a connection resource. See Bitbucket connections
Amazon CodeCommit Amazon CloudWatch Events (recommended). This is the default for pipelines with an CodeCommit source created or edited in the console. See Create a pipeline in CodePipeline and CodeCommit source actions and CloudWatch Events
Amazon ECR Amazon CloudWatch Events. This is created by the wizard for pipelines with an Amazon ECR source created or edited in the console. See Create a pipeline in CodePipeline and Amazon ECR source actions and CloudWatch Events.
GitHub or GitHub Enterprise Cloud This source action uses a connection resource. See GitHub connections
GitHub Enterprise Server This source action uses a connection resource and a host resource. See GitHub Enterprise Server connections

If you have a pipeline that uses polling, you can update it to use the recommended detection method. For more information, see Update polling pipelines to the recommended change detection method.

If you want to turn off change detection for a source action that uses connections, see CodeStarSourceConnection for Bitbucket, GitHub, and GitHub Enterprise Server actions.