Jira を GitHub Enterprise Server に接続する

When you connect a GitHub Enterprise Server to Jira, your team can link their development activity to Jira work items. Use this app to 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 キーの値。

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

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

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

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

GitHub Enterprise Server を接続する

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

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 組織を Jira 向け GitHub に接続したら、DVCS から削除できます。

1. すべての GitHub Enterprise 組織が Jira 向け GitHub に追加されていることをご確認ください。

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

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

    

その他のリソース

GitHub Enterprise Server 用 GitHub for Jira のセットアップと利用方法の詳細を確認してサポートを受ける方法は、次のとおりです。

• FAQ ページを確認する

• 問題を報告する

• アトラシアンのチームに連絡する