Jira Software を GitHub Enterprise Server に接続する

GitHub Enterprise Server を Jira Software に接続すると、チームで開発アクティビティを Jira 課題にリンクできます。このアプリを使用して、Jira 課題のコンテキストで、Jira ボード、リリース機能などでブランチ、コミット、プル リクエストを追跡できます。

はじめる前に

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

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

お使いの GitHub Enterprise Server はファイアウォールの向こう側にあります。Jira Software サイトに接続する前に、そのファイアウォールに穴を開けて 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 Software で、[アプリ]、[その他のアプリを探す] の順に選択します。

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 Software サイトへのデータのフローを管理する必要があります。このアプリは、サイトで利用できるリポジトリや、チームが 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 ページを確認する

• 問題を報告する

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