Bitbucket Server のサービス webhook を POST する

このページの内容

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

リポジトリ管理者はリポジトリに POST サービスを追加できます。Bitbucket Server は、指定されたサービス URL への POST を行います。

次の形式の URL を使用できます。

https://server:port/path/

ユーザーがリポジトリへのプッシュを行うと、サービスは POST を受け取ります。

The content type header of the POST has an application/json type. The content is a JSON payload that represents the repository push.

POST サービスのセットアップ

POST サービスを手動でセットアップすることも、これを自動化するためのサービスを記述することもできます。アプリケーションを Bitbucket Server と連携させる場合、サービスを記述します。

リポジトリの設定のセットアップ

  1. リポジトリの設定に移動します。
  2. 左側のナビゲーションにある [フック] をクリックします。
  3. "Post-Receive Webhooks" 項目で [有効化] をクリックします。Bitbucket の更新メッセージの送信先となる URL を最大で 5 つ追加できます。
  4. Saveボタンを押下してください。

データの POST

ユーザーがリポジトリへのプッシュを行うと、Bitbucket Server は提供された URL への POST を行います。POST リクエストの本文には、変更が行われたリポジトリの情報、最近のコミットの一覧、プッシュを行ったユーザーの名前が含まれます。 

ペイロードの例

iridium-common および iridium-magma フォルダの 2 つのファイル (pom.xml) を変更する 1 つのコミットを含むプッシュの例です。

JSON ペイロード
{
   "repository":{
      "slug":"iridium-parent",
      "id":11,
      "name":"iridium-parent",
      "scmId":"git",
      "state":"AVAILABLE",
      "statusMessage":"Available",
      "forkable":true,
      "project":{
         "key":"IR",
         "id":21,
         "name":"Iridium",
         "public":false,
         "type":"NORMAL",
         "isPersonal":false
      },
      "public":false
   },
   "refChanges":[
      {
         "refId":"refs/heads/master",
         "fromHash":"2c847c4e9c2421d038fff26ba82bc859ae6ebe20",
         "toHash":"f259e9032cdeb1e28d073e8a79a1fd6f9587f233",
         "type":"UPDATE"
      }
   ],
   "changesets":{
      "size":1,
      "limit":100,
      "isLastPage":true,
      "values":[
         {
            "fromCommit":{
               "id":"2c847c4e9c2421d038fff26ba82bc859ae6ebe20",
               "displayId":"2c847c4"
            },
            "toCommit":{
               "id":"f259e9032cdeb1e28d073e8a79a1fd6f9587f233",
               "displayId":"f259e90",
               "author":{
                  "name":"jhocman",
                  "emailAddress":"jhocman@atlassian.com"
               },
               "authorTimestamp":1374663446000,
               "message":"Updating poms ...",
               "parents":[
                  {
                     "id":"2c847c4e9c2421d038fff26ba82bc859ae6ebe20",
                     "displayId":"2c847c4"
                  }
               ]
            },
            "changes":{
               "size":2,
               "limit":500,
               "isLastPage":true,
               "values":[
                  {
                     "contentId":"2f259b79aa7e263f5829bb6e98096e7ec976d998",
                     "path":{
                        "components":[
                           "iridium-common",
                           "pom.xml"
                        ],
                        "parent":"iridium-common",
                        "name":"pom.xml",
                        "extension":"xml",
                        "toString":"iridium-common/pom.xml"
                     },
                     "executable":false,
                     "percentUnchanged":-1,
                     "type":"MODIFY",
                     "nodeType":"FILE",
                     "srcExecutable":false,
                     "link":{
                        "url":"/projects/IR/repos/iridium-parent/commits/f259e9032cdeb1e28d073e8a79a1fd6f9587f233#iridium-common/pom.xml",
                        "rel":"self"
                     }
                  },
                  {
                     "contentId":"2f259b79aa7e263f5829bb6e98096e7ec976d998",
                     "path":{
                        "components":[
                           "iridium-magma",
                           "pom.xml"
                        ],
                        "parent":"iridium-magma",
                        "name":"pom.xml",
                        "extension":"xml",
                        "toString":"iridium-magma/pom.xml"
                     },
                     "executable":false,
                     "percentUnchanged":-1,
                     "type":"MODIFY",
                     "nodeType":"FILE",
                     "srcExecutable":false,
                     "link":{
                        "url":"/projects/IR/repos/iridium-parent/commits/f259e9032cdeb1e28d073e8a79a1fd6f9587f233#iridium-magma/pom.xml",
                        "rel":"self"
                     }
                  }
               ],
               "start":0,
               "filter":null
            },
            "link":{
               "url":"/projects/IR/repos/iridium-parent/commits/f259e9032cdeb1e28d073e8a79a1fd6f9587f233#iridium-magma/pom.xml",
               "rel":"self"
            }
         }
      ],
      "start":0,
      "filter":null
   }
}

プロパティ

Webhook Plugin のシステム全体のプロパティの一部は、Bitbucket Server の構成ファイルで上書きできます。利用可能なプロパティについては「Bitbucket Server 構成プロパティ」をご確認ください。

最終更新日 2019 年 8 月 20 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.