Trigger AWS CodeBuild builds automatically - AWS CodeBuild
Create build triggers

Trigger AWS CodeBuild builds automatically

You can create a trigger on a project to schedule a build once every hour, day, or week. You can also edit a trigger to use a custom rule with an Amazon CloudWatch cron expression. For example, using a cron expression, you can schedule a build at a specific time on every weekday. For information about creating and editing triggers, see Create AWS CodeBuild triggers and Edit AWS CodeBuild triggers.

Topics

Create AWS CodeBuild triggers

You can create a trigger on a project to schedule a build once every hour, day, or week. You can also create a trigger using a custom rule with an Amazon CloudWatch cron expression. For example, using a cron expression, you can schedule a build at a specific time every weekday.

Note

It is not possible to start a batch build from a build trigger, an Amazon EventBridge event, or an AWS Step Functions task.

Create AWS CodeBuild triggers (console)

Use the following procedure to create triggers using the AWS Management Console.

To create a trigger

  1. Open the AWS CodeBuild console at https://console.aws.amazon.com/codesuite/codebuild/home.

  2. In the navigation pane, choose Build projects.

  3. Choose the link for the build project to which you want to add a trigger, and then choose the Build triggers tab.

    Note

    By default, the 100 most recent build projects are displayed. To view more build projects, choose the gear icon, and then choose a different value for Projects per page or use the back and forward arrows.

  4. Choose Create trigger.

  5. Enter a name in Trigger name.

  6. From the Frequency drop-down list, choose the frequency for your trigger. If you want to create a frequency using a cron expression, choose Custom.

  7. Specify the parameters for the frequency of your trigger. You can enter the first few characters of your selections in the text box to filter drop-down menu items.

    Note

    Start hours and minutes are zero-based. The start minute is a number between zero and 59. The start hour is a number between zero and 23. For example, a daily trigger that starts every day at 12:15 P.M. has a start hour of 12 and a start minute of 15. A daily trigger that starts every day at midnight has a start hour of zero and a start minute of zero. A daily trigger that starts every day at 11:59 P.M. has a start hour of 23 and a start minute of 59.

    Frequency Required Parameters Details
    Hourly

    Start minute

    Use the Start minute drop-down menu.
    Daily

    Start minute

    Start hour

    Use the Start minute drop-down menu.

    Use the Start hour drop-down menu.
    Weekly

    Start minute

    Start hour

    Start day

    Use the Start minute drop-down menu.

    Use the Start hour drop-down menu.

    Use the Start day drop-down menu.
    Custom

    Cron expression

    Enter a cron expression in Cron expression. A cron expression has six required fields that are separated by white space. The fields specify a start value for minute, hour, day of month, month, day of week, and year. You can use wildcards to specify a range, additional values, and more. For example, the cron expression 0 9 ? * MON-FRI * schedules a build every weekday at 9:00 A.M. For more information, see Cron Expressions in the Amazon CloudWatch Events User Guide.

  8. Select Enable this trigger.

  9. (Optional) Expand Advanced section. In Source version, type a version of your source.

    • For Amazon S3, enter the version ID that corresponds to the version of the input artifact you want to build. If Source version is left blank, the latest version is used.

    • For AWS CodeCommit, type a commit ID. If Source version is left blank, the default branch's HEAD commit ID is used.

    • For GitHub or GitHub Enterprise, type a commit ID, a pull request ID, a branch name, or a tag name that corresponds to the version of the source code you want to build. If you specify a pull request ID, it must use the format pr/pull-request-ID (for example, pr/25). If you specify a branch name, the branch's HEAD commit ID is used. If Source version is blank, the default branch's HEAD commit ID is used.

    • For Bitbucket, type a commit ID, a branch name, or a tag name that corresponds to the version of the source code you want to build. If you specify a branch name, the branch's HEAD commit ID is used. If Source version is blank, the default branch's HEAD commit ID is used.

  10. (Optional) Specify a timeout between 5 minutes and 2160 minutes (36 hours). This value specifies how long AWS CodeBuild attempts a build before it stops. If Hours and Minutes are left blank, the default timeout value specified in the project is used.

  11. Choose Create trigger.

Create AWS CodeBuild triggers programmatically

CodeBuild uses Amazon EventBridge rules for build triggers. You can use the EventBridge API to programmatically create build triggers for your CodeBuild projects. See Amazon EventBridge API Reference for more information.