Migrating your enterprise to the Container registry from the Docker registry

You can migrate Docker images previously stored in the Docker registry on votre instance GitHub Enterprise Server to the Container registry.

Qui peut utiliser cette fonctionnalité ?

Enterprise owners can migrate Docker images to the Container registry.

Dans cet article

Remarque : Container registry est actuellement en version bêta pour GitHub Enterprise Server et susceptible d’être modifié.

GitHub Packages et l’isolation de sous-domaine doivent être activés pour utiliser Container registry. Pour plus d’informations, consultez « Utilisation du registre de conteneurs ».

About the Container registry

Le Container registry stocke des images conteneur dans votre organisation ou compte personnel et vous permet d’associer une image à un dépôt. Vous pouvez choisir d’hériter des autorisations d’un dépôt ou de définir des autorisations granulaires indépendamment d’un dépôt. Vous pouvez également accéder aux images conteneur publiques de manière anonyme. For more information, see "Utilisation du registre de conteneurs."

For more information about configuring GitHub Packages for votre instance GitHub Enterprise Server, see "Bien démarrer avec GitHub Packages pour votre entreprise."

About migration from the Docker registry

Le Container registry remplace le registre Docker de GitHub. If the Docker registry on votre instance GitHub Enterprise Server contains images, you must manually migrate the images to the Container registry.

Note: GitHub Enterprise Server 3.6 prend en charge la migration des images Docker stockées dans les organisations. Une future version prendra en charge la migration des images appartenant à l’utilisateur.

Tous les scripts ou workflows GitHub Actions qui utilisent l’espace de noms pour le registre Docker, docker.HOSTNAME, continueront de fonctionner après la migration vers le Container registry à l’emplacement containers.HOSTNAME. For more information about the impact of migration to the Container registry, see "Migration vers le registre de conteneurs à partir du registre Docker."

Migrating organizations to the Container registry

You can start a migration of all your organizations' Docker images to the Container registry. The duration of the migration operation depends on the total number of images to migrate, and the overall load on your instance. After a successful migration, GitHub Enterprise Server will display a summary, and all future uploads of Docker images will use the Container registry.

If a site administrator has configured email notifications for votre instance GitHub Enterprise Server, you will receive an email after the migration is complete. For more information, see "Configuration de la messagerie pour les notifications."

Notes:

  • During the migration, the CPU and memory usage for your instance will increase. To ensure the performance of the instance for your users, GitHub recommends that you begin a migration during a period of reduced activity.
  • During the migration, do not modify settings for your enterprise or run ghe-config-apply from an administrative SSH session. These actions will trigger a configuration run, which can restart services and may interrupt the migration.
  • After the migration, storage pressure on your instance will increase due to the duplication of image files in the Docker registry and the Container registry. A future release of GitHub Enterprise Server will remove the duplicated files when all migrations are complete.

For more information about monitoring the performance and storage of votre instance GitHub Enterprise Server, see "Accès au tableau de bord moniteur."

  1. Dans le coin supérieur droit de GitHub Enterprise Server, cliquez sur votre photo de profil, puis sur Paramètres d’entreprise.

    Capture d’écran du menu déroulant qui s’affiche lorsque vous cliquez sur la photo de profil sur GitHub Enterprise Server. L’option « Paramètres d’entreprise » est mise en évidence avec un contour orange foncé.

  2. Dans la barre latérale du compte d’entreprise, cliquez sur Paramètres.

  3. In the left sidebar, click Packages.

  4. To the right of the number of packages to migrate, click Start migration. During the migration, GitHub Enterprise Server will display progress on this page.

After the migration completes, the page will display the results. If a migration fails, the page will show the organizations that own the package that caused the failure.

Re-running a failed organization migration

Prior to migration, if a user has created a package in the Container registry that has an identical name to an existing package in the Docker registry, the migration will fail.

  1. Delete the affected container in the Container registry. For more information, see "Suppression et restauration d'un package."

  2. Dans le coin supérieur droit de GitHub Enterprise Server, cliquez sur votre photo de profil, puis sur Paramètres d’entreprise.

    Capture d’écran du menu déroulant qui s’affiche lorsque vous cliquez sur la photo de profil sur GitHub Enterprise Server. L’option « Paramètres d’entreprise » est mise en évidence avec un contour orange foncé.

  3. Dans la barre latérale du compte d’entreprise, cliquez sur Paramètres.

  4. Dans la barre latérale gauche, cliquez sur Packages.

  5. To the right of the number of packages to migrate, click Re-run migration. During the migration, GitHub Enterprise Server will display progress on this page.

  6. If the migration fails again, start from step 1 and re-run the migration.