Bitbucket を Jira と統合する

Jira アプリケーションと Bitbucket Cloud アカウントを接続して、チーム作業項目とコードのシームレスな統合を実現することができます。

Bitbucket に接続することで、次の操作を実行できます。

  • リポジトリ アクティビティの表面化Jira 作業項目が自動的に更新され、リポジトリのブランチ、コミット、プル リクエスト アクティビティ、および Bitbucket Pipelines が有効な場合にはビルドとデプロイも表示されます。詳細については、開発作業で作業項目を参照する方法をご確認ください。

  • Bitbucket との密な統合 – コンテキストを変更することなく Jira 作業項目の重要な詳細情報を表示します。Bitbucket のコミット メッセージ、プル リクエスト コメント、デプロイ情報などの任意の場所で Jira の作業項目キーを表示できます。

  • Jira ワークフローの自動化Jira ワークフローがリポジトリのアクティビティと同期され、作業に伴って自動的に更新されます。

Bitbucket Cloud と Jira アプリケーションの統合のメリットの詳細については、こちらをご確認ください。Jira Data Center アプリを使用している場合は、「Bitbucket または GitHub リポジトリを Jira とリンクする」を参照してください。

Jira と Bitbucket Cloud アカウントを接続する

前提条件:

  • Jira と Bitbucket Cloud をリンクするには、Jira のサブスクリプションと Bitbucket アカウントが必要です。

  • Jira インスタンスにリンクできるように、Bitbucket ワークスペースを作成する必要があります。

  • 管理者として Jira にログインします (Jira スペース管理者権限では不十分です)。

ソフトウェア スペースを接続する場合:

Bitbucket Cloud ワークスペースを Jira のソフトウェア スペースに接続する方法は、セットアップに応じていくつかあります。次のうち、ニーズに最も適した手順に従ってください。

コード ページから接続するには、次の手順に従います。

  1. サイドバーにあるスペース名の横で、その他のアクション(•••)を選択し、スペース設定を選択します。

  2. [機能] を選択し、ソフトウェア スペースの [コード] を有効にします。

    1. ソフトウェア スペースコード をオンにするもう 1 つの方法は、 ナビゲーションに追加 )を選択することです。

    2. [コード] > [ナビゲーションに追加] の順に選択します。

  3. [コード] タブに移動して [Bitbucket に接続] を選択し、接続する Bitbucket ワークスペースを選択します。

  4. Jira を Bitbucket Cloud に接続すると、ブランチ名、コミット メッセージ、またはプル リクエストの先頭に作業項目キーを含めることで、リポジトリをスペースに接続できるようになります。

開発ページから接続するには、次の手順に従います。

  1. スペースに対して開発を有効にします。

  2. スペースのナビゲーションから [開発] を選択します。

  3. [関連作業] セクションで [プル リクエスト] を選択します。

  4. 現在の接続状況に応じて、次の操作を行います。

    • 開発アプリが接続されていない場合: [Bitbucket を接続] を選択し、ワークスペースを選択してから、[接続] と [続行] を選択します。

    • 他のアプリがすでに接続されている場合: 接続管理アイコンを選択し、[ツール] サイドバーで [コード] の横にある [別のツールを接続] (+) を選択します。[Bitbucket] を選択し、プロンプトに従います。

    • Bitbucket ワークスペースがすでに接続されている場合: 接続アイコンを選択し、[ツール] サイドバーで [Bitbucket] の横にある [管理] を選択します。[DVCS アカウント] ページで、[Bitbucket ワークスペースをリンク] を選択し、プロンプトに従います。

スペースからショートカットを追加して接続するには、次の手順に従います。

  1. スペースのナビゲーションから [ショートカット] を選択し、[ショートカットを追加] を選択します。

  2. [リポジトリ] を選択します。

  3. リポジトリの詳細を入力し、[接続] を選択します。

  4. リポジトリ リンクが作成されたら、[Integrate Bitbucket (Bitbucket との統合)] を選択して Jira と Bitbucket アカウントを同期させます。

ビジネス スペースを接続する場合:

  1. [設定] () > [製品] の順に選択します。

  2. [統合] の下で、[DVCS アカウント] を選択します。

  3. [Bitbucket Cloud アカウントのリンク] をクリックします。

サービススペースを接続する場合:

  1. 設定を選択し、次にスペースを選択します。

  2. 接続先のスペースを選択します。

  3. [スペース設定] を選択します。

  4. [デプロイメント ツール] までスクロールします。

  5. [接続] を選択し、Bitbucket Cloud を選択します。

リンクが作成されたら、[Integrate Bitbucket (Bitbucket との統合)] を選択して Jira と Bitbucket アカウントを同期させます。

Bitbucket で接続プロセスを続行

接続プロセスにより Bitbucket に遷移します。Jira と接続するリポジトリにアクセス可能な Bitbucket アカウントにログインしていることを確認してから、Jira に Bitbucket アカウントへのアクセスを許可します。

Bitbucket で、Jira への Bitbucket アクセスを許可します。

アカウント内にあるすべての既存のリポジトリと今後追加されるリポジトリで、スマート コミットを有効にできます (「スマート コミットで Jira 作業項目を処理する」を参照)。これらの設定は、Jira の DVCS アカウント設定ページで後から管理できます。下記の「リンクされているアカウントを管理する」をご確認ください。

一度接続すると、Jira の DVCS アカウント設定ページで Bitbucket のリポジトリの一覧を確認できます。

Jira での未完了の接続要求の承認

Jira で接続リクエストを完了するには、Jira 管理者としてログインする必要があります。Jira と Bitbucket Cloud の接続を開始したのにプロセスを完了できない場合は、Jira 管理者に依頼して完了してもらう必要があります。Jira 管理者は次のいずれかの方法を使用できます。

  • [コード] ページに移動し、[ワークスペースを接続] を選択して関連する Bitbucket ワークスペースに接続します。または

  • Jira アプリ Jira 設定メニュー( )から選択し、 統合 見出しの下にある DVCS アカウント を選択します。次にアクセスを許可を選択して Bitbucket に接続します。

リンクアカウントの設定を管理する

Jira と Bitbucket Cloud アカウントをリンクした後、Jira の [DVCS アカウント] ページから接続を管理できます。

もし接続に問題があれば、 Troubleshoot connections with Bitbucket Cloud をご覧ください。

操作

手順説明

スマートコミットの管理

アカウントに対して: アクション メニューで既定のリポジトリ設定を選択します。

ここで、必要に応じて スマート コミットのデフォルト設定を変更します。

変更した設定は、Bitbucketアカウントに追加された新しいリポジトリにのみ適用されます。

レポジトリに対して: 必要に応じて、リポジトリの行にあるスマートコミットのチェックボックスを選択、またはクリアします。

スマート コミットでの Jira 作業項目の処理の詳細については、こちらをご確認ください。

リポジトリのリストを更新

手動で接続されたリポジトリのリストを更新するには、リポジトリの更新 (Refresh repositories)を選択します。

Jira にリポジトリのアクティビティを手動で同期

  1. Jira でリポジトリを手動で更新するには、[ 設定] ()[Jira アプリ] の順に選択してから、[統合] 見出しの下にある [DVCS アカウント] を選択します。

  2. リポジトリ リストの右上にある [その他のアクション] () を選択します。

  3. [その他のアクション] ドロップダウン メニューから [リポジトリの更新] を選択します。

Bitbucket アカウントの切断

アクション メニューで [既定のリポジトリ設定を構成 (Configure default repository settings)] を選択し、切断してください。

 

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

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