GitLab スポークの双方向 Webhook の設定

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む4読むのに数分

    • ServiceNow コールバック URL を使用して、GitLab に登録する Webhook を構成します。

    始める前に

    • Integration Hub のサブスクリプションを要求
    • GitLab スポークをアクティブ化
    • 必要なロール：admin

    ServiceNow インスタンスに GitLab Webhook を登録

    ServiceNow に GitLab を登録して、GitLab で特定のイベントが発生したときに ServiceNow アプリに通知します。

    始める前に

    必要なロール：admin

    手順

    1. 移動先 すべて > GitLab Webhook > GitLab Webhook レジストリ.
    2. 既存の Webhook GitLab アカウントを取得するには、[すべての Webhook を取得 (Get All Webhooks)] をクリックします。
    3. Webhook を作成するには、[新規] をクリックします。
    4. フォームのフィールドに入力します。
      フィールド 説明
      名前 Webhook の名前。例：Job webhook。
      説明 レコードの説明です。
      プロジェクト ID Webhook を作成するプロジェクトの一意の識別子です。
      トリガーと SSL 登録するプロジェクトのイベントです。これらのイベントのいずれかが発生すると、Webhook がトリガーされます。
    5. [シークレットトークンを生成 (Generate Secret Token)] 関連リンクをクリックします。
      シークレットトークンが生成され、表示されます。また、シークレットの有効期限が切れる日付が [シークレットの有効期限 (Secret Expires)] に入力されます。
      注:
      シークレットは 30 日ごとに再生成および更新されます。このシークレットは GitLab でも更新されます。
    6. フォームヘッダーを右クリックし、[保存] をクリックします。
    7. [Webhook を作成] をクリックします。
      Webhook が GitLab に作成され、その ID が [Webhook ID] に入力されます。

    次のタスク

    Webhook の詳細を更新したり、登録されているイベントを変更したりするには、[Webhook を更新] をクリックします。

    GitLab スポークでの双方向 Webhook のカスタマイズ

    GitLab スポークの要件に応じて、Webhook ルーティングポリシーとサブフローを作成します。

    始める前に

    必要なロール：admin

    このタスクについて

    [GitLab WebHook ルーティングポリシー] モジュールのデフォルトのルーティングポリシーでは、GitLab で特定のイベントが発生すると、関連する GitLab サブフローをトリガーし、ServiceNow アプリに通知します。カスタムサブフローで他のフィールドを使用し、ルーティングポリシーの条件をカスタマイズするには、次の手順を実行します。

    手順

    1. 移動先 すべて > フローデザイナー > デザイナー.
    2. [サブフロー] をクリックします。
    3. 必要なサブフローのコピーを作成します。
    4. 要件に応じて必要なサブフローをカスタマイズし、公開します。
      サブフローを作成および使用する方法の詳細については「サブフローの構築」を、またデフォルトのルーティングポリシーがサポートする GitLab フィールドおよびサブフローがサポートする GitLab イベントの詳細については、「GitLab スポーク」を参照してください。
    5. 移動先 すべて > GitLab Webhook > GitLab Webhook ルーティングポリシー.
      スポークとともに 5 つのルーティングポリシーを使用できます。要件に応じてそれらのポリシーを構成したり、ルーティングポリシーを作成したりできます。
    6. ルーティングポリシーを作成するには、[新規] をクリックします。
    7. フォームのフィールドに入力します。
      フィールド 説明
      ラベル ルーティングポリシーを識別する一意のラベルです。
      デフォルトの回答 この回答がデフォルトの回答かどうかを指定するオプションです。デフォルトの回答は、条件が満たされない場合に適用されます。
      1. 検索アイコンをクリックします。
      2. ドキュメントリストから必要なサブフローを選択します。
        注:
        [テーブル名] がフロー [sys_hub_flow] であることを確認します。
      条件 GitHub で必要なイベントが発生したときに満たされる条件です。
      回答 指定された条件が満たされるとトリガーされるサブフローです。
    8. [送信] をクリックします。
      注:
      これらのルーティングポリシーは意思決定テーブルに保存されます。ユーザーは、これらのテーブルのデータを直接更新または変更しないように注意してください。

    タスクの結果

    ルーティングポリシーとサブフローが作成されます。