プロジェクトでトリガーを作成し、1 時間、1 日、または 1 週間に 1 回ビルドをスケジュールできます。Amazon CloudWatch cron 式でカスタムルールを使用してトリガーを編集することもできます。たとえば、cron 式を使用して、毎週特定の時間にビルドをスケジュールできます。トリガーの作成および編集に関する詳細は、「AWS CodeBuild トリガーの作成」および「AWS CodeBuild トリガーの編集」を参照してください。
AWS CodeBuild トリガーの作成
プロジェクトでトリガーを作成し、1 時間、1 日、または 1 週間に 1 回ビルドをスケジュールできます。Amazon CloudWatch cron 式でカスタムルールを使用してトリガーを作成することもできます。たとえば、cron 式を使用して、毎週特定の時間にビルドをスケジュールできます。
注記
ビルドトリガー、Amazon EventBridge イベント、および AWS Step Functions タスクからバッチビルドを開始することはできません。
AWS CodeBuild トリガーを作成 (コンソール)
次の手順で、AWS Management Console を使用してトリガーを作成します。
トリガーを作成するには
AWS CodeBuild コンソール (https://console.aws.amazon.com/codesuite/codebuild/home
) を開きます。 -
ナビゲーションペインで、[Build projects] を選択します。
-
トリガーを追加するビルドプロジェクトのリンクを選択し、[トリガーのビルド] タブを選択します。
注記
デフォルトでは、最新の 100 個のビルドプロジェクトが表示されます。さらに多くのビルドプロジェクトを表示するには、歯車アイコンを選択して [Projects per page (ページ毎プロジェクト数)] で別の値を選択するか、前後の矢印を使用します。
-
[Create trigger (トリガーの作成)] を選択します。
-
[トリガー名] に名前を入力します。
-
[Frequency] (頻度) ドロップダウンリストから、トリガーの頻度を選択します。CRON 式を使用して頻度を作成する場合は、[Custom] (カスタム) を選択します。
-
トリガーの頻度のパラメータを指定します。選択肢の最初の数文字をテキストボックスに入力すると、ドロップダウンメニュー項目がフィルタリングされます。
注記
開始時間と分はゼロベースです。開始分は 0 から 59 までの数値です。開始時は 0 から 23 までの数値です。たとえば、毎日午後 12:15 に開始する日次トリガーは、開始時が 12、開始分が 15 になります。毎日深夜に開始される日次トリガーは、開始時がゼロで、開始分がゼロです。毎日午後 11:59 に開始する毎日のトリガーは、開始時が 23、開始分が 59 です。
Frequency 必須パラメータ 詳細 時間単価 開始時間 (分)
[開始時間 (分)] ドロップダウンメニューを使用します。
1 日 1 回 開始時間 (分)
開始時間 (時)
[開始時間 (分)] ドロップダウンメニューを使用します。
[開始時間 (時)] ドロップダウンメニューを使用します。
毎週 開始時間 (分)
開始時間 (時)
開始日
[開始時間 (分)] ドロップダウンメニューを使用します。
[開始時間 (時)] ドロップダウンメニューを使用します。
[開始時間 (日)] ドロップダウンメニューを使用します。
Custom Cron 式
[Cron 式] に Cron 式を入力します。Cron 式には 、空白で区切られた 6 つの必須フィールドがあります。これらのフィールドでは、分、時、日付、月、曜日、および年の開始値を指定します。範囲や追加の値などを指定するには、ワイルドカードを使用します。例えば、cron 式
0 9 ? * MON-FRI *
は毎週平日午前 9 時にビルドをスケジュールします。詳細については、「Amazon CloudWatch Events ユーザーガイド」の「cron 式」を参照してください。 -
[Enable this trigger (このトリガーの有効化)] を選択します。
-
(オプション) [アドバンスト] セクションを展開します。[ソースバージョン] に、ソースのバージョンを入力します。
-
Amazon S3 の場合、ビルドする入力アーティファクトのバージョンに対応するバージョン ID を入力します。[ソースバージョン] が空白のままの場合は、最新バージョンが使用されます。
-
AWS CodeCommit の場合は、コミット ID を入力します。[ソースバージョン] が空白のままの場合は、デフォルトブランチの HEAD コミット ID が使用されます。
-
GitHub または GitHub Enterprise の場合は、ビルドするソースコードのバージョンに対応するコミット ID、プルリクエスト ID、ブランチ名、またはタグ名を入力します。プルリクエスト ID を指定する場合、
pr/
(例:pull-request-ID
pr/25
) 形式を使用する必要があります。ブランチ名を指定すると、ブランチの HEAD コミット ID が使用されます。[Source version] が空白の場合は、デフォルトのブランチの HEAD コミット ID が使用されます。 -
Bitbucket の場合、ビルドするソースコードのバージョンに対応するコミット ID、ブランチ名、またはタグ名を入力します。ブランチ名を指定すると、ブランチの HEAD コミット ID が使用されます。[Source version] が空白の場合は、デフォルトのブランチの HEAD コミット ID が使用されます。
-
-
(オプション) 5 分~2,160 分 (36 時間) の間のタイムアウトを指定します。この値で、AWS CodeBuild が停止するまでビルドを試みる時間を指定します。[時間] と [分] が空白のままの場合、プロジェクトで指定されたデフォルトのタイムアウト値が使用されます。
-
[Create trigger (トリガーの作成)] を選択します。
プログラムを使用した AWS CodeBuild トリガーの作成
CodeBuild は、ビルドトリガーに Amazon EventBridge ルールを使用します EventBridge API を使用して、CodeBuild プロジェクトのビルドトリガーをプログラムで作成できます。詳細については、「Amazon EventBridge API リファレンス」を参照してください。