Menu
AWS CodeBuild
User Guide (API Version 2016-10-06)

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.

You create a trigger after you create a project.

To create a trigger

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

  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 a different value for Projects per page or choose the back and forward arrows for Viewing projects.

  4. Choose Create trigger.

  5. Type 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 type 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

    Type 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.

  8. Select Enable this trigger to enable the trigger.

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

    • For Amazon S3, type 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 480 minutes (8 hours). This value specifies how long AWS CodeBuild attempts a build before it stops. If hours and minutes is left blank, the default timeout value specified in the project is used.