Cette version de GitHub Enterprise Server n'est plus disponible depuis le 2024-03-26. Aucune publication de correctifs n’est effectuée, même pour les problèmes de sécurité critiques. Pour de meilleures performances, une sécurité améliorée et de nouvelles fonctionnalités, effectuez une mise à niveau vers la dernière version de GitHub Enterprise. Pour obtenir de l’aide sur la mise à niveau, contactez le support GitHub Enterprise.

Migration de votre entreprise vers le registre de conteneurs à partir du registre Docker

Vous pouvez migrer des images Docker stockées dans le registre Docker sur votre instance GitHub Enterprise Server vers le 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 ».

À propos du 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. Pour plus d’informations, consultez « Utilisation du registre de conteneurs ».

Pour plus d’informations sur la configuration de GitHub Packages pour votre instance GitHub Enterprise Server, consultez « Bien démarrer avec GitHub Packages pour votre entreprise ».

À propos de la migration à partir du registre Docker

Le Container registry remplace le registre Docker de GitHub. Si le registre Docker sur votre instance GitHub Enterprise Server contient des images, vous devez migrer manuellement ces images vers le Container registry.

Remarque : 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. Pour plus d’informations sur l’impact de la migration vers le Container registry, consultez « Migration vers le registre de conteneurs à partir du registre Docker ».

Migration des organisations vers le Container registry

Vous pouvez démarrer une migration de toutes les images Docker de vos organisations vers le Container registry. La durée de l’opération de migration dépend du nombre total d’images à migrer et de la charge globale sur votre instance. Après une migration réussie, GitHub Enterprise Server affiche un récapitulatif, et tous les chargements futurs d’images Docker utiliseront le Container registry.

Si un administrateur de site a configuré les notifications par e-mail pour votre instance GitHub Enterprise Server, vous recevrez un e-mail une fois la migration effectuée. Pour plus d’informations, consultez « Configuration de la messagerie pour les notifications ».

Remarques :

  • Pendant la migration, l’utilisation du processeur et de la mémoire de votre instance augmente. Pour garantir les performances de l’instance pour vos utilisateurs, GitHub recommande de commencer une migration pendant une période d’activité réduite.
  • Pendant la migration, ne modifiez pas les paramètres de votre entreprise et n’exécutez pas ghe-config-apply à partir d’une session SSH administrative. Ces actions déclencheront une exécution de configuration, qui peut redémarrer les services et interrompre la migration.
  • Après la migration, la pression de stockage sur votre instance augmente en raison de la duplication des fichiers image dans le registre Docker et le Container registry. Une version ultérieure de GitHub Enterprise Server supprimera les fichiers dupliqués quand toutes les migrations seront terminées.

Pour plus d’informations sur le monitoring des performances et du stockage de votre instance GitHub Enterprise Server, consultez « 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. Dans la barre latérale gauche, cliquez sur Packages.

  4. À droite du nombre de packages à migrer, cliquez sur Démarrer la migration. Pendant la migration, GitHub Enterprise Server affiche la progression sur cette page.

Une fois la migration terminée, la page affiche les résultats. Si une migration échoue, la page montre les organisations qui détiennent le package qui a provoqué l’échec.

Réexécution d’une migration d’organisation ayant échoué

Avant la migration, si un utilisateur a créé un package dans le Container registry qui a un nom identique à un package existant dans le registre Docker, la migration échoue.

  1. Supprimez le conteneur affecté dans le Container registry. Pour plus d’informations, consultez « 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. À droite du nombre de packages à migrer, cliquez sur Réexécuter la migration. Pendant la migration, GitHub Enterprise Server affiche la progression sur cette page.

  6. Si la migration échoue à nouveau, recommencez depuis l’étape 1 et réexécutez la migration.