Web サービスにリンクする

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

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

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

• [リポジトリ リンク] ダイアログから追加したリンク

• アドオンのインストール時に自動的に表示される、アドオンの接続リンク

• リポジトリで課題トラッカーを有効化すると自動的に表示される Bitbucket 課題トラッカー

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

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

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

リンクを確立するには、サーバー 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」と入力します。

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

コミット メッセージの課題キーに誤りがあったり、記載ミスがあったりした場合、コミットを修正する必要があります。コミット メッセージの修正の修正については、「履歴の書き換えのチュートリアル」を参照してください。