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 で新しいトークンを生成する
管理者権限を持つユーザーアカウントでログインします:
- アバター > Bitbucket 設定を選択します。
- (任意) チームアに接続する場合管理のドロップダウンよりチームを選択してください。
- アカウント管理の下にあるOAuthをクリックしてください。
- コンシューマの追加をクリックします。
以下の詳細を入力してください。
名前 この例では「 Jira DVCS
」と入力します。説明 このトークンが何のために作成されたのかを想起させるような説明を入れます。 URL Jira Software のインスタンスの URL を入力します (例: https://example.atlassian.net) - 以下のパーミッションを選択します:
- アカウント: 書き込み
- リポジトリ: 管理者 (リポジトリへの書き込み権限はなし)
- プル リクエスト: 読み取り
さらに、[これは非公開コンシューマーです] チェックボックスを選択します。
これらは、Jira DVCS コネクタで必要な最小限のパーミッションです。
追加の権限を選択しても、連携への影響はありません。
7. 保存をクリックします。
8. 新しいコンシューマーの名前をクリックして、OAuth のキーとシークレットの値を確認します。
9. DVCS をブラウザで開いたまま、次のステップにいってください。
GitHub または GitHub Enterpriseで新しいトークンを生成する
管理者権限を持つユーザーアカウントでログインします:
- プロファイルの編集を選択します。
- アプリケーションを選択します。
- 新しいアプリケーションの登録を選択します。
- アプリケーション名に「
JIRA DVCS
」と入力します。 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
です。DVCS をブラウザで開いたまま、次のステップにいってください。
ステップ 2. Jira Software で DVCS アカウントをリンクする
DVCS と Jira Software のリンクを完了させるために以下を行います。
- 管理者権限を持つユーザーで Jira Software にログインします。
- Jira Software ダッシュボードから、 (設定) アイコンをクリックします。
- アプリケーションを選択します。
- 左側の統合セクションで、DVCS アカウントを選択します。
- Bitbucket Cloud または GitHub アカウントをリンクをクリックします。
- ホスト値として Bitbucket Cloud を選択します。
チーム または ユーザーアカウント名を入力します。
例えば、
https://bitbucket.org/tutorials/markdowndemo
リポジトリを所有するアカウントをリンクさせたい場合、tutorials
をチーム アカウントまたはユーザー アカウントの値として入力します。tutorials
アカウントをリンクすると、markdowndemo
リポジトリだけではなく、このアカウントのすべてのリポジトリがリンクされます。- OAuth キー と OAuth シークレットの値をDVCS サイトからこのダイアログにコピーします。
GitHubの Client ID は OAuth キーと同じです。そして クライアントシークレットはOAuth シークレットと同じです。 - デフォルトの自動リンクとスマートコミットをそのままにする (推奨) または変更します。
[追加] をクリックします。
GitHub アカウントを接続しようとして、ブランクページにリダイレクトされた場合、「GitHub への DVCS 接続でブランクページが生成される」を参照してください。
- プロンプトでアクセスを許可します。
接続したアカウントとそのリポジトリが DVCS アカウントページに表示されます。最初の同期が自動的に開始します。
自動同期と、リンクの一時的な無効化
アカウントをリンクさせると、Jira Software は課題キーを参照するコミットの検索を自動的に開始します。サマリーには、同期結果とエラー (ある場合) が表示されます。DVCS リポジトリから Jira Software へのコミット データの同期には時間がかかる場合があります。同期が進行すると、関連する課題にコミットが表示されます。必要に応じて、Jira Software とリポジトリのリンクをいつでも有効化 / 無効化できます。
Bitbucket におけるリンクの表示方法
DVCS コネクターは 2 つの動作を実行します:
- リンクされたアカウントの統合アプリケーションリストに OAuth コンシューマを追加します。Bitbucket のリストを表示するには、自分のプロファイル画像をクリックし、 Bitbucket の設定をクリックします。アカウント管理にある OAuth セクションを選択すると、次のような画面が表示されます:
- DVCS コネクターはコミット後のサービスをアカウントの各リポジトリにプログラムによって追加します。このサービスを表示するには、リポジトリの上の (設定) から [サービス] をクリックします。以下のようなリストが表示されます。
DVCS コネクターはリンクを使用して、アカウントの新しいリポジトリを確認し、サービスをそこに追加します。これらすべての結果は "サービス" ページで確認できます。
Jira Software プロジェクトでコミット情報がどのように表示されるかの例
開発者がコミットを作成する場合、 以下のように、Jira Software 課題キーをコミットメッセージに追加する必要があります。
hg commit -m "DVCS-2 add a README file to the project."
hg push
Jira Software は課題キーを使用してコミットを課題に関連付けます。これにより、コミットの概要を Jira Software 課題の開発パネルに表示できるようになります。
詳細は、開発ツールとの連携 を参照してください。
必須のプロジェクト権限