ドキュメントには頻繁に更新が加えられ、その都度公開されています。本ページの翻訳はまだ未完成な部分があることをご了承ください。最新の情報については、英語のドキュメンテーションをご参照ください。本ページの翻訳に問題がある場合はこちらまでご連絡ください。

このバージョンの GitHub Enterprise はこの日付をもって終了となります: このバージョンの GitHub Enterprise はこの日付をもって終了となりました: 2020-01-22. 重大なセキュリティの問題に対してであっても、パッチリリースは作成されません。 パフォーマンスの向上、セキュリティの改善、新機能のためには、最新バージョンのGitHub Enterpriseにアップグレードしてください。 アップグレードに関する支援については、GitHub Enterprise supportに連絡してください。

Installing GitHub Insights

You can install GitHub Insights and connect the standalone application to GitHub Enterprise.

Organization owners in GitHub Enterprise can install GitHub Insights.

GitHub InsightsはGitHub Oneで利用できます。 詳細は「GitHub の製品」を参照してください。

ここには以下の内容があります:

必要な環境

  • You must have a GitHub Enterprise license file that has been updated to include GitHub Insights. GitHub will provide the license file when you purchase GitHub Insights.
  • GitHub Insights requires a minimum of two machines hosted either in the cloud or locally. For more information, see "System overview for GitHub Insights."

GitHub Appの作成

To connect GitHub Insights to GitHub Enterprise, you must create a GitHub App in an organization on GitHub Enterprise. A slugged version of your app's name will be shown on GitHub Enterprise when your integration takes an action.

  1. http(s)://HOSTNAME/loginでGitHub Enterprise Server インスタンスにサインインしてください。

  2. Navigate to the organization you'd like to connect to GitHub Insights.

  3. Organization名の下で、Settings(設定)をクリックしてください。

    Organizationの設定ボタン

  4. 左サイドバーで [GitHub Apps] をクリックします。

    GitHub Appの設定

  5. Click New GitHub App.

    New GitHub App button

  6. Under "GitHub App name", type a name for the app. Your app cannot have the same name as an existing user or organization, unless the name is your own user or organization name.

    GitHub App name field

  7. Under "Homepage URL", type the URL of the machine you will use as the application server for GitHub Insights. For more information, see "System overview for GitHub Insights."

    Homepage URL field

  8. Under "User authorization callback URL", type the following, replacing <application-server-url> with the URL of the machine you will use as the application server for GitHub Insights and <company-name> with the name of your company.

    <application-server-url>/public/applogin/<company-name>
    

    User authorization callback field

  9. Under "Webhook URL", type <application-server-url>/webhooks/<company-name>.

    Webhook URL field

  10. Under "Webhook secret", type a secret, then record the secret for later reference.

    Webhook secret field

  11. Under "Permissions", use the drop-down menus and configure the following permissions for the app.

    • Repository contents: Read-only
    • Repository metadata: Read-only
    • Pull requests: Read-only
    • Commit statuses: Read-only
    • Organization members: Read-only
    • Organization projects: Read-only
      Permissions drop-down menus
  12. Under "Subscribe to events", select:

    • プルリクエスト
    • プッシュ
    • Repository
      Subscribe to events checkboxes
  13. To enable the GitHub App to access data from any user or organization in GitHub Enterprise Server インスタンス, under "Where can this GitHub App be installed?", select Any account.

    Radio buttons to enable access to any account

  14. Click Create GitHub App.

    Create GitHub App button

  15. Review your app's configuration.

  16. Under "Private keys", click Generate a private key.

    Generate a private key button

  17. Save the resulting PEM file for later reference.

  18. Make note of the following information about your app for later reference.

    • App ID
    • クライアント ID
    • Client secret
    • Private key
    • Webhook secret

GitHub Insightsのインストール

Installing GitHub Insights requires Docker. The installation script will install Docker if able. If the script is not able to install Docker, the script will attempt to use an existing installation of Docker. If there is no existing installation of Docker on the host machines, the installation will fail.

  1. Navigate to the latest release of GitHub Insights on the Releases page for github/insights-releases.

  2. To download the latest release, under "Assets", click installation.tgz.

    Installation assset

  3. Unzip the directory.

  4. To configure the installation, run the shell script configure.sh. The script can be run from any machine that can SSH into the application and import servers and does not need to be run from either host machine.

  5. Enter the same URL you used for the application server when creating the GitHub App.

  6. Enter the SSH user for connecting to the application server.

  7. Enter the URL for the machine you will use as the import server for GitHub Insights. For more information, see "System overview for GitHub Insights."

  8. Enter the SSH user for connecting to the import server.

  9. Enter the path to the PEM key for SSH authentication with the application server.

  10. If you want to use a different PEM key for SSH authentication to the import server, enter the path to the PEM key. Otherwise, leave blank.

  11. If using a bastion host, enter the path to the public key (.pub). Otherwise, leave blank.

  12. To enable SSL, enter the SSL Cert (.crt). If you don't want to enable SSL, leave blank.

  13. If you chose to enable SSL, enter the SSL Key (.key). Otherwise, leave blank.

  14. If using a bastion host, enter the user and URL in the form of user@my.bastion.address. Otherwise, leave blank.

  15. If users will access GitHub Insights through a gateway or proxy, enter the base URL including the protocol in the form of protocol://host.

  16. The installation configuration is now saved. You will see a message printed to the terminal.

    Saving configured settings to /Users/octocat/Projects/insights/install/0.2.9/install_data/.env
    
  17. To start the installation, run the shell script release-assets/insights.sh.

  18. The installation will take a few minutes to run. When complete, you will see a message printed to the terminal.

    PLAY RECAP ********************************************
    application: ok=20   changed=7    unreachable=0    failed=0   
    import : ok=29   changed=9    unreachable=0    failed=0
    

GitHub Insights を設定する

To configure GitHub Insights to connect to GitHub Enterprise Server, you must provide the information you recorded in previous steps.

  1. In your browser, navigate to <application-server-url>/setup.

  2. Under "Company Name", type the same company name you used when creating the GitHub App.

    Company Name field

  3. Under "GitHub API URL", type the URL you use to access GitHub Enterprise.

    GitHub Enterprise API URL field

  4. Under "GitHub Insights License", click "Choose Files", then upload your GitHub Enterprise license file.

    Choose Files button

  5. Under "App ID", type the App ID of your GitHub App, which you recorded when creating the app.

    App ID field

  6. Under "Client ID", type the client ID of your GitHub App, which you recorded when creating the app.

    Client ID field

  7. Under "Client Secret", type the client secret of your GitHub App, which you recorded when creating the app.

    Client secret field

  8. Under "Private Key", type in the private key of your GitHub App, which is contained in the PEM file you downloaded while creating the app.

    Private key field

  9. Under "Webhook Secret", type the webhook secret of your GitHub App, which you recorded when creating the app.

    Webhook secret field

  10. インストール時にSSL証明書を手今日しなかった場合は、Skip SSL Certificate Check(SSL証明書のチェックのスキップ)を選択してください。

    Checkbox to skip SSL certificate check

  11. [Submit] をクリックします。

  12. Click Log in with GitHub.

  13. To authorize the GitHub App and access GitHub Insights, click Authorize GitHub App.

参考リンク

担当者にお尋ねください

探しているものが見つからなかったでしょうか?

弊社にお問い合わせください