Web サービスにリンクする

robotsnoindex
robotsnoindex

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

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

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

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

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

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

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

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

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

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

  1. From Repository settings, click Links from the left navigation.
  2. [新しいリンクを追加] をクリックします。
    [リポジトリ リンク] ダイアログが表示されます。
  3. [リンク タイプ] を選択します。Jira、Bamboo Server、Crucible、または Jenkins をリンクさせたい場合、対象のオプションを選択します。ほかの種類の場合、[カスタム] を選択します。
  4. Enter the Link URL.
    For example, if you're linking to Jira, your URL may look like https://jira.atlassian.com.
  5. リンク キーを入力します。キーの値では大文字と小文字が区別されます。
    たとえば、Jira 内のプロジェクトに BB キーでリンクする場合は、キーに「BB」と入力します。
  6. [保存] をクリックします。

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

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

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

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

最終更新日: 2020 年 10 月 21 日

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

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