Configurer Docker pour qu'il fasse confiance à l'autorité de certification racine Harbor

Les instances Harbor utilisent des certificats TLS (Transport Layer Security) émis par l'autorité de certification racine de confiance de votre organisation. Cela chiffre la connexion entre votre client Docker et le registre Harbor pour protéger les images contre tout accès non autorisé.

Cette page explique comment configurer le client Docker sur votre poste de travail pour qu'il approuve l'autorité de certification racine Harbor. Vous n'avez pas besoin de configurer la confiance sur les nœuds de vos clusters Kubernetes, car GDC configure automatiquement les nœuds de cluster pour qu'ils fassent confiance à vos instances de registre Harbor. Pour en savoir plus, consultez Confiance des nœuds de cluster pour les instances de registre Harbor.

Avant de commencer

Vous devez effectuer ces étapes avant de gérer vos images de conteneurs :

  1. Installez Docker s'il n'est pas déjà installé en suivant les instructions sur https://docs.docker.com/engine/install/ubuntu/. Docker est inclus dans Cloud Shell.
  2. Docker nécessite un accès privilégié pour interagir avec les registres. Sous Linux ou Windows, ajoutez l'utilisateur que vous utilisez pour exécuter les commandes Docker au groupe de sécurité Docker. Cette étape n'est pas requise sur macOS, car Docker Desktop s'exécute sur une machine virtuelle en tant qu'utilisateur racine.

    1. Pour Linux, ajoutez l'utilisateur :

        sudo usermod -a -G docker USER
      
    2. Pour Windows :

        net localgroup docker-users DOMAIN\Upan>SER /add
      

      Remplacez USER par le nom d'utilisateur que vous souhaitez ajouter.

Configurer Docker pour qu'il approuve l'autorité de certification racine Harbor

Vous devez configurer votre client Docker local pour qu'il fasse confiance à l'autorité de certification racine de votre organisation lorsque vous utilisez le client Docker pour communiquer avec l'instance Harbor.

Pour configurer le client Docker afin qu'il fasse confiance à l'autorité de certification racine, demandez le fichier .crt de l'autorité de certification racine à l'administrateur de votre organisation, puis copiez l'autorité de certification racine de l'organisation dans :

/etc/docker/certs.d/HARBOR_INSTANCE_URL/ca.crt

Remplacez HARBOR_INSTANCE_URL par l'URL de votre instance Harbor. Exemple : harbor-1.org-1.zone1.google.gdc.test.

Cette commande permet à votre client Docker d'établir une connexion HTTPS avec l'instance Harbor.

Vous pouvez également utiliser la CLI gdcloud pour vous connecter à l'organisation, générer et utiliser le fichier kubeconfig pour le serveur d'API de gestion, et copier le bundle de confiance dans le cluster. Pour en savoir plus, consultez Récupérer des bundles de confiance GDC.

  export REGISTRY=HARBOR_INSTANCE_URL
  mkdir -p /etc/docker/certs.d/${REGISTRY} && echo $(kubectl get secret trust-store-global-root-ext -n platform -o \
  jsonpath='{.data.ca\.crt}') | openssl base64 -A -d > \
  /etc/docker/certs.d/${REGISTRY}/ca.crt

Remplacez HARBOR_INSTANCE_URL par l'URL de votre instance Harbor. Exemple : harbor-1.org-1.zone1.google.gdc.test.

Si la configuration échoue, le message d'erreur suivant s'affiche :

Error response from daemon: Get "https://<HARBOR_INSTANCE_URL>": x509: certificate signed by unknown authority

Répétez les étapes pour résoudre ce problème et faites remonter le problème à l'ingénierie GDC si nécessaire.

Si les pods d'un cluster Kubernetes affichent une erreur x509: certificate signed by unknown authority lorsqu'ils extraient des images d'une instance de registre Harbor, consultez Résoudre les erreurs de certificat lors de l'extraction d'images.

Étapes suivantes

Après avoir configuré votre client Docker pour qu'il fasse confiance à l'autorité de certification racine Harbor, terminez la configuration de votre connexion pour commencer à utiliser le registre :