Vous pouvez installer le registre de conteneur Harbor en tant que service Superviseur et exécuter Harbor en tant que registre privé.

Conditions requises

Respectez les conditions préalables suivantes :
Note : Ces instructions sont validées avec la mise en réseau vSphere 8 et NSX 4.

Télécharger les fichiers YAML requis

Téléchargez les fichiers YAML requis, y compris Contour et Harbor.
  1. Téléchargez les fichiers Contour suivants à partir du site Service de contrôleur d'entrée Kubernetes :
    1. Fichier de définition du service Contour : contour.yml
    2. Fichier de configuration du service Contour : contour-data-values.yml
  2. Téléchargez les fichiers Harbor suivants sur le site Service de registre de cloud natif :
    1. Fichier de définition du service Harbor : harbor.yml
    2. Fichier de configuration du service Harbor : harbor-data-values.yml

Installer Contour

Vous devez d'abord installer Contour avant d'installer Harbor.
  1. Téléchargez le fichier contour.yml dans vCenter en accédant à Gestion de la charge de travail > > Services > Ajouter.
  2. Vérifiez que la définition du service Contour est ajoutée.
  3. Sélectionnez Gestion de la charge de travail > Superviseurs > Superviseur > Configurer.
  4. Sélectionnez Services de superviseur > Présentation.
  5. Sélectionnez l'onglet Disponible.
  6. Sélectionnez Contour et cliquez sur Installer.
  7. Copiez/collez le contenu du fichier contour-data-values.yml dans le champ d'entrée « Configuration du service YAML ».
    Note : Les valeurs de données Contour peuvent être utilisées telles quelles et ne nécessitent aucune modification de configuration. Le type de service pour Envoy est défini sur LoadBalancer.
  8. Cliquez sur OK pour procéder à l'installation de Contour.
  9. Vérifiez que Contour est installé.
    1. Sélectionnez l'Espace de noms vSphere nommé svc-contour-domain-XXXX.
    2. Sélectionnez l'onglet Réseau, puis Services.
    3. Vous devez voir le service Contour de type ClusterIP et le service Envoy de type LoadBalancer. Le service Envoy doit disposer d'une adresse IP externe.

Mettre à jour les valeurs de données Harbor

Avant d'installer Harbor, mettez à jour le fichier de valeurs de données.
  1. À l'aide d'un éditeur de texte, ouvrez le fichier harbor-data-values.yml.
  2. Apportez les modifications suivantes (au minimum, la modification des autres champs est facultative).
  3. Enregistrez les modifications.
    Nom Valeur
    hostname harbordomain.com (choisissez quelque chose d'unique)
    tlsCertificate.tlsSecretLabels {"managed-by": "vmware-vRegistry"} (vérifiez cette valeur, mais conservez-la telle quelle)
    persistence.persistentVolumeClaim.registry.storageClass « vwt-storage-policy » (entrez le nom de la stratégie de stockage vSphere pour le superviseur)
    persistence.persistentVolumeClaim.jobservice.storageClass « vwt-storage-policy » (entrez le nom de la stratégie de stockage vSphere pour le superviseur)
    persistence.persistentVolumeClaim.database.storageClass « vwt-storage-policy » (entrez le nom de la stratégie de stockage vSphere pour le superviseur)
    persistence.persistentVolumeClaim.redis.storageClass « vwt-storage-policy » (entrez le nom de la stratégie de stockage vSphere pour le superviseur)
    persistence.persistentVolumeClaim.trivy.storageClass « vwt-storage-policy » (entrez le nom de la stratégie de stockage vSphere pour le superviseur)

Installer Harbor

Installez Harbor en suivant les instructions suivantes.
  1. Téléchargez le fichier harbor.yml dans vCenter en accédant à Gestion de la charge de travail > > Services > Ajouter.
  2. Vérifiez que la définition du service Harbor est ajoutée.
  3. Sélectionnez Gestion de la charge de travail > Superviseurs > Superviseur > Configurer.
  4. Sélectionnez Services de superviseur > Présentation.
  5. Sélectionnez l'onglet Disponible.
  6. Sélectionnez Harbor et cliquez sur Installer.
  7. Copiez/collez le contenu du fichier harbor-data-values.yml que vous avez modifié dans le champ d'entrée « Configuration du service YAML ».
  8. Cliquez sur OK pour procéder à l'installation de Harbor.
  9. Vérifiez que Harbor est installé.
    1. Sélectionnez l'Espace de noms vSphere nommé svc-harbor-domain-XXXX.
    2. Sélectionnez l'onglet Réseau, puis Services.
    3. Vous devez voir plusieurs conteneurs installés pour Harbor, chacun étant un service de type ClusterIP.

Configurer DNS pour Harbor

Vous devrez enregistrer un nom de domaine et configurer un enregistrement DNS pour Harbor.
  1. Sélectionnez Gestion de la charge de travail > Espaces de noms.
  2. Sélectionnez l'espace de noms Contour.
  3. Sélectionnez Réseau > Services.
  4. Enregistrez l'adresse IP externe du service d'entrée Envoy, par exemple 10.197.154.71.
  5. Enregistrez le nom de domaine Harbor (FQDN) que vous avez spécifié dans la configuration Harbor.
  6. Créez un enregistrement « A » DNS à l'aide d'AWS Route 53 ou d'un service similaire.

Se connecter à Harbor

Une fois le DNS Harbor configuré, connectez-vous.
  1. Accédez au nom de domaine que vous avez enregistré pour Harbor.
  2. Connectez-vous au domaine en utilisant les valeurs admin | mot de passe que vous avez spécifiées dans la configuration Harbor.
  3. Une fois connecté, modifiez le mot de passe en un élément plus sécurisé.

Configurer le superviseur pour approuver le registre Harbor (facultatif)

Les clusters TKG sont automatiquement configurés pour approuver le service de Superviseur Harbor lorsque le cluster TKG et Harbor sont déployés sur le même Superviseur. Toutefois, le Superviseur n'est PAS automatiquement configuré pour approuver le service de Superviseur Harbor lors de la création de Espaces vSphere. Effectuez ces étapes pour établir une relation de confiance entre le Superviseur et le service Harbor en mettant à jour le configmap avec le certificat d'autorité de certification Harbor.
  1. Dans Harbor, accédez à Administration > Configuration > Paramètres système.
  2. Téléchargez le certificat racine du registre, qui est un fichier nommé ca.crt.
  3. Configurez la variable d'environnement KUBE_EDITOR.

    Reportez-vous à la section Configurer un éditeur de texte pour Kubectl.

  4. Connectez-vous à Superviseur à l'aide de kubectl.

    Reportez-vous à la section Se connecter au Superviseur en tant qu'utilisateur vCenter Single Sign-On avec Kubectl.

  5. Changez de contexte pour le contexte Superviseur (adresse IP).
  6. Modifiez configmap/image-fetch-ca-bundle à l'aide de la commande suivante : 
    kubectl edit configmap image-fetcher-ca-bundle -n kube-system
  7. Copiez le contenu du fichier Harbor ca.crt et ajoutez-lui le configmap sous le certificat existant (qui est destiné au Superviseur et ne doit pas être modifié). Enregistrez les modifications apportées au fichier. Vous devez voir que Kubectl indique « configmap/image-fetcher-ca-bundle edit ».