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」と入力します。

1 git commit "BB-5792 Profile page website opens in a new window/tab"

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

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

さらにヘルプが必要ですか?

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