Sincronizar o uso de licença do GitHub Enterprise Server para Nuvem

Você pode sincronizar o uso de licenças do GitHub Enterprise Server com o GitHub Enterprise Cloud para exibir todo o uso de licenças em sua empresa em um só lugar e garantir que as pessoas com contas em ambos os ambientes consumam apenas uma licença de usuário.

Quem pode usar esse recurso?

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

Neste artigo

A GitHub Enterprise license allows a user to use both GitHub Enterprise Cloud and GitHub Enterprise Server. See Combined GitHub Enterprise cloud and server use.

To view combined license details on GitHub Enterprise Cloud and ensure users only consume one license, you must sync licenses between deployments. You can do this:

  • Automatically, using GitHub Connect.
  • Manually, by uploading a license file from from GitHub Enterprise Server to GitHub.

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.

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.

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.

Enabling automatic license sync

To enable license sync, you must:

  1. Enable GitHub Connect. See Enabling GitHub Connect for GitHub.com or Enabling GitHub Connect for GHE.com in the GitHub Enterprise Server documentation.
  2. Enable license sync. See Enabling GitHub Connect for GitHub.com in the GitHub Enterprise Server documentation.

Triggering a license sync job

  1. Sign in to your GitHub Enterprise Server instance.
  2. In the top-right corner of GitHub Enterprise Server, click your profile picture, then click Enterprise settings.
  3. At the top of the page, click Settings.
  4. Under Settings, click Licensing.
  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. In the top-right corner of GitHub Enterprise Server, click your profile picture, then click Enterprise settings.

  3. At the top of the page, click Settings.

  4. Under Settings, click Licensing.

  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. Navigate to GitHub Enterprise Cloud.

  7. In the top-right corner of GitHub, click your profile picture, then click Your enterprises.

  8. In the list of enterprises, click the enterprise you want to view.

  9. At the top of the page, click Billing and licensing.

  10. Click Licensing to show detailed information on license use.

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

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

Next steps

After you synchronize license usage, you can see a report of consumed licenses across all your environments in the enterprise settings on GitHub Enterprise Cloud. For more information, see Viewing usage for your GitHub Enterprise plan.

To make troubleshooting easier, if you synchronize license usage and do not use Enterprise Managed Users, we highly recommend enabling verified domains for your enterprise account on GitHub Enterprise Cloud. See Verifying or approving a domain for your enterprise.