Jira を GitHub Enterprise Server に接続する

このトピックでは、GitHub Enterprise Server への接続に関して説明します。GitHub Cloud アカウントを接続する場合は、「GitHub Cloud と Jira の接続」を参照してください。

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

はじめる前に

Jira 向け GitHub アプリをインストールしてセットアップするには、次のものが必要です。

  • Jira サイトのサイト管理者権限

  • GitHub 組織の所有者権限

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 で提供される情報を使用して手動で作成することもできます。どちらの方法を使用しても結果はまったく同じであるため、より便利な自動作成をお勧めします。

このアプリを自動的に作成するには、お使いの GitHub Enterprise Server がソフトウェアのバージョン 2.19 以降を実行している必要があります。GitHub Enterprise Server のアップグレード方法に関しては、こちらをご確認ください。

  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 for Jira アプリは、従来の DVCS コネクターに代わるものです。

DVCS コネクターを使用している場合は、2024 年 3 月 31 日以降は DVCS コネクターがサポートされなくなるため、接続を GitHub for Jira に移行することを強くお勧めします。GitHub for Jira への移行に関する詳細をご確認ください。

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

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

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

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

     


その他のリソース

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

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。