Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Esta versão do GitHub Enterprise será descontinuada em Esta versão do GitHub Enterprise foi descontinuada em 2020-05-23. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

Versão do artigo: Enterprise Server 2.17

Installing GitHub Insights

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

Organization owners in GitHub Enterprise with read permissions to the github/insights-releases repository and administrative access to the application server can install GitHub Insights.

GitHub Insights is available with GitHub One. Para obter mais informações, consulte os "Produtos da GitHub".

Neste artigo

Pré-requisitos

  • You must have a GitHub Enterprise license file that includes GitHub Insights. After you purchase GitHub Insights, you can download the updated license file in the GitHub Enterprise web portal.

  • GitHub Insights requires a machine, called the application server, hosted either in the cloud or locally. For more information, see "System overview for GitHub Insights."

  • You must install dependencies on the application server.

    Note: The application server may require the Docker daemon to be run as sudo. Kubernetes is not supported.

Criar um aplicativo GitHub

To connect GitHub Insights to GitHub Enterprise, you must create a aplicativo GitHub 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. Sign in to sua instância do GitHub Enterprise Server at http(s)://HOSTNAME/login.

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

  3. Under your organization name, click Settings.

    Organization settings button

  4. Na barra lateral esquerda, clique em aplicativo GitHubs.

    aplicativo GitHubs settings

  5. Click New aplicativo GitHub.

    New GitHub App button

  6. Under "aplicativo GitHub 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 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 application server.

    <application-server-url>/public/applogin
    

    User authorization callback field

  9. Under "Setup URL", type <application-server-url>/public/setup.

    Setup URL field

  10. Under "Webhook URL", type <application-server-url>/webhooks.

    Webhook URL field

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

    Webhook secret field

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

    • Repositório:
      • Contents: Read-only
      • Metadata: Read-only
      • Pull requests: Read-only
      • Commit statuses: Read-only
    • organização:
      • Members: Read-only
      • Projects: Read-only

    Permissions drop-down menus

  13. Under "Subscribe to events", select:

    • Member
    • Pull request
    • Push
    • Repositório
    • Team
      Subscribe to events checkboxes
  14. To enable the aplicativo GitHub to access data from any user or organization in sua instância do GitHub Enterprise Server, under "Where can this aplicativo GitHub be installed?", select Any account.

    Radio buttons to enable access to any account

  15. Click Create aplicativo GitHub.

    Create GitHub App button

  16. Review your app's configuration.

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

    Generate a private key button

  18. Save the resulting PEM file for later reference.

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

    • App ID
    • Client ID
    • Client secret
    • Private key
    • Webhook secret

Instalar o GitHub Insights

  1. From the application server, 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 insights-VERSION.tar.gz.
    Installation assset
  3. Unzip the directory.
  4. Run the shell script install.sh.
  5. To enable SSL, enter the SSL Cert (.crt/.cer/.pem). If you don't want to enable SSL, leave blank.
  6. If you chose to enable SSL, enter the SSL Key (.key). Otherwise, leave blank.
  7. Enter the hostname, which is the same URL you used for the application server when creating the aplicativo GitHub.
  8. The installation will take a few minutes to run. When complete, you will see a message printed to the terminal.
    Installation complete
    Run /opt/insights/scripts/start.sh to start GitHub Insights
    
  9. To start GitHub Insights, run the shell script /opt/insights/scripts/start.sh.
  10. If this is the first time starting GitHub Insights the script will take a few minutes to run. When complete, you will see a message printed to the terminal.
    GitHub Insights is running!
    

Configurar o 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 "GitHub API URL", type the URL you use to access GitHub Enterprise.
    GitHub Enterprise API URL field
  3. Under "GitHub Insights License", click "Choose Files", then upload your GitHub Enterprise license file.
    Choose Files button
  4. Under "App ID", type the App ID of your aplicativo GitHub, which you recorded when creating the app.
    App ID field
  5. Under "Client ID", type the client ID of your aplicativo GitHub, which you recorded when creating the app.
    Client ID field
  6. Under "Client Secret", type the client secret of your aplicativo GitHub, which you recorded when creating the app.
    Client secret field
  7. Under "Private Key", type in the private key of your aplicativo GitHub, which is contained in the PEM file you downloaded while creating the app.
    Private key field
  8. Under "Webhook Secret", type the webhook secret of your aplicativo GitHub, which you recorded when creating the app.
    Webhook secret field
  9. If you did not provide a SSL certificate during installation, select Skip SSL Certificate Check.
    Checkbox to skip SSL certificate check
  10. Clique em Submit (Enviar).
  11. Click Log in with GitHub.
  12. To authorize the aplicativo GitHub and access GitHub Insights, click Authorize aplicativo GitHub.

Leia mais

Pergunte a uma pessoa

Não consegue encontrar o que procura?

Entrar em contato