7.6. ビルドトリガー
ビルドトリガーは、ソースコントロールのプッシュ、webhook 呼び出しの作成 など、トリガー条件が満たされるとビルドを呼び出します。
7.6.1. ビルドトリガーの作成 リンクのコピーリンクがクリップボードにコピーされました!
ビルドトリガーを作成するには、次の手順を実行します。
前提条件
- リポジトリーの Builds ページに移動している。
手順
- Builds ページで、Create Build Trigger をクリックします。
- Github、BitBucket、Gitlab などの目的のプラットフォームを選択するか、カスタム Git リポジトリーを使用します。この例では、Github を使用します。
- プロンプトが表示されたら、アカウントへのアクセスを確認します。
- プロンプトが表示されたら、組織を選択します。Filter namespaces… ボックスにテキストを入力すると、名前空間をフィルタリングできます。または、方向矢印をクリックして名前空間をスクロールすることもできます。選択しようとしている組織がリストにない場合は、Connections wih Quay Container Registry をクリックしてアクセスを要求するか、自分自身にアクセスを許可します。
- 組織を選択したら、Continue をクリックします。
- プロンプトが表示されたら、リポジトリーを選択します。次に、Continue をクリックします。
次のオプションのいずれかを選択してトリガーを設定します。
- Trigger for all branches and tags (default1)。このオプションを選択すると、すべてのブランチとタグを対象にして各コミットのコンテナーイメージが作成されます。
- Trigger only on branches and tags matching a regular expression。このオプションを選択すると、一部のブランチやタグのコンテナーイメージのみがビルドされます。
- Continue をクリックします。
プロンプトが表示されたら、次のオプションのいずれかまたは両方を選択して、タグ付けオプションを設定します。
- Tag manifest with the branch or tag name。このオプションを選択すると、ビルドされたマニフェストにブランチの名前または git コミットのタグがタグ付けされます。
-
Add
latest
tag if on default branch。このオプションを選択すると、リポジトリーのデフォルトブランチでビルドが行われた場合、ビルドされたマニフェストに latest がタグ付けされます。
- オプション: カスタムのタグ付けテンプレートを追加します。ここに入力できるタグテンプレートは複数あります。短い SHA ID、タイムスタンプ、作成者名、コミッター、コミットからのブランチ名をタグとして使用することもできます。詳細は、「ビルドトリガーのタグ命名について」を参照してください。
- Continue をクリックします。
- プロンプトが表示されたら、トリガーの呼び出し時にビルドする Dockerfile の場所を選択します。Dockerfile が git リポジトリーのルートにあり、Dockerfile という名前が付けられている場合は、Dockerfile パスとして /Dockerfile を入力します。
- Continue をクリックします。
-
プロンプトが表示されたら、Docker ビルドのコンテキストを選択します。Dockerfile が Git リポジトリーのルートにある場合は、ビルドコンテキストディレクトリーとして
/
を入力します。 - 検証の警告がないか確認します。必要に応じて、問題を修正してから Continue をクリックします。
- Ready to go! というプロンプトが表示されたら、Continue をクリックします。確認ページにリダイレクトされます。
- SSH 公開鍵を保存し、Return to <organization_name>/<repository_name> をクリックします。リポジトリーの Builds ページにリダイレクトされます。
Builds ページに、ビルドトリガーが表示されます。以下に例を示します。
7.6.2. ビルドの手動トリガー リンクのコピーリンクがクリップボードにコピーされました!
次の手順を使用して、ビルドを手動でトリガーできます。
手順
- Builds ページで、歯車 または Options アイコンをクリックし、Run Trigger Now を選択します。
プロンプトが表示されたら、ドロップダウンメニューをクリックしてブランチまたはタグを指定し、Start Build をクリックします。
ビルドが開始したら、Repository Builds ページでビルド ID を確認できます。