Jira を GitHub Enterprise Server に接続する

You can connect GitHub Enterprise Server 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 Enterprise Server 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 Enterprise Server でのファイアウォールやゲートウェイの設定に慣れていない場合は、サーバーを準備する上で GitHub Enterprise Server 管理者に支援を依頼する必要が生じることもあります。

サーバーのファイアウォールを設定する

ご利用の GitHub Enterprise Server はファイアウォールで保護されています。Jira サイトに接続する前に、そのファイアウォールに穴を開けて Jira がサーバーと通信できるようにする必要があります。

次の 2 つの方法があります。

1. GitHub Enterprise Server に公開 URL がある場合は、アトラシアン IP アドレスからのアクセスを許可するようにサーバーのファイアウォールを設定できます。GitHub IP 許可リストを設定する方法に関しては、こちらをご確認ください。

2. セキュリティをさらに強化する場合や、GitHub Enterprise Server に公開 URL がない場合は、技術チームがこのコード・テンプレートを使用してロックされた公開ゲートウェイを作成できます。ゲートウェイを作成したあと、技術チームは Jira がサーバーに接続するために使用する次のアイテムを提供します。

   1. ロックされたゲートウェイのサーバー URL。

   2. HTTP リクエスト・ヘッダー名。

   3. API キーの値。

Install the GitHub for Atlassian app

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

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

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

GitHub Enterprise Server を接続する

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 Enterprise Server] を選択して、[次へ] を選択します。

4. GitHub Enterprise Server の URL を http(s)://<your-github-enterprise-server-domain の形式で入力します。これは、サーバーの公開 URL、または技術チームから提供されたロックされたゲートウェイの URL のいずれかになります。

5. ロックされたゲートウェイを使用している場合は、技術チームから提供された HTTP リクエスト・ヘッダー名と API キーの値を入力します。

6. [次へ] を選択します。

GitHub アプリの作成

GitHub Enterprise Server に接続してから、そのサーバー上にアプリを作成して、Jira サイトへのデータのフローを管理する必要があります。このアプリは、サイトで利用できるリポジトリや、チームが GitHub のコミット メッセージを通じてトリガーできる Jira 自動化などの設定も制御します。

このアプリは、GitHub Enterprise Server で自動的に作成することも、Jira で提供される情報を使用して手動で作成することもできます。どちらの方法を使用しても結果はまったく同じであるため、より便利な自動作成をお勧めします。

アプリを自動的に作成する (推奨)

1. [アプリの自動作成] を選択します。GitHub にリダイレクトされ、アプリが自動的に作成されます。

2. アプリに固有の名前を付けて、[Create GitHub App (GitHub アプリを作成)] をクリックします。

3. http(s)://<your-github-enterprise-server-domain>/settings/apps/<your-github-app-name にアクセスして、ホームページの URL をアプリの名前が含まれるように更新します。

アプリを手動で作成する

If you're creating the app manually, you’ll need to create a GitHub App within your GitHub Enterprise Server account. Show me how to manually create a GitHub app

レガシー接続をアンインストールする

After you have connected all your GitHub Enterprise organizations to GitHub for Atlassian, you can remove them from DVCS.

1. Make sure you have added all your GitHub Enterprise organizations to GitHub for Atlassian.

2. [Jira 設定] に移動して、[製品] > [DVCS アカウント] の順に選択します。

3. DVCS から削除する組織で、[その他のアクション] () を選択して、[切断] を選択します。