Hallo, Entdecker! An dieser Seite wird aktiv gearbeitet, oder sie wird noch übersetzt. Die neuesten und genauesten Informationen findest Du in unserer englischsprachigen Dokumentation.

Diese Version von GitHub Enterprise wurde eingestellt am 2021-03-02. Es wird keine Patch-Freigabe vorgenommen, auch nicht für kritische Sicherheitsprobleme. Für eine bessere Leistung, verbesserte Sicherheit und neue Features nimm ein Upgrade auf die neueste Version von GitHub Enterprise vor. Wende Dich an den GitHub Enterprise-Support, um Hilfe beim Upgrade zu erhalten.

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 ist verfügbar mit GitHub One. Weitere Informationen findest Du unter „Produkte von GitHub.“

Inhalt dieses Artikels

Vorrausetzungen

  • 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 erfordert eine Maschine, die als Anwendungsserver bezeichnet wird und entweder in der Cloud oder lokal gehostet wird. For more information, see "System overview for GitHub Insights."

  • You must install dependencies on the application server.

    Hinweis: Der Anwendungsserver erfordert möglicherweise, dass der Docker-Daemon als sudo ausgeführt wird. Kubernetes wird nicht unterstützt.

Eine GitHub App erstellen

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. Melde Dich unter http(s)://HOSTNAME/login bei your GitHub Enterprise Server instance an.

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

  3. Klicke unter Deinem Organisationsnamen auf Settings (Einstellungen).

    Schaltfläche „Organization settings" (Organsationseinstellungen)

  4. Klicke auf der linken Seitenleiste auf GitHub App.

    Einstellungen für 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 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.

    Feld „Webhook secret" (Webhook-Geheimnis)

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

    • Repository:
      • Contents: Read-only
      • Metadata: Read-only
      • Pull requests: Read-only
      • Commit statuses: Read-only
    • Organisation:
      • Members: Read-only
      • Projects: Read-only

    Permissions drop-down menus

  13. Under "Subscribe to events", select:

    • Member
    • Pull Request
    • Push
    • Repository
    • Team
      Subscribe to events checkboxes
  14. To enable the GitHub App to access data from any user or organization in your GitHub Enterprise Server instance, under "Where can this GitHub App be installed?", select Any account.

    Radio buttons to enable access to any account

  15. Click Create GitHub App.

    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

GitHub Insights installieren

  1. From the application server, navigate to the latest release of GitHub Insights on the Releases page for github/insights-releases.
  2. Um den neuesten Release herunterzuladen, klicke unter „Assets" (Objekte) auf insights-VERSION.tar.gz.
    Installations-Objekt
  3. Entpacke das Verzeichnis.
  4. Führe das Shellskript install.sh aus.
  5. Um SSL zu aktivieren, gib das SSL-Zertifikat (.crt/.cer/.pem) ein. Wenn Du SSL nicht aktivieren willst, lässt Du es leer.
  6. Wenn Du SSL aktivieren möchtest, gibst Du den SSL-Schlüssel (.key) ein. Andernfalls lässt Du es leer.
  7. Gib den Hostnamen ein, der dieselbe URL ist, die Du beim Erstellen der GitHub App für den Anwendungsserver verwendet hast.
  8. Die Ausführung der Installation dauert einige Minuten. Nach Beendigung wirst Du eine Nachricht auf dem Terminal sehen.
    Installation complete
    Run /opt/insights/scripts/start.sh to start GitHub Insights
    
  9. Um GitHub Insights zu starten, führe das Shellskript /opt/insights/scripts/start.sh aus.
  10. Wenn Du GitHub Insights zum ersten Mal startest, dauert die Ausführung des Script einige Minuten. Nach Beendigung wirst Du eine Nachricht auf dem Terminal sehen.
    GitHub Insights is running!
    

GitHub Insights konfigurieren

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 Feld
  3. Klicke unter „GitHub Insights License" (Lizenz) auf „Choose Files" (Dateien Auswählen), dann lade Deine GitHub Enterprise Lizenzdatei.
    Schaltfläche „Choose Files" (Dateien Auswählen)
  4. Gib unter „App ID" die App-ID Deiner GitHub App ein, die Du beim Erstellen der App erfasst hast.
    Feld „App-ID"
  5. Gib unter „Client ID" die Client-ID Deiner GitHub App ein, die Du beim Erstellen der App erfasst hast.
    Feld „Client-ID"
  6. Unter „Client Secret" gibst Du das Client-Geheimnis Deiner GitHub App ein, das Du beim Erstellen der App erfasst hast.
    Feld „Client Secret" (Kundengeheimnis)
  7. Unter "Private Key" (Privater Schlüssel) gibst Du den privaten Schlüssel Deiner GitHub App ein, die in der PEM-Datei vorhanden ist, die Du beim Erstellen der App heruntergeladen hast.
    Feld „Private key" (Privater Schlüssel)
  8. Gib unter "Webhook Secret" das Webhook-Geheimnis Deiner GitHub App ein, das Du beim Erstellen der App aufgezeichnet hast.
    Feld „Webhook secret" (Webhook-Geheimnis)
  9. Wenn Du während der Installation kein SSL-Zertifikat angegeben hast, wähle Skip SSL Certificate Check (SSL-Zertifikatsprüfung überspringen).
    Kontrollkästchen zum Überspringen der SSL-Zertifikatsprüfung
  10. Klicke auf Submit (Einreichen).
  11. Click Log in with GitHub.
  12. To authorize the GitHub App and access GitHub Insights, click Authorize GitHub App.

Weiterführende Informationen