Jira を GitHub Enterprise Server に接続する

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

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

はじめる前に

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 キーの値。

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

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

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

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

GitHub Enterprise Server を接続する

1. GitHub for Atlassian アプリをインストールした後、[開始する] を選択します。アプリが Jira サイトにすでにインストールされている場合は、[アプリ]、[アプリを管理]、[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 をアプリの名前が含まれるように更新します。

アプリを手動で作成する

アプリを手動で作成する場合は、GitHub Enterprise Server アカウント内に GitHub アプリを作成する必要があります。GitHub アプリを手動で作成する方法については、こちらをご確認ください。

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

すべての GitHub Enterprise 組織を GitHub for Atlassian に接続したら、DVCS から削除できます。

1. すべての GitHub Enterprise 組織が GitHub for Atlassian に追加されていることを確認します。

2. [Jira 設定] () に移動し、[Jira アプリ]、[DVCS アカウント] の順に選択します。

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