GitHub Cloud を Jira に接続する

You can connect GitHub to Jira using the GitHub for Atlassian app. The GitHub for Atlassian app has a unified connector that integrates and shares your GitHub development and security activities with Atlassian Teamwork Graph, enabling data use in Jira and across your Atlassian apps.

When you connect a GitHub Cloud organization to Jira, your team can link their development activity to Jira work items. This lets you track branches, commits, and pull requests in the context of your Jira work items, on your Jira board, in the releases feature, and more.

はじめる前に

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

• A Jira site admin will install the GitHub for Atlassian app.

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

Install the GitHub for Atlassian app

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

2. Search for GitHub for Atlassian, then select it from the results.

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

GitHub 組織を接続

1. After the GitHub for Atlassian app is installed, select Get started. If the app is already installed on your Jira site, you can find this section by selecting Apps, then Manage your apps, and then GitHub for Atlassian.

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

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

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

5. Jira に連携する組織を見つけて、[連携] を選択します。

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

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

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

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

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

4. [インストール] を選択します。

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

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

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

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

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

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

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

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

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

Link your development information to Jira work items

To link branches, commits, and pull requests to Jira, your team must include Jira keys in their development actions.

1. Find the key for the Jira work item you want to link to, for example “JRA-123”. You can find the key in several places in Jira:
   • On the board, keys appear at the bottom of a card.
   • On the work item’s details, keys appear in the navigation at the top of the page.

2. Check out a new branch in your repo, using the key in the branch name. For example, git checkout -b JRA-123-<branch-name>.

3. When committing changes to your branch, use the key in your commit message to link those commits to the development panel in your Jira work item. For example, git commit -m "JRA-123 <summary of commit>".

4. When you create a pull request, use the key in the pull request title.

After you push your branch, you’ll see development information in your Jira work item.