Skip to main content

Syncing license usage from GitHub Enterprise Server to Cloud

You can sync license usage from GitHub Enterprise Server to GitHub Enterprise Cloud to view all license usage across your enterprise in one place and ensure that people with accounts in both environments only consume one user license.

Wer kann dieses Feature verwenden?

Enterprise owners can sync license usage between enterprise accounts on GitHub Enterprise Server and GitHub Enterprise Cloud.

About synchronization of license usage

GitHub verwendet ein Lizenzmodell für eindeutige Benutzer. Mit dem GitHub Enterprise-Plan bist du berechtigt, sowohl GitHub Enterprise Cloud als auch GitHub Enterprise Server zu verwenden. Dein GitHub Enterprise Cloud-Kontingent beinhaltet eine Bereitstellung auf GitHub.com oder auf GHE.com.

GitHub bestimmt, wie viele Lizenzen du basierend auf der Anzahl der eindeutiger benutzender Personen in deinen Bereitstellungen belegst. Jedes Benutzerkonto verbraucht nur eine Lizenz, unabhängig davon, wie viele GitHub Enterprise Server-Instanzen der Benutzer verwendet oder bei wie vielen Organisationen der Benutzer in deiner GitHub Enterprise Cloud-Bereitstellung Mitglied ist. Dieses Modell ermöglicht es jeder Person, mehrere GitHub Enterprise-Bereitstellungen zu nutzen, ohne dass zusätzliche Kosten anfallen.

Damit eine Person, die mehrere GitHub Enterprise-Umgebungen nutzt, nur eine einzige Lizenz benötigt, musst du die Lizenznutzung zwischen den Umgebungen synchronisieren. Dann werden die Benutzer von GitHub anhand der E-Mail-Adressen dedupliziert, die ihren Benutzerkonten zugeordnet sind. Deduplizierte GitHub-Lizenzen für den GitHub Enterprise-Plan selbst und für GitHub Advanced Security-Produkte, wenn du GitHub Enterprise Server Version 3.12 oder höher verwendest Weitere Informationen finden Sie unter Troubleshooting license usage for GitHub Enterprise.

To ensure that you see up-to-date license details on GitHub Enterprise Cloud, you can sync license usage to GitHub.com automatically, using GitHub Connect. For more information about GitHub Connect, see About GitHub Connect in the GitHub Enterprise Server documentation.

If you don't want to enable GitHub Connect, you can manually sync license usage by uploading a file from GitHub Enterprise Server to GitHub.com.

When you synchronize license usage, only the user ID and email addresses for each user account on GitHub Enterprise Server are transmitted to GitHub Enterprise Cloud.

Nachdem du die Lizenznutzung synchronisiert hast, kannst du einen Bericht über verbrauchte Lizenzen in allen deinen Umgebungen in den Unternehmenseinstellungen auf GitHub Enterprise Cloud sehen. Weitere Informationen finden Sie unter Viewing usage for your GitHub Enterprise plan.

Hinweis

Wenn du von der Synchronisierung der Lizenznutzung Gebrauch machst und keine Enterprise Managed Users verwendest, empfehlen wir dringend, überprüfte Domänen für dein Unternehmenskonto auf GitHub Enterprise Cloud zu aktivieren, um die Fehlerbehebung zu erleichtern. Weitere Informationen findest du unter Überprüfen oder Genehmigen einer Domäne für dein Unternehmen.

Automatically syncing license usage

You can use GitHub Connect to automatically synchronize user license count and usage between GitHub Enterprise Server and GitHub Enterprise Cloud weekly. For more information, see Enabling automatic user license sync for your enterprise in the GitHub Enterprise Server documentation.

After you enable GitHub Connect, license data will be automatically synchronized weekly. You can also manually synchronize your license data at any time, by triggering a license sync job.

Triggering a license sync job

  1. Sign in to your GitHub Enterprise Server instance.

  2. Klicken Sie in der oberen rechten Ecke von GitHub Enterprise Server auf Ihr Profilfoto und dann auf Unternehmenseinstellungen.

    Screenshot des Dropdownmenüs, das angezeigt wird, wenn du in GitHub Enterprise Server auf das Profilfoto klickst. Die Option „Enterprise settings“ ist hervorgehoben.

  3. Klicke oben auf der Seite auf Settings.

  4. Klicke unter Einstellungen auf Lizenzierung.

    Hinweis

    Wenn du dich auf der neuen Abrechnungsplattform befindest, wurde die Lizenzierungsseite verschoben. Weitere Informationen findest du unter Sammeln von Erkenntnissen zu deinen Ausgaben.

  5. Under "License sync", click Sync now.

Manually uploading GitHub Enterprise Server license usage

You can download a JSON file from GitHub Enterprise Server and upload the file to GitHub Enterprise Cloud to manually sync user license usage between the two deployments.

  1. Sign in to your GitHub Enterprise Server instance.

  2. Klicken Sie in der oberen rechten Ecke von GitHub Enterprise Server auf Ihr Profilfoto und dann auf Unternehmenseinstellungen.

    Screenshot des Dropdownmenüs, das angezeigt wird, wenn du in GitHub Enterprise Server auf das Profilfoto klickst. Die Option „Enterprise settings“ ist hervorgehoben.

  3. Klicke oben auf der Seite auf Settings.

  4. Klicke unter Einstellungen auf Lizenzierung.

    Hinweis

    Wenn du dich auf der neuen Abrechnungsplattform befindest, wurde die Lizenzierungsseite verschoben. Weitere Informationen findest du unter Sammeln von Erkenntnissen zu deinen Ausgaben.

  5. In the "User licenses" section, under "Quick links", to download a file containing your current license usage on GitHub Enterprise Server, click Export license usage.

    Screenshot of the "User licenses" section of the "License" page. A link, labeled "Export license usage", is outlined in dark orange.

  6. Navigieren Sie zu GitHub Enterprise Cloud.

  7. Klicken Sie in der oberen rechten Ecke von GitHub auf Ihr Profilfoto und dann auf Ihre Unternehmen.

  8. Klicke in der Liste der Unternehmen auf das Unternehmen, das du anzeigen möchtest.

  9. Klicke oben auf der Seite auf Settings.

  10. Klicke unter Einstellungen auf Lizenzierung.

    Hinweis

    Wenn du dich auf der neuen Abrechnungsplattform befindest, wurde die Lizenzierungsseite verschoben. Weitere Informationen findest du unter Sammeln von Erkenntnissen zu deinen Ausgaben.

  11. Next to "Enterprise Server instances", click Add server usage.

  12. Upload the JSON file you downloaded from GitHub Enterprise Server.