Connect GitHub Cloud to Jira

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

はじめる前に

For some organizations, the task of connecting GitHub to Jira Software might involve multiple team members:

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

• A GitHub organization owner will connect a GitHub organization to your Jira Software site.

Jira 向け GitHub アプリをインストールする

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

2. GitHub for Jira を検索し、結果から GitHub for Jira を選択します。

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

GitHub 組織を接続

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

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

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

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

5. Find the organization you want to connect to Jira Software, then select Connect.

Add the Jira Software app to a new GitHub organization

If no organizations are available to connect to Jira Software, you’ll need to install the Jira app on a new GitHub organization.

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

2. The GitHub site will open in a new tab and show a list of all the organizations available in your GitHub account. Select the organization you want to connect to Jira Software.

3. Choose the repositories you want to give Jira Software access to by selecting either All repositories or Only select repositories.

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

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

If you selected All repositories when you connected a GitHub organization, Jira Software will be able to access all the repositories in that organization, including any new repositories you create.

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

1. In Jira Software, select Apps, then select Manage apps.

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

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

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

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

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

Link your development information to Jira Software issues

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

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

2. ブランチ名に課題キーを付けて、リポジトリで新しいブランチをチェックアウトします。例: git checkout -b JRA-123-<branch-name>。

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

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

After you push your branch, you’ll see development information in your Jira Software issue.