Jira Cloud と GitHub の接続

このページの内容

お困りですか?

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

コミュニティに質問

GitHub または GitHub Enterprise アカウントが Jira Software にリンクされると、チームは作業中の Jira Software 課題で、関連するブランチ、コミット メッセージ、プル リクエストを表示できるようになります。「開発ツールとの連携」で詳細をご覧ください。

Github アカウントと Jira Software との接続

You can integrate Jira Cloud with GitHub using the Marketplace app. If you're a long-time Jira user, you might remember this is quite different from the old method.

You can learn more about the integration from GitHub's website, or contact the GitHub team for help. 

Github Enterprise アカウントを Jira Software に接続する

GitHub Enterprise アカウントを Jira Software に接続するには、Jira で用意されている DVCS コネクタを使用します。

Jira Software と接続先の GitHub Enterprise アカウントの両方で管理者権限を持っている必要があります。 

次の手順を実行します。

ステップ 1. GitHub Enterprise アカウント用に OAuth アクセス トークンを作成

DVCS コネクタには OAuth アクセス トークンが必要です。アクセス トークンはGitHub Enterprise アカウントで作成します。アクセス トークンは、リンクするリポジトリを所有している GitHub Enterprise アカウントで作成する必要があります。チームのリポジトリをリンクする場合、チーム アカウントを使用してこのトークンを作成する必要があります。 

次のように OAuth トークンを作成します。

  1. GitHub Enterprise に、アカウントの管理者権限を持つユーザーとしてログインします。
  2. プロファイルの編集を選択します。 
  3.  OAuth アプリケーションを選択します。
  4. 開発者アプリケーション  タブを選択します。
  5. 新しい OAuth アプリケーションの登録を選択します。 
  6. アプリケーション名に名前を入力します。 
  7. URLコールバック URL の両方のフィールドに Jira Software の URL を入力します。小文字を使用します。[アプリケーションの登録] を押します。

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

  8. 次のステップの実行中、GitHub Enterprise アカウントでブラウザを開いたままにします。

ステップ 2. Jira Software に OAuth トークンを追加

GitHub Enterprise でキーとシークレットを作成してから、Jira Software に戻り、次のようにアカウント、OAuth キー、シークレットを入力します。

  1. 管理者権限を持つユーザーとして Jira Software にログインします。
  2. Jira Software ダッシュボードで、歯車 (設定) アイコンをクリックします。
  3. アプリケーションを選択します。
  4. 左側の統合セクションで、DVCS アカウントを選択します。
  5. [GitHub Enterprise アカウントをリンク] をクリックします。
  6. GitHub のユーザー アカウント名を入力します。

  7. [Host URL] として GitHub Enterprise サイトの URL を入力します。
  8. [クライアント ID] と [クライアント シークレット] 値を GitHub Enterprise サイトからダイアログにコピーします。

  9. 既定の自動リンクとスマートコミットをそのままにする (推奨) か、変更します。

    GitHub Enterprise のリンク画面を示す画像
     
  10. 追加をクリックします。この時点でブランクページにリダイレクトされた場合、「GitHub への DVCS 接続でブランクページが生成される」を参照してください。

  11. プロンプトが出たらアクセスを許可します。
  12. Jira が正常に接続されると、「DVCS アカウント」ページにご使用のアカウントが表示されます。

接続したアカウントとそのリポジトリが DVCS アカウントページに表示されます。最初の同期が自動的に開始します。それ以降、システムは定期的に、リポジトリの同期を継続して行います。

接続に関する注意事項

コネクターは、キーとシークレットを自動的には信頼しません。アカウントとパスワードの組み合わせを使用して DVCS への接続を認証することを求められます。認証するアカウントは、キーとシークレットの作成に使用したアカウントではなくてもかまいませんが、リンクするすべてのリポジトリに対して管理アクセス権限を持つアカウントである必要があります。 

Jira DVCS コネクタを使用してアカウントをリンクすると、コネクタは GitHub Enterprise のアカウントで所有しているすべてのリポジトリにコミット後の webhook を追加します。コミットが発生すると、DVCS コネクタはコミット メッセージを収集して処理します。

Jira Software 側では、GitHub Enterprise アカウントで所有しているリポジトリが [DVCS アカウント] ページに表示されます。チーム メンバーは個々の GitHub Enterprise アカウントにリポジトリを作成できますが、所有者にはチームを割り当てる必要があります。このようなリポジトリも一覧に表示されます。

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


Jira Software プロジェクトでのコミット情報の表示例

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

git commit -m "PROJ-123 add a README file to the project."
git push origin <branchname>

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

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

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

最終更新日 2019 年 7 月 5 日

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

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