ビルドを自動的にトリガーする
トリガーイベントとワークフローを指定することにより、Bitriseで自動ビルドトリガーを構成できます。コードプッシュ、プルリクエスト、またはGitタグからビルドをトリガーできます。
ビルドをトリガーするコードイベントと実行する宛先ワークフローを指定することで、Bitriseで自動ビルドトリガーを構成できます。複数のトリガーを定義し、いつでも新しいトリガーを追加したり、既存のトリガーを削除したりできます。
トリガーには次の3つのタイプがあります。
-
コードプッシュ：アプリのリポジトリの指定されたブランチへのコードプッシュは、ビルドをトリガーします。
-
プルリクエスト：プルリクエストがビルドをトリガーするソースブランチや宛先ブランチを指定します。
-
Gitタグ：特定のタグを使用したコミットにより、ビルドがトリガーされます。
トリガーを管理できます トリガー ワークフローエディタのセクション、または直接編集できます bitrise.yml それらを設定するためにあなたのアプリの。このガイドでは、WebサイトのUIでトリガーを設定および管理する方法について説明します。
YAML形式でトリガーを設定する方法については、関連するガイドをご覧ください。 トリガーマップを使用してビルドをトリガーする。
トリガーの制限
デフォルトでは、1つのトリガーでトリガーできるワークフローは1つだけです。 1つのトリガーから複数のワークフローをトリガーする必要がある場合は、いくつかの回避策があります。
-
ワークフローをつなぐ だから彼らはお互いを追いかけます。
また、同じブランチ（たとえば、main）で同じコードイベント（たとえば、コードプッシュ）に対して2つの異なるトリガーを設定することはできません。ワークフローエディタでは、保存しようとしても構成を保存できません。
コードプッシュによるビルドのトリガー
コードプッシュ時にトリガーを作成することで、コードがリポジトリにプッシュされるたびにビルドを自動的に開始するようにBitriseを構成できます。リポジトリのブランチと実行するワークフローの両方を指定できます。
ビルドをトリガーするためのWebhook
ビルドを自動的にトリガーするには、リポジトリのホスティングサービスで設定された着信Webhookが必要です。で詳細を読む Webhook セクション。
-
でアプリを開きます bitrise.io。
-
に移動します ワークフロー タブ。
-
に移動します トリガー タブ。
-
を選択 押す オプション。
-
クリック +トリガーを追加。
-
の中に プッシュブランチ ウィンドウに、ブランチの名前を入力します（たとえば、
主人。スペルミスがないことを確認してください。そうでない場合、トリガーは機能しません。ブランチまたはタグを指定するときにパターンを使用する
NS
*シンボルは、構成されたトリガーで、ブランチ名またはタグ名のワイルドカードとして使用できます。パターンにも使用できます。たとえば、パターン*-dev接尾辞が付いたブランチまたはタグに使用できます-dev。複数のトリガーがある場合、最初に一致したトリガーのみがワークフローを開始することに注意してください。ワイルドカードの使用の詳細については、次を参照してください。 トリガー マップでのワイルドカードの使用
-
トリガーするワークフローを選択します（たとえば、
主要な）。 -
クリック 右上隅にあります。
完了です。今後、コードがアプリのリポジトリの選択されたブランチにプッシュされると、Bitriseは選択されたワークフローでビルドをトリガーします！
プルリクエストを使用したビルドのトリガー
トリガーを設定して、指定されたソースブランチからリポジトリの指定されたターゲットブランチへのプルリクエストが開かれるたびに、Bitriseでビルドが自動的にトリガーされるようにすることができます。
ビルドをトリガーするためのWebhook
ビルドを自動的にトリガーするには、リポジトリのホスティングサービスで設定された着信Webhookが必要です。で詳細を読む Webhook セクション。
-
でアプリを開きます bitrise.io。
-
に移動します ワークフロー タブ。
-
に移動します トリガー タブ。
-
を選択 プルリクエスト オプション。
-
デフォルトのトリガーで、 ソースブランチ と ターゲットブランチ オプション。
クリック +トリガーを追加。
-
ソースブランチとターゲットブランチの名前を入力します。スペルミスがないことを確認してください。そうでない場合、トリガーは機能しません。
ソースブランチフィールドまたはターゲットブランチフィールドのいずれか、または両方を空のままにしておくことができます。トリガーはそれに応じて機能します。たとえば、新しいアプリのデフォルトのように両方を空のままにすると、プルリクエストごとにビルドがトリガーされます。
ブランチまたはタグを指定するときにパターンを使用する
NS
*シンボルは、構成されたトリガーで、ブランチ名またはタグ名のワイルドカードとして使用できます。パターンにも使用できます。たとえば、パターン*-dev接尾辞が付いたブランチまたはタグに使用できます-dev。複数のトリガーがある場合、最初に一致したトリガーのみがワークフローを開始することに注意してください。ワイルドカードの使用の詳細については、次を参照してください。 トリガー マップでのワイルドカードの使用
-
トリガーするワークフローを選択します（たとえば、
主要な）。 -
クリック 右上隅にあります。
そして、あなたは完了です！今後、リポジトリでプルリクエストが開かれると、Bitriseは選択されたワークフローでビルドをトリガーします。
ドラフト プル リクエストによってトリガーされたビルドをスキップする
GitHub では、と呼ばれる機能を提供しています。 プルリクエストのドラフト: プル リクエスト (PR) を作成するときに、レビューの準備ができているプル リクエストを作成するか、ドラフト プル リクエストを作成するかを選択できます。ドラフト プル リクエストはマージできず、コード所有者はドラフト プル リクエストをレビューするように自動的に要求されません。
ドラフト PR は、他の PR と同様に Bitrise でビルドをトリガーできます。ただし、ドラフト PR が完全なビルドをトリガーして実行しないようにすることもできます。ビルドまたはビルド内の特定のステップをスキップするには、 GITHUB_PR_IS_DRAFT 環境変数。
ドラフト PR によってトリガーされたビルドをスキップするには:
ワークフローエディター
ビットライズ.yml
-
追加 脚本 最初のステップとしてワークフローに進みます。
実行したくないビルドでクレジットを無駄にしないように、最初のステップとして追加することをお勧めします。
-
次のスクリプトを コンテンツ 入力：
#!/usr/bin/env bash if [ "$GITHUB_PR_IS_DRAFT" = true ] ; then exit 1 fi
このスクリプトは、ビルドをトリガーする PR がドラフトかどうかを確認し、ドラフトである場合はビルドを終了します。
-
追加
script最初のステップとしてワークフローに進みます。実行したくないビルドでクレジットを無駄にしないように、最初のステップとして追加することをお勧めします。
-
次のスクリプトを
content入力：- script: inputs: - content: |- #!/usr/bin/env bash if [ "$GITHUB_PR_IS_DRAFT" = true ] ; then exit 1 fiこのスクリプトは、ビルドをトリガーする PR がドラフトかどうかを確認し、ドラフトである場合はビルドを終了します。
ビルドがドラフト PR によってトリガーされた場合のステップのスキップ
ドラフト プル リクエストによってトリガーされるビルドの特定のステップをスキップすることもできます。使用する必要があるのは、 run_if 状態: 詳細については、を参照してください。 ステップを条件付きで有効または無効にする。
Gitタグを使用したビルドのトリガー
Gitタグのパターンを指定して、特定のワークフローをトリガーできます。これは、特定の状態でアプリをビルドしてデプロイするための良い方法です。そして、セットアップはとても簡単です！
ビルドをトリガーするためのWebhook
ビルドを自動的にトリガーするには、リポジトリのホスティングサービスで設定された着信Webhookが必要です。で詳細を読む Webhook セクション。
GitLabなどの特定のプロバイダーでは、Webhookのセットアップでタグプッシュイベントを特別に有効にする必要があることに注意してください。
-
でアプリを開きます bitrise.io。
-
に移動します ワークフロー タブ。
-
に移動します トリガー タブ。
-
を選択 鬼ごっこ オプション。
-
クリック +トリガーを追加。
-
の中に 鬼ごっこ ウィンドウに、ビルドをトリガーするタグを追加します。
ブランチまたはタグを指定するときにパターンを使用する
NS
*シンボルは、構成されたトリガーで、ブランチ名またはタグ名のワイルドカードとして使用できます。パターンにも使用できます。たとえば、パターン*-dev接尾辞が付いたブランチまたはタグに使用できます-dev。複数のトリガーがある場合、最初に一致したトリガーのみがワークフローを開始することに注意してください。ワイルドカードの使用の詳細については、次を参照してください。 トリガー マップでのワイルドカードの使用
-
トリガーするワークフローを選択します（たとえば、
主要な）。 -
クリック 右上隅にあります。
そして、あなたは完了です！