GitHub アプリを手動で作成します。

このページの説明は、Jira Software を GitHub Enterprise Server と統合する目的で GitHub アプリを手動作成する場合に特化した内容です。

  • アプリを自動作成する場合 (より簡単で、GitHub Server がバージョン 3.1 以降で動作している場合に推奨) は、「GitHub Server との統合: アプリの自動作成」をご参照ください。

  • GitHub Cloud または GitHub Enterprise Cloud を使用している場合、GitHub アプリは一切必要ありません。GitHub Cloud との統合をご覧ください。

アプリの手動作成

GitHub アプリを手動で作成している場合は、手動アプリ作成ページにリダイレクトされます。そのページを開いたままにして、別のタブで GitHub の Web サイトにアクセスします。

GitHub でアプリを作成する

GitHub Enterprise Server アカウントにログインします。

  1. http(s)://<your-domain>/settings/apps開発者設定に移動します。

  2. [GitHub アプリ] を選択してから、[新しい GitHub アプリ] を選択します。

  3. アプリに固有の名前を付けて、必要に応じて説明を追加します。

  4. http(s)://<your-domain>/apps/<your-github-app-name という構成でドメインとアプリ名を挿入して、ホームページ URL を作成します。


Jira から GitHub に URL をコピーする

次に、Jira のアプリ手動作成ページから URL をコピーします。

  1. Jira からユーザー認証コールバック URL をコピーして、GitHub のコールバック URL フィールドに貼り付けます。

  2. Jira からセットアップ URL をコピーして、GitHub のセットアップ URL フィールドに貼り付けます。

  3. Jira から Webhook URL をコピーして、GitHub の Webhook URL フィールドに貼り付けます。

  4. Webhook シークレットを追加します。GitHub ではこのフィールドはオプションですが、Jira が Webhook イベントをリッスンして処理するには必須です。「mycompanyiswesome」のように、ランダムまたは単純な文字列を入力できます。

GitHub で権限とサブスクリプションを指定する

Jira が GitHub からのイベントをリッスンして、プロジェクトに開発データを入力できるようにするには、GitHub でリポジトリ レベルと組織レベルの両方に権限を付与し、イベントをサブスクライブする必要があります。

  • 追加が必要なリポジトリ権限は、アクション (読み取り専用)、コンテンツ (読み取りと書き込み)、デプロイ (読み取り専用)、課題 (読み取りと書き込み)、メタデータ (読み取り専用、必須)、プル リクエスト (読み取りと書き込み) です。注記: 書き込み権限はオプションですが、この権限がないと、ブランチの作成機能は働きません。

  • 追加が必要な組織権限は、メンバー (読み取り専用) です。

  • 選択するイベント サブスクリプションは、セキュリティ アドバイザリー、コミット コメント、作成、削除、デプロイ ステータス、課題コメント、課題、プル リクエスト、プル リクエスト レビュー、プッシュ、リポジトリ、ワークフロー実行です。

    GitHub Enterprise Server アカウントを Jira Software に接続するには、GitHub インスタンスにアプリを作成する必要があります。アプリは自動でも手動でも作成できます。このページでは、アプリを手動で作成する方法を説明します。


GitHub アプリの詳細を入力する

  1. GitHub アプリ フォームのすべてのフィールドを確認します。

  2. [Create GitHub App (GitHub アプリを作成)] をクリックして保存し、Jira の最後のステップに進みます。


Jira のアプリ手動作成ページに入力する

GitHub からアプリ IDクライアント ID のフィールドをコピーして、Jira の対応する各フィールドに貼り付けます。

  1. GitHub で [新しいクライアント シークレットを生成] を選択して、ページが更新されるのを待ってから、そのシークレットをコピーして Jira の [GitHub クライアント シークレット] フィールドに貼り付けます。

  2. GitHub で [非公開キーを生成] を選択して、PEM ファイルをダウンロードします。このファイルを Jira の [非公開キー] フィールドにアップロードします。

  3. [GitHub アプリの名前] と [Webhook シークレット] の各フィールドが GitHub と Jira で一致していることを確認します。Webhook シークレットを表示するには、GitHub の Webhook シークレット フィールドで [編集] を選択して、その値を Jira にコピーします。


その他のヘルプ