Se connecter à Docker et Helm

Ce document explique comment se connecter à Docker ou Helm à l'aide de secrets de la CLI.

Les instances de registre Harbor dans l'appareil Google Distributed Cloud (GDC) air gap utilisent Identity-Aware Proxy (IAP) pour l'authentification. Après vous être connecté à l'interface Web Harbor à l'aide d'IAP pour la première fois, vous pouvez récupérer un secret de CLI statique à partir de votre profil utilisateur Harbor et l'utiliser comme mot de passe lorsque vous vous connectez à partir de la CLI Docker ou Helm. Cette méthode n'est disponible qu'avec l'interface utilisateur Harbor.

Avant de commencer

Rôles IAM requis

Pour configurer l'authentification pour les instances de registre Harbor, contactez l'administrateur IAM de votre projet pour demander le rôle Lecteur d'instances Harbor (harbor-instance-viewer), qui vous permet d'obtenir, de lister et de surveiller les instances Harbor dans l'espace de noms du projet. Ce rôle inclut les autorisations requises pour afficher les détails des instances Harbor existantes afin de pouvoir récupérer les URL de registre pour l'authentification.

Se connecter avec des secrets de la CLI

Pour vous connecter à Docker ou Helm avec des secrets de la CLI, procédez comme suit :

1. Connectez-vous à Harbor avec un compte utilisateur IAP.
2. Cliquez sur votre nom d'utilisateur, puis sélectionnez Profil utilisateur.
3. Pour copier le secret de la CLI associé à votre compte, cliquez sur Copier.

4. Facultatif : Pour afficher les boutons permettant de générer automatiquement ou de créer manuellement un secret de CLI, cliquez sur Plus dans votre profil utilisateur.

   Remarque : Vous ne pouvez avoir qu'un seul secret de CLI. Lorsqu'un secret est généré ou créé, l'ancien secret devient non valide.

5. Si vous avez généré un nouveau secret de CLI, cliquez sur Copier pour le copier.

6. Utilisez votre secret de CLI comme mot de passe lorsque vous vous connectez à Harbor à partir de la CLI Docker ou Helm :

   docker login -u USERNAME -p CLI_SECRET HARBOR_INSTANCE_URL
   

   Remplacez les éléments suivants :

   • USERNAME : nom d'utilisateur du compte Harbor.
   • CLI_SECRET : secret de la CLI généré.
   • HARBOR_INSTANCE_URL : URL de l'instance Harbor.
   Remarque : Le secret de la CLI n'expire pas, sauf si vous effectuez une rotation manuelle. Le secret de la CLI n'est pas associé à votre jeton d'identité utilisateur. La déconnexion de Harbor ou de la console GDC ne révoque pas le secret de la CLI.