メインコンテンツまでスキップ

受信Webhookの追加

Bitrise上の受信Webhookの目的は一つです。特定のコードイベント(コードのプッシュ、Git Tag、プルリクエスト)が発生したときに、自動的にビルドを開始することです。リポジトリに受信Webhookを登録し、ビルドトリガーを設定する必要があります。

Webhookの問題

ビルドトリガーが機能しない場合、Webhookに問題がある可能性があります。ビルドがトリガーされない

受信Webhookを自動的に登録するClick to copy link​

Webhookの自動登録は、コードがGitHub、GitLab、Bitbucketでホストされているプロジェクトでサポートされています。

上記のいずれかのサービスをソースコードのホスティングプロバイダーとして使用している場合、Bitriseはプロジェクトのセットアップの最後にボタンをワンクリックするだけで自動的にWebhookを設定します。

GitHub App連携

Bitrise GitHub Appを使用してBitriseのWorkspaceをGitアカウントまたは組織に接続する場合、Webhookは不要です。このアプリがあれば、Webhookなしでビルドのトリガーやステータス更新の送信ができます。

ただし、プロジェクトの追加時にWebhookの登録をスキップした場合でも、後でこのWebhookを変更したり、新しいWebhookを追加したりすることはいつでも可能です。

Project settingsページでリポジトリにWebhookを自動的に登録できます。自動登録ではBitriseがリポジトリにWebhookを登録するため、Gitプロバイダーのウェブサイトに手動でアクセスして追加する必要はありません。これには以下が必要です。

  • リポジトリの管理者権限を持っていること。
  • リポジトリをホストしているアカウントがBitriseアカウントに接続されていること。

Webhookを自動的に登録する方法:

  1. Bitriseアカウントが、リポジトリをホストしているGitプロバイダーのアカウントに接続されていること、およびそのGitアカウントにリポジトリの管理者権限があることを確認します。

  2. プロジェクトに対するAdminのロールを持つユーザー、またはEdit workflow権限を持つカスタムロールを持つユーザーで、Bitrise上のプロジェクトを開きます。

  3. プロジェクトのメインページで、Project settingsボタンをクリックします。

  4. 左側でIntegrationsを選択します。

  5. Integrationsページの上部で、Webhooksタブを選択します。

    webhooks-tab.png

  6. Incoming webhooksセクションでAdd webhookを選択します。

Bitriseにより、プロジェクトのリポジトリにWebhookが自動的に登録されます。

受信Webhookを手動で登録するClick to copy link​

Bitriseにプロジェクトを登録した後、Webhookを手動で設定または変更できます。この手順はGitプロバイダーによって異なりますが、Bitriseでは基本的な手順はどのプロバイダーでも同じです。

独自のWebhook実装を作成する

当社のWebhookプロセッサーはオープンソースです。サポート対象外のソリューションをお探しの場合は、GitHubページでissueを作成するか、実装を含むpull requestを作成してください。必要であれば、自社のファイアウォールの内側で独自のWebhookプロバイダーを運用することもできます。

  1. プロジェクトに対するAdminのロールを持つユーザー、またはEdit workflow権限を持つカスタムロールを持つユーザーで、Bitrise上のプロジェクトを開きます。

  2. プロジェクトのメインページで、Project settingsボタンをクリックします。

  3. 左側でIntegrationsを選択します。

  4. Integrationsページの上部で、Webhooksタブを選択します。

    webhooks-tab.png

  5. 下にスクロールしてIncoming webhooksセクションに移動し、Manual webhooksを開きます。

    manual-webhooks.png

  6. webhook URLをコピーして、Gitプロバイダーに登録します。