Bitbucket または GitHub リポジトリを Jira とリンクする

お困りですか?

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

コミュニティに質問

Jira DVCS コネクタを利用して、Bitbucket Cloud または GitHub (ホスト型 または Enterprise) のアカウントを Jira Software Server にリンクします。Jira Sotware にリンクすると、ブランチ、コミット メッセージ、プル リクエストのすべてを Jira Software の課題でシームレスに参照できます。これにより、 Jira Software で開発アクティビティを関連する課題に表示することができます。「Jira を使った開発の効率化」を参照してください。

このページでは、Bitbucket や GitHub のアカウントを Jira にリンクする方法について説明します。

Jira Software が DVCS アカウントに接続する方法について

Jira DVCS コネクタは、Jira Software Server を DVCS ホスティング サービス (Bitbucket、GitHub、または GitHub Enterprise) 上のアカウントにリンクさせます。したがってこのコネクタには、アカウント データにアクセスするための DVCS アカウントの権限が必要です。コネクタはこれを OAuth アクセス トークンを通じて実行します。  

OAuthのアクセストークンを DVCS (Bitbucket, GitHub, または GitHub Enterprise)上で作成します。連携させたいリポジトリを所有しているアカウントでアクセストークンを作成しなければいけません。トークンの作成方法は DVCS によって異なります。トークンの作成で生成される値は以下のようになります:

鍵 (キー) DVCSで生成された文字列
シークレット DVCSで生成された文字列
認証アカウント トークンを認証するアカウント。

DVCS でキーとシークレットを作成したら、Jira Software に戻り、アカウント、OAuth キー、シークレットのデータを Jira Software に入力します。

コネクタはキーとシークレットを自動的に信頼しません。Jira Software にアカウントとパスワードの組み合わせを提供することにより、キーとシークレット経由での DVCS への接続を許可する必要があります。許可すると、DVCS コネクタは次の内容を行えるようになります。

Bitbcuket のアカウント保有者として、このサービス(JIRA Software)が Bitbucket で生成されたキーとシークレットを利用して接続を要求しているのを認めます。このサービスに対してアカウントのデータを利用することを許可します。 

DVCS側で許可するアカウントは鍵とシークレットを作成したアカウントである必要はありません。許可アカウントリンクする全てのリポジトリに対して管理者権限を持っている必要があります。 

Jira DVCS コネクタを利用して DVCS アカウントを連携させる時、コネクタはそのアカウントが所有している全てのパブリック / プライベートリポジトリを検索します。コネクタは DVCS 上でリポジトリに対してポストコミット サービスを追加します。ポストコミット サービスは、ユーザーによるコミット変更を待機するリポジトリ上のコードです。コミットが行われると、DVCS コネクタは処理のためにコミット メッセージを収集します。

Jira Software 側では、DVCS アカウントが所有するリポジトリが [DVCS アカウントの管理]ページに表示されます。チーム メンバーは個人の Bitbucket アカウントの下にリポジトリを作成できますが、所有者にはチームが割り当てられます。これらのリポジトリは、リストの Bitbucket にも表示されます。

DVCS アカウントを Jira Software Server にリンクする

Jira Software に Bitbucket や GitHub アカウントをリンクするには、OAuth のアクセス トークンを DVCS ツール内で作成し、そのトークンを Jira Software Server に追加します。

この手順を実行するには、Jira Software インスタンスとリンクさせたい DVCS アカウントの両方で管理者権限が必要です。  

ステップ 1. DVCS アカウント上で OAuth のアクセストークンを作成する

DVCS アカウント上で OAuth のアクセストークンを作成します。チームのリポジトリをリンクさせるには、チームアカウントでこれらのトークンを作成する必要があります。 

リポジトリがホスティングされている DVCS - Bitbucket、GitHubの、またはGitHub Enterprise で新しい OAuth のトークンを生成します。 

Bitbucket で新しいトークンを生成する

管理者権限を持つユーザーアカウントでログインします:

  1. アバター > Bitbucket 設定を選択します。 
  2. (任意) チームアに接続する場合管理のドロップダウンよりチームを選択してください。
  3. アカウント管理の下にあるOAuthをクリックしてください。
  4. コンシューマの追加をクリックします。
  5. 以下の詳細を入力してください。

    名前 この例では「Jira DVCS」と入力します。
    説明 このトークンが何のために作成されたのかを想起させるような説明を入れます。
    URL Jira Software のインスタンスの URL を入力します (例: https://example.atlassian.net)
  6. 以下のパーミッションを選択します: 
    • アカウント: 書き込み
    • リポジトリ: 管理者 (リポジトリへの書き込み権限はなし)
    • プル リクエスト: 読み取り

    これらは、Jira DVCS コネクタで必要な最小限のパーミッションです。
    追加の権限を選択しても、連携への影響はありません。
  7. 保存をクリックします。
  8. 消費者の名前をクリックして、OAuth キーシークレットの値を確認します。
  9. DVCS をブラウザで開いたまま、次のステップにいってください。

GitHub または GitHub Enterpriseで新しいトークンを生成する

管理者権限を持つユーザーアカウントでログインします:

  1. プロファイルの編集を選択します。 
  2. アプリケーションを選択します。 
  3. 新しいアプリケーションの登録を選択します。 
  4. アプリケーション名に「JIRA DVCS」と入力します。 
  5. URLコールバック URLの両方のフィールドに Jira Software URL を入力します。アプリケーションの登録を押します。

    Jira Software のベース URL (例: https://example.atlassian.net) を、[ホームページ URL] と [認証コールバック URL] フィールドの両方に入力するようにします。ダッシュボード URL (https://example.atlassian.net/secure/Dashboard.jspa) は使用しないでください。 

    DCON-467 - 課題詳細を取得中... ステータス を参照してください。

    Jira 6.2 の場合、使用する URL は https://example.atlassian.net/plugins/servlet/oauth/authorize です。

  6. DVCS をブラウザで開いたまま、次のステップにいってください。

ステップ 2. Jira Software で DVCS アカウントをリンクする

DVCS と Jira Software のリンクを完了させるために以下を行います。

  1. 管理者権限を持つユーザーで Jira Software にログインします。
  2. Jira Software ダッシュボードから、 (設定) アイコンをクリックします。
  3. アプリケーションを選択します。
  4. 左側の統合セクションで、DVCS アカウントを選択します。
  5. Bitbucket Cloud または GitHub アカウントをリンクをクリックします。
  6. ホスト値として Bitbucket Cloud を選択します。
  7. チーム または ユーザーアカウント名を入力します。

    例えば、 https://bitbucket.org/tutorials/markdowndemo  リポジトリを所有するアカウントをリンクさせたい場合、tutorialsチーム アカウントまたはユーザー アカウントの値として入力します。tutorials アカウントをリンクすると、markdowndemo リポジトリだけではなく、このアカウントのすべてのリポジトリがリンクされます。

  8. OAuth キー と OAuth シークレットの値をDVCS サイトからこのダイアログにコピーします。
    GitHubの Client ID は OAuth キーと同じです。そして クライアントシークレットOAuth シークレットと同じです。 
  9. デフォルトの自動リンクとスマートコミットをそのままにする (推奨) または変更します。

     
  10. 追加をクリックします。 

    GitHub アカウントを接続しようとして、ブランクページにリダイレクトされた場合、「GitHub への DVCS 接続でブランクページが生成される」を参照してください。

  11. プロンプトでアクセスを許可します。

接続したアカウントとそのリポジトリが DVCS アカウントページに表示されます。最初の同期が自動的に開始します。 

アカウントをリンクさせると、Jira Software は課題キーを参照するコミットの検索を自動的に開始します。サマリーには、同期結果とエラー (ある場合) が表示されます。DVCS リポジトリから Jira Software へのコミット データの同期には時間がかかる場合があります。同期が進行すると、関連する課題にコミットが表示されます。必要に応じて、Jira Software とリポジトリのリンクをいつでも有効化 / 無効化できます。 

Bitbucket におけるリンクの表示方法

DVCS コネクターは 2 つの動作を実行します:

  • リンクされたアカウントの統合アプリケーションリストに OAuth コンシューマを追加します。Bitbucket のリストを表示するには、自分のプロファイル画像をクリックし、 Bitbucket  の設定をクリックします。アカウント管理にある OAuth セクションwお洗濯すると、次のような画面が表示されます:


     
  • DVCS コネクターはコミット後のサービスをアカウントの各リポジトリにプログラムによって追加します。このサービスを表示するには、リポジトリの上の (設定) から [サービス] をクリックします。以下のようなリストが表示されます。



    DVCS コネクターはリンクを使用して、アカウントの新しいリポジトリを確認し、サービスをそこに追加します。これらすべての結果は "サービス" ページで確認できます。

Jira Software プロジェクトでコミット情報がどのように表示されるかの例

開発者がコミットを作成する場合、 以下のように、Jira Software 課題キーをコミットメッセージに追加する必要があります。

hg commit -m "DVCS-2 add a README file to the project."
hg push

Jira Software は課題キーを使用してコミットを課題に関連付けます。これにより、コミットの概要を Jira Software 課題の開発パネルに表示できるようになります。


詳細は、開発ツールとの連携 を参照してください。

必須のプロジェクト権限

プロジェクトのユーザーは、Jira Software 課題の開発パネルでコミット情報を見るためには "開発ツールを表示" 権限を持っている必要があります。Jira Software 管理者はプロジェクトの権限スキームを編集してこの権限を付与することができます。「プロジェクト権限の管理」を参照してください。
最終更新日 2019 年 1 月 21 日

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

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