

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS CodeBuild ビルドを自動的にトリガー
<a name="build-triggers"></a>

プロジェクトでトリガーを作成し、1 時間、1 日、または 1 週間に 1 回ビルドをスケジュールできます。Amazon CloudWatch cron 式でカスタムルールを使用してトリガーを編集することもできます。たとえば、cron 式を使用して、毎週特定の時間にビルドをスケジュールできます。トリガーの作成および編集に関する詳細は、「[AWS CodeBuild トリガーの作成](#trigger-create)」および「[AWS CodeBuild トリガーの編集](triggers-edit.md)」を参照してください。

**Topics**
+ [

## AWS CodeBuild トリガーの作成
](#trigger-create)
+ [

# AWS CodeBuild トリガーの編集
](triggers-edit.md)

## AWS CodeBuild トリガーの作成
<a name="trigger-create"></a>

プロジェクトでトリガーを作成し、1 時間、1 日、または 1 週間に 1 回ビルドをスケジュールできます。Amazon CloudWatch cron 式でカスタムルールを使用してトリガーを作成することもできます。たとえば、cron 式を使用して、毎週特定の時間にビルドをスケジュールできます。

**注記**  
ビルドトリガー、Amazon EventBridge イベント、および AWS Step Functions タスクからバッチビルドを開始することはできません。

**Topics**
+ [

### AWS CodeBuild トリガーを作成 (コンソール)
](#trigger-create-console)
+ [

### プログラムを使用した AWS CodeBuild トリガーの作成
](#trigger-create-code)

### AWS CodeBuild トリガーを作成 (コンソール)
<a name="trigger-create-console"></a>

次の手順で、AWS マネジメントコンソール を使用してトリガーを作成します。

**トリガーを作成するには** 

1. AWS CodeBuild コンソール ([https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home)) を開きます。

1. ナビゲーションペインで、[**Build projects**] を選択します。

1. トリガーを追加するビルドプロジェクトのリンクを選択し、[**トリガーのビルド**] タブを選択します。
**注記**  
デフォルトでは、最新の 100 個のビルドプロジェクトが表示されます。さらに多くのビルドプロジェクトを表示するには、歯車アイコンを選択して [**Projects per page (ページ毎プロジェクト数)**] で別の値を選択するか、前後の矢印を使用します。

1. [**Create trigger (トリガーの作成)**] を選択します。

1. [**トリガー名**] に名前を入力します。

1. [**Frequency**] (頻度) ドロップダウンリストから、トリガーの頻度を選択します。CRON 式を使用して頻度を作成する場合は、[**Custom**] (カスタム) を選択します。

1. トリガーの頻度のパラメータを指定します。選択肢の最初の数文字をテキストボックスに入力すると、ドロップダウンメニュー項目がフィルタリングされます。
**注記**  
 開始時間と分はゼロベースです。開始分は 0 から 59 までの数値です。開始時は 0 から 23 までの数値です。たとえば、毎日午後 12:15 に開始する日次トリガーは、開始時が 12、開始分が 15 になります。毎日深夜に開始される日次トリガーは、開始時がゼロで、開始分がゼロです。毎日午後 11:59 に開始する毎日のトリガーは、開始時が 23、開始分が 59 です。  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/codebuild/latest/userguide/build-triggers.html)

1.  [**Enable this trigger (このトリガーの有効化)**] を選択します。

1.  (オプション) [**アドバンスト**] セクションを展開します。[**ソースバージョン**] に、ソースのバージョンを入力します。
   +  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 が使用されます。

1. (オプション) 5 分～2,160 分 (36 時間) の間のタイムアウトを指定します。この値で、AWS CodeBuild が停止するまでビルドを試みる時間を指定します。[**時間**] と [**分**] が空白のままの場合、プロジェクトで指定されたデフォルトのタイムアウト値が使用されます。

1. [**Create trigger (トリガーの作成)**] を選択します。

### プログラムを使用した AWS CodeBuild トリガーの作成
<a name="trigger-create-code"></a>

CodeBuild は、ビルドトリガーに Amazon EventBridge ルールを使用します EventBridge API を使用して、CodeBuild プロジェクトのビルドトリガーをプログラムで作成できます。詳細については、「[Amazon EventBridge API リファレンス](https://docs.aws.amazon.com/eventbridge/latest/APIReference/)」を参照してください。

# AWS CodeBuild トリガーの編集
<a name="triggers-edit"></a>

プロジェクトでトリガーを編集し、1 時間、1 日、または 1 週間に 1 回ビルドをスケジュールできます。Amazon CloudWatch cron 式でカスタムルールを使用してトリガーを編集することもできます。たとえば、cron 式を使用して、毎週特定の時間にビルドをスケジュールできます。トリガーの作成方法については、「[AWS CodeBuild トリガーの作成](build-triggers.md#trigger-create)」を参照してください。

**Topics**
+ [

## AWS CodeBuild トリガーを編集 (コンソール)
](#triggers-edit-console)
+ [

## プログラムを使用した AWS CodeBuild トリガーの編集
](#trigger-edit-code)

## AWS CodeBuild トリガーを編集 (コンソール)
<a name="triggers-edit-console"></a>

次の手順で、AWS マネジメントコンソール を使用してトリガーを編集します。

**トリガーを編集するには**

1. AWS CodeBuild コンソール ([https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home)) を開きます。

1. ナビゲーションペインで、[**Build projects**] を選択します。

1. 変更するビルドプロジェクトのリンクを選択し、[**ビルドのトリガー**] タブを選択します。
**注記**  
デフォルトでは、最新の 100 個のビルドプロジェクトが表示されます。さらに多くのビルドプロジェクトを表示するには、歯車アイコンを選択して [**Projects per page (ページ毎プロジェクト数)**] で別の値を選択するか、前後の矢印を使用します。

1. 変更するトリガーの横にあるラジオボタンを選択して、[**Edit (編集)**] を選択します。

1. [**Frequency**] (頻度) ドロップダウンリストから、トリガーの頻度を選択します。CRON 式を使用して頻度を作成する場合は、[**Custom**] (カスタム) を選択します。

1. トリガーの頻度のパラメータを指定します。選択肢の最初の数文字をテキストボックスに入力すると、ドロップダウンメニュー項目がフィルタリングされます。
**注記**  
 開始時間と分はゼロベースです。開始分は 0 から 59 までの数値です。開始時は 0 から 23 までの数値です。たとえば、毎日午後 12:15 に開始する日次トリガーは、開始時が 12、開始分が 15 になります。毎日深夜に開始される日次トリガーは、開始時がゼロで、開始分がゼロです。毎日午後 11:59 に開始する毎日のトリガーは、開始時が 23、開始分が 59 です。  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/codebuild/latest/userguide/triggers-edit.html)

1.  [**Enable this trigger (このトリガーの有効化)**] を選択します。

**注記**  
ソースバージョン、タイムアウト、および AWS CodeBuild で使用できないその他のオプションを編集するには、Amazon CloudWatch コンソール ([https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)) を使用できます。

## プログラムを使用した AWS CodeBuild トリガーの編集
<a name="trigger-edit-code"></a>

CodeBuild は、ビルドトリガーに Amazon EventBridge ルールを使用します EventBridge API を使用して、CodeBuild プロジェクトのビルドトリガーをプログラムで編集できます。詳細については、「[Amazon EventBridge API リファレンス](https://docs.aws.amazon.com/eventbridge/latest/APIReference/)」を参照してください。