Web サービスにリンクする

リンクを使用すると、Bitbucket Cloud のコミット メッセージやプルリクエスト コメントで、外部サイトやサービスのページを参照することができます。これらの参照は一般的に、ハイパーリンク テキスト形式となります。

[リンク] ページから、Bitbucket と任意の外部サービスとの間にリンクを設定できます。Bitbucket から簡単にリンクできるよう、Jira、Bamboo Server、Crucible、および jenkins 用のオプションを既定で提供しています。

セットアップしたリンクは、Bitbucket 内のページにリンクを追加する際にのみ機能できます。外部サービス内でコミット メッセージを表示するには、Atlassian Marketplace から連携用のアドオンを入手する必要があります。

このページには 3 種類のリンクが表示される場合があります。

  • [リポジトリ リンク] ダイアログから追加したリンク
  • アドオンのインストール時に自動的に表示される、アドオンの接続リンク
  • リポジトリで課題トラッカーを有効化すると自動的に表示される Bitbucket 課題トラッカー

コミットで課題キーのリンクを要求する

課題トラッカーにリンクする場合、ユーザーに対し、各コミットで課題キーの入力を求めることができます。これを行うには、[コミット メッセージで課題キーを要求する] オプションを有効化します。このオプションが選択されている場合、ユーザーが任意のコミット メッセージで課題キーを使用せずにこのリポジトリにプッシュしようとすると、プッシュには課題キーが必要であることを通知するエラーが表示されます。

[コミット メッセージで課題キーを要求する] オプションを表示するには、次のセクションで説明するように、課題トラッカー サービスに 1 つ以上のリンクを追加する必要があります。

リポジトリを外部アプリケーションにリンクする

リンクを確立するには、サーバー URL とキーを提供する必要があります。次に、キーと値を使用して、コミット メッセージとプルリクエスト コメントにリンクを作成します。コミットまたはコメントに、リンクされていないサービスのキーまたは値が既に含まれている場合、サービスを [リンク] ページに追加することでリンクされます。

  1. リポジトリの [設定] で、左側のナビゲーションから [リンク] をクリックします。
  2. [新しいリンクを追加] をクリックします。
    [リポジトリ リンク] ダイアログが表示されます。
  3. [リンク タイプ] を選択します。Jira、Bamboo Server、Crucible、または Jenkins をリンクさせたい場合、対象のオプションを選択します。ほかの種類の場合、[カスタム] を選択します。
  4. [リンク URL] を入力します。
    たとえば、Jira へリンクする場合、URL は https://jira.atlassian.com などのようになります。
  5. リンク キーを入力します。キーの値では大文字と小文字が区別されます。
    たとえば、Jira 内のプロジェクトに BB キーでリンクする場合は、キーに「BB」と入力します。
  6. [保存] をクリックします。

セットアップの完了後にリンクを使用するには、サービスのリンク キーと値を参照します。たとえば、Jira インスタンスの BB プロジェクトで課題 5792 へリンクさせたい場合は、コミット メッセージに「BB-5792」と入力します。

 hg commit -m "BB-5792 Profile page website opens in a new window/tab"

これらの課題キーは、[コミット] ページにリンクとして表示されます。

最終更新日 2018 年 5 月 23 日

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

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