GitHub Cloud を Jira に接続する

GitHub for Atlassian アプリを使用して、GitHub を Jira に接続できます。GitHub for Atlassian アプリには一体型コネクタが搭載されています。このコネクタを通じて、GitHub の開発およびセキュリティ アクティビティが Atlassian チームワーク グラフと統合および共有され、Jira やその他の Atlassian アプリでデータを活用できるようになります。

GitHub Cloud 組織を Jira に接続すると、チームが開発アクティビティを Jira 作業項目にリンクできるようになります。これにより、Jira 作業項目のコンテキストで、Jira ボード、リリース機能などでブランチ、コミット、プル リクエストを追跡できます。

はじめる前に

組織によっては、GitHub を Jira に接続する作業に複数のチーム メンバーが関与することがあります。

• Jira サイト管理者が GitHub for Atlassian アプリをインストールします。

• GitHub 組織の所有者が GitHub 組織を Jira サイトに接続します。

GitHub for Atlassian アプリをインストールする

1. Jira で [アプリ] > [その他のアプリを探す] の順に選択します。

2. GitHub for Atlassian を検索し、結果から当該アプリを選択します。

3. [アプリを入手] > [今すぐ入手] の順に選択します。

GitHub 組織を接続

1. GitHub for Atlassian アプリをインストールした後、[開始する] を選択します。アプリが Jira サイトにすでにインストールされている場合は、[アプリ]、[アプリを管理]、[GitHub for Atlassian] の順に選択すると、このセクションが表示されます。

2. [続行] を選択します。

3. [GitHub Cloud] > [次へ] の順に選択します。

4. GitHub のユーザー名とパスワードを入力して、[サインイン] を選択します。

5. Jira に接続する組織を見つけます。

   • 組織がリストに表示されていない場合は、このセクションの手順を続行する前に、まず新しい Github 組織に Jira アプリを追加してください。

6. 組織が見つかった場合は、[接続] を選択します。

   • [接続] ボタンは、GitHub 組織の所有者である場合にのみ表示されます。

7. [接続] ボタンが表示されない場合は、GitHub 組織の所有者に組織を接続するよう依頼する必要があります。

   1. [Send them a link and ask them to connect (リンクを送信して接続を依頼する)] を選択します。

   2. [Send a link to an organization owner (組織の所有者にリンクを送信)] ダイアログが開いたら、メッセージと URL をコピーして GitHub 組織の所有者に送信し、承認を求めます。

8. GitHub 組織の所有者は、リンクを使用してサインインし、組織を Jira に接続できます。

9. GitHub 組織の所有者が組織を接続したら、実際に Jira に接続されていることを確認します。

   1. Jira で、[アプリ]、[アプリを管理] の順に選択します。

   2. GitHub for Atlassian を選択し、新たに接続された組織がページにリストされていることを確認します。

Jira アプリを新しい GitHub 組織に追加する

Jira に連携できる組織がない場合は、新しい GitHub 組織に Jira アプリをインストールする必要があります。

1. 上記の「GitHub 組織を接続する」の手順のステップ 5 から、GitHub で組織を選択します。

2. GitHub サイトが新しいタブで開き、GitHub アカウントで利用できるすべての組織のリストが表示されます。Jira に連携する組織を選択します。

   1. 組織がリストに表示されない場合は、その組織のメンバーではないことを意味します。GitHub 組織の所有者に連絡して、組織に招待してもらってください。

3. [全リポジトリ] か [Only select repositories (一部のリポジトリのみ)] を選択して、Jira へのアクセス権を付与するリポジトリを選択します。

4. [インストール] を選択し、所定の手順に従ってインストールを完了します。インストール オプションは、GitHub 組織の所有者である場合にのみ表示されます。

5. 組織の所有者でない場合は、[リクエスト] を選択して組織の所有者にメールを送信します。

6. GitHub 組織の所有者は、新しい組織で Jira アプリのインストールを完了できます。

   1. リクエスト メールで、リクエスト レビュー ページへのリンクを選択します。

   2. GitHub で、[Approve & Install (承認とインストール)] を選択します。

これで、新しい組織が Jira に接続できるようになります。「GitHub 組織を接続する」の手順に従って、Jira への接続を完了してください。

新しい GitHub リポジトリを連携する

GitHub Organization に連携したときに [全リポジトリ] を選択した場合、Jira では作成した新しいリポジトリを含め、その組織のすべてのリポジトリにアクセスできるようになります。

[Only select repositories (一部のリポジトリのみ)] を選択した場合、作成した新しいリポジトリは自動的に追加されません。追加する方法は次のとおりです。

1. Jira で、[アプリ] > [アプリを管理] の順に選択します。

2. サイドバーの [GitHub for Jira] で [設定] を選択します。

3. 追加するリポジトリを含む組織を見つけて 3 点メニュー (…) を選択すると、実行できるアクションが表示されます。

4. [設定] を選択します。

5. 新しいタブが開き、GitHub の組織設定が表示されます。[リポジトリ アクセス] で [リポジトリを選択する] ドロップダウンを選択します。

6. 連携するリポジトリを選択して[保存] を選択します。

開発情報を Jira 作業項目にリンクする

ブランチ、コミット、プル リクエストを Jira にリンクするには、チームの開発アクションに Jira キーを含める必要があります。

1. リンクする Jira 作業項目のキー (「JRA-123」など) を探します。このキーは Jira の複数の場所で確認できます。
   • ボードでは、キーはカードの下部に表示されます。
   • 作業項目の詳細では、ページ上部のナビゲーションにキーが表示されます。

2. ブランチ名にキーを付けて、リポジトリで新しいブランチをチェックアウトします。たとえば、「git checkout -b JRA-123-<branch-name>」のようにします。

3. 変更をブランチにコミットする際は、キーをコミット メッセージで使用して、それらのコミットを Jira 作業項目の開発パネルにリンクします。たとえば、git commit -m "JRA-123 <summary of commit>" のようにします。

4. プル リクエストを作成する際は、プル リクエストのタイトルにキーを使用します。

ブランチをプッシュすると、Jira 作業項目に開発情報が表示されます。