Créer un dépôt distant Docker Hub

Créer un dépôt distant Docker Hub

Créez un dépôt distant pour servir de proxy pour Docker Hub.

Avant de commencer

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Artifact Registry, Secret Manager APIs.

   Enable the APIs

5. Install the Google Cloud CLI.

6. To initialize the gcloud CLI, run the following command:

   gcloud init

   Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.

7. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

8. Make sure that billing is enabled for your Google Cloud project.

9. Enable the Artifact Registry, Secret Manager APIs.

   Enable the APIs

10. Install the Google Cloud CLI.

11. To initialize the gcloud CLI, run the following command:

    gcloud init

    Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
12. Créez un compte Docker Hub.

Rôles requis

Pour obtenir les autorisations nécessaires pour créer un dépôt distant Docker Hub, demandez à votre administrateur de vous accorder les rôles IAM suivants :

• Pour créer des dépôts distants et accorder l'accès à des dépôts individuels : Administrateur Artifact Registry (roles/artifactregistry.admin) sur le projet
• Pour créer et gérer des secrets : Rôle "Administrateur" de Secret Manager (roles/secretmanager.admin) sur le projet

Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

Choisir une interface système

Pour suivre ce guide de démarrage rapide, utilisez Cloud Shell ou votre interface système locale.

Cloud Shell

Cloud Shell est un environnement shell permettant de gérer les ressources hébergées sur Google Cloud. Il est préinstallé avec Docker et la Google Cloud CLI, l'interface de ligne de commande principale de Google Cloud.

Interface système locale

Si vous préférez utiliser votre interface système locale, vous devez installer Docker et la gcloud CLI dans votre environnement.

Démarrer Cloud Shell

Pour lancer Cloud Shell, procédez comme suit :

1. Accédez à Google Cloud Console.

   Google Cloud Console

2. Cliquez sur le bouton Activer Cloud Shell : .

Une session Cloud Shell s'ouvre dans un cadre situé en bas de la console. Cette interface système vous permet d'exécuter les commandes gcloud.

Configurer une interface système locale

Pour installer la gcloud CLI et Docker, procédez comme suit:

1. Installez la CLI gcloud. Pour mettre à jour une installation existante, exécutez la commande gcloud components update.

   Remarque : Sous Ubuntu, utilisez le package Debian pour installer la CLI gcloud. Le package gcloud CLI Snap n'inclut pas kubectl ou des extensions pour s'authentifier auprès d'Artifact Registry avec la gcloud CLI.

2. Installez Docker si ce n'est pas encore fait.

3. Docker nécessite un accès privilégié pour interagir avec les registres. Sous Linux ou Windows, ajoutez l'utilisateur que vous permet d'exécuter des commandes Docker dans le groupe de sécurité Docker. Cette étape n'est pas requise sous macOS, car Docker Desktop s'exécute sur une machine virtuelle en tant qu'utilisateur racine.

   Linux

   Le groupe de sécurité Docker s'appelle docker. Pour ajouter votre nom d'utilisateur, exécutez la commande suivante :

   sudo usermod -a -G docker ${USER}
   

   Windows

   Le groupe de sécurité Docker s'appelle docker-users. Pour ajouter un utilisateur à partir de l'invite de commande administrateur, exécutez la commande suivante :

   net localgroup docker-users DOMAIN\USERNAME /add
   

   Où

   • DOMAIN est votre domaine Windows.
   • USERNAME est votre nom d'utilisateur.
   Remarque : Le groupe de sécurité Docker dispose d'un accès équivalent à l'utilisateur racine ou à l'utilisateur administrateur. N'ajoutez que des utilisateurs de confiance nécessitant un accès à Docker. Pour en savoir plus sur les conséquences sur la sécurité, consultez la page Sécurité du daemon Docker.

4. Déconnectez-vous et reconnectez-vous pour que les modifications apportées à la liste des membres du groupe soient appliquées. Si vous utilisez une machine virtuelle, vous devrez peut-être la redémarrer pour que ces modifications prennent effet.

5. Pour vérifier que Docker est en cours d'exécution, utilisez la commande Docker suivante, qui renvoie la date et l'heure actuelles :

   docker run --rm busybox date
   

   L'option --rm supprime l'instance de conteneur en cas de fermeture.

Configurer l'authentification Docker Hub

Pour éviter d'utiliser un quota Docker Hub non authentifié, nous vous recommandons de vous authentifier auprès de Docker Hub lorsque vous utilisez des dépôts distants. Dépôts distants vous permettent d'ajouter votre nom d'utilisateur Docker Hub et un jeton d'accès personnel enregistré un secret pour s'authentifier auprès de Docker Hub.

Créer un jeton d'accès personnel Docker Hub

1. Connectez-vous à Docker Hub.
2. Créez un jeton d'accès personnel avec des autorisations en lecture seule.

3. Copiez le jeton d'accès.

   Avertissement :Le jeton d'accès ne s'affiche qu'une seule fois. Si vous fermez la fenêtre il ne peut pas être récupéré et vous devez créer un autre jeton d'accès.

4. Enregistrez le jeton d'accès dans un fichier texte dans votre environnement local ou dans Cloud Shell.

   Avertissement : Traitez les jetons d'accès comme des mots de passe et protégez-les.

Enregistrez votre jeton d'accès personnel dans un secret

Console

1. Accédez à la page Secret Manager dans la console Google Cloud.

   Accéder à la page Secret Manager

2. Sur la page Secret Manager, cliquez sur Créer un secret.

3. Sur la page Créer un secret, sous Nom, nommez votre secret my-secret.

4. Dans le champ Valeur du secret, saisissez votre jeton d'accès personnel Docker Hub.

5. Ne modifiez pas la section Régions.

6. Cliquez sur le bouton Créer un secret.

CLI gcloud

gcloud secrets create my-secret --data-file="/path/to/file.txt"

Où /path/to/file.txt correspond à l'emplacement du fichier texte contenant votre jeton d'accès personnel.

Accordez au compte de service Artifact Registry l'accès à votre secret

Console

1. Accédez à la page Secret Manager dans la console Google Cloud.

   Accéder à la page Secret Manager

2. Sur la page Secret Manager, cochez la case située à côté de my-secret.

3. S'il n'est pas déjà ouvert, cliquez sur Afficher le panneau d'informations pour ouvrir celui-ci.

4. Dans le panneau d'informations, cliquez sur Ajouter un compte principal.

5. Dans la zone de texte Nouveaux comptes principaux, saisissez l'adresse e-mail du compte de service Artifact Registry. L'adresse e-mail du compte de service Artifact Registry se présente comme suit :

   [e-mail]

   Où PROJECT-NUMBER est le numéro de votre projet.

   Pour trouver votre numéro de projet :

   • Accédez à la page Tableau de bord. dans la console Google Cloud.

     Accéder à la page "Tableau de bord"

   • Cliquez sur la liste déroulante de sélection du projet située en haut de la page.

   • Sélectionnez votre projet dans la fenêtre Sélectionner qui s'affiche.

     L'ID et le numéro du projet sont affichés sur la fiche Informations sur le projet du tableau de bord du projet.

6. Dans la liste déroulante Sélectionner un rôle, sélectionnez Gestionnaire de secrets, puis Accesseur de secrets Secret Manager.

CLI gcloud

gcloud secrets add-iam-policy-binding my-secret \
    --member="serviceAccount:[e-mail]" \
    --role="roles/secretmanager.secretAccessor"

où PROJECT-NUMBER est le numéro de votre projet.

Pour trouver votre numéro de projet:

• Accédez à la page Tableau de bord. dans la console Google Cloud.

  Accéder à la page "Tableau de bord"

• Cliquez sur la liste déroulante de sélection du projet située en haut de la page.

• Sélectionnez votre projet dans la fenêtre Sélectionner qui s'affiche.

  L'ID et le numéro du projet sont tous deux affichés sur la fiche Informations sur le projet du tableau de bord du projet.

Créer un dépôt distant

Créez un dépôt distant Artifact Registry nommé quickstart-docker-hub-remote à l'emplacement us-central1 avec votre Docker Hub en exécutant la commande suivante:

gcloud artifacts repositories create quickstart-docker-hub-remote \
    --project=PROJECT_ID \
    --repository-format=DOCKER  \
    --location=us-central1 \
    --description="Remote Docker repository" \
    --mode=remote-repository \
    --remote-repo-config-desc="Docker Hub" \
    --remote-docker-repo=DOCKER-HUB \
    --remote-username=USERNAME \
    --remote-password-secret-version=projects/PROJECT/secrets/my-secret/versions/1

Où :

• quickstart-docker-hub-remote est le nom du dépôt. Pour chaque emplacement de dépôt d'un projet, les noms de dépôt doivent être uniques.
• PROJECT_ID est l'ID de votre projet. Si cette option est ignorée, le projet en cours ou par défaut est utilisé.
• us-central1 est l'emplacement régional ou multirégional du dépôt. Vous pouvez ignorer cette option si vous définissez une valeur par défaut. Afficher une liste des emplacements compatibles, exécutez la commande gcloud artifacts locations list.
• "Remote Docker repository" est la description facultative de votre dépôt. N'incluez pas de données sensibles, car les descriptions de dépôts ne sont pas chiffrées.
• "Docker Hub" est la description facultative de la configuration du dépôt externe pour ce dépôt distant.
• DOCKER-HUB définit le dépôt distant en amont sur l'amont public de Docker Hub.
• USERNAME est votre nom d'utilisateur Docker Hub.
• projects/PROJECT/secrets/my-secret/versions/1 est la version du secret que vous avez créée pour stocker votre accès personnel à Docker Hub ; à partir d'un jeton d'accès.

Artifact Registry crée le dépôt et l'ajoute à la liste des dépôts.

Configurer l'authentification Docker

Avant de pouvoir transférer ou extraire des images, vous devez configurer Docker afin qu'il utilise le Google Cloud CLI pour authentifier les requêtes envoyées à Artifact Registry.

1. Connectez-vous à la gcloud CLI en tant qu'utilisateur qui exécutera les commandes Docker.

   gcloud auth login
   

2. Pour configurer l'authentification auprès des dépôts Docker dans la région us-central1, exécutez la commande suivante :

   gcloud auth configure-docker us-central1-docker.pkg.dev
   

   La commande met à jour votre configuration Docker. Vous pouvez désormais vous connecter à Artifact Registry dans votre projet Google Cloud pour stocker et extraire des images.

Pour en savoir plus sur les autres méthodes d'authentification, consultez la section Méthodes d'authentification.

Extraire une image dans votre dépôt distant

1. Connectez-vous à la gcloud CLI en tant qu'utilisateur qui exécutera les commandes Docker.

   gcloud auth login
   

2. Extrayez une image de Docker Hub sur votre machine et dans votre dépôt distant à l'aide de la commande suivante :

   docker pull us-central1-docker.pkg.dev/PROJECT/quickstart-docker-hub-remote/busybox:latest
   

   Où :

   • us-central1 correspond à l'emplacement du dépôt distant.
   • us-central1-docker.pkg.dev est le nom d'hôte du dépôt Docker que vous avez créé.
   • PROJECT est votre ID de projet Google Cloud. Si l'ID du projet contient le signe deux-points (:), consultez la section Projets à l'échelle du domaine.
   • quickstart-docker-hub-remote est l'ID du dépôt que vous avez créé.
   • busybox est le nom de l'image dans laquelle vous souhaitez extraire Docker Hub ; quickstart-docker-hub-remote
   • latest est la version de l'image avec tag que vous souhaitez extraire de Docker Hub.

   L'image est extraite sur votre machine et mise en cache dans le dépôt distant. Si vous extrayez à nouveau la même image taguée, elle sera extraite de votre dépôt distant. Vos identifiants Docker Hub sont utilisés.

3. Répertoriez les artefacts stockés dans votre dépôt distant:

   gcloud artifacts packages list \
       --location=us-central1 \
       --repository=quickstart-docker-hub-remote
   

   Le résultat se présente comme suit :

   Listing items under project my-project, location us-central1, repository quickstart-docker-hub-remote.
   
   PACKAGE: busybox
   CREATE_TIME: 2023-06-19T18:59:09
   UPDATE_TIME: 2023-06-19T18:59:10
   

Effectuer un nettoyage

Pour éviter que les ressources utilisées sur cette page soient facturées sur votre compte Google Cloud, procédez comme suit :

Supprimer votre dépôt

Si vous souhaitez conserver votre projet et ne supprimer que la ressource de dépôt, suivez les étapes de cette section. Si vous souhaitez supprimer l'intégralité de votre projet, suivez en suivant la procédure décrite dans la section Supprimer votre projet.

Avant de supprimer le dépôt, assurez-vous que toutes les images que vous souhaitez conserver sont disponibles à un autre emplacement.

Pour supprimer le dépôt :

Console

1. Ouvrez la page Dépôts de la console Google Cloud.

   Ouvrir la page "Dépôts"

2. Dans la liste des dépôts, sélectionnez le dépôts quickstart-docker-hub-remote.

3. Cliquez sur Supprimer.

gcloud

Pour supprimer le dépôt quickstart-docker-hub-remote, exécutez la commande suivante :

gcloud artifacts repositories delete quickstart-docker-hub-remote \
    --location=us-central1

Supprimer votre projet

Attention : La suppression d'un projet entraîne les effets décrits ci-dessous :

• Tout le contenu du projet est supprimé. Si vous avez utilisé un projet existant pour les tâches décrites dans ce document et que vous le supprimez, vous supprimerez également tout autre travail effectué dans le projet.
• Les ID de projets personnalisés sont perdus. Lorsque vous avez créé ce projet, vous avez peut-être créé un ID de projet personnalisé que vous souhaitez utiliser à l'avenir. Pour conserver les URL qui utilisent l'ID de projet, telle qu'une URL appspot.com, supprimez les ressources sélectionnées dans le projet au lieu de supprimer l'ensemble du projet.

Si vous envisagez d'explorer plusieurs architectures, tutoriels et guides de démarrage rapide, réutiliser des projets peut vous aider à ne pas dépasser les limites de quotas des projets.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Étape suivante

• Découvrez les différents modes de dépôt d'Artifact Registry.
• En savoir plus sur les dépôts distants d'Artifact Registry
• En savoir plus sur la CI/CD