Créer des projets Harbor

Ce document explique aux développeurs et aux administrateurs comment créer et valider des projets Harbor à l'aide de la console GDC ou de la CLI gdcloud.

Vous pouvez stocker, sécuriser et distribuer vos images de conteneurs dans l'appliance isolée Google Distributed Cloud (GDC) en les organisant dans des projets Harbor au sein de l'instance tear-harbor préconfigurée. Dans Harbor, un projet sert d'unité logique pour regrouper les artefacts associés, gérer vos images et appliquer des règles, des contrôles d'accès et des règles de réplication spécifiques.

Le projet système tear fournit tear-harbor comme seule instance Harbor disponible (un seul registre préconfiguré pour l'ensemble de votre appliance). Vous n'avez donc pas besoin de provisionner, de mettre à niveau ni de gérer des instances Harbor distinctes pour chaque projet client. Cette architecture centralisée élimine les frais généraux d'infrastructure et vous permet de gérer les espaces de noms d'images, les contrôles d'accès et l'analyse des failles à partir d'un registre partagé. Pour utiliser ce registre partagé pour les charges de travail dans n'importe quel projet client, vous devez créer vos rôles Harbor dans le projet tear et créer vos projets Harbor directement dans le projet tear.

Avant de commencer

Avant de commencer, assurez-vous de remplir les conditions suivantes :

  • Connaissances recommandées : assurez-vous de bien comprendre les concepts et l'architecture abordés dans la présentation de Managed Harbor Service. Il est essentiel de comprendre que Harbor est une ressource partagée hébergée dans le projet tear, car toutes les tâches d'attribution de rôle et de création de projet Harbor doivent cibler le projet tear.

  • Initialisez votre identité Harbor : vous devez vous connecter à l'interface utilisateur Harbor au moins une fois avant de tenter de créer des projets dans la console. La connexion initiale permet d'initialiser votre identité auprès du registre Harbor. Pour en savoir plus, consultez Obtenir l'URL de l'instance Harbor et Initialiser votre identité Harbor.

Rôle IAM requis

Pour créer un projet Harbor, y compris un projet Harbor que vous prévoyez d'utiliser dans un projet client, vous devez disposer du rôle IAM (Identity and Access Management) Créateur de projet Harbor (harbor-project-creator) créé et attribué dans le projet tear pour accéder à l'instance tear-harbor. Ce rôle fournit des autorisations de création, d'obtention et de surveillance pour les ressources personnalisées du projet Harbor dans l'instance tear-harbor du projet tear, ce qui vous permet de définir de nouveaux espaces de noms d'image et d'établir des limites de sécurité pour vos applications conteneurisées.

Pour demander l'accès au projet tear, contactez votre administrateur de projet IAM.

Obtenir l'URL de l'instance Harbor

Pour vous connecter à l'interface utilisateur Harbor ou utiliser la gcloud CLI pour gérer les images, vous avez besoin de l'URL du point de terminaison externe de l'instance de registre :

  1. À l'aide de la CLI gdcloud, obtenez l'URL de l'instance Harbor :

    gdcloud harbor instances describe tear-harbor --project=tear

    Le résultat ressemble à ce qui suit et contient généralement le champ externalEndpoint :

    externalEndpoint: https://harbor.tear.example.com

  2. Copiez l'URL externalEndpoint pour accéder à l'interface utilisateur de Harbor via votre navigateur et pour établir l'authentification de confiance du client.

Si vous n'avez pas accès à gdcloud CLI, contactez votre opérateur d'infrastructure (IO) pour obtenir de l'aide.

Initialiser votre identité Harbor

Connectez-vous à l'interface utilisateur Harbor au moins une fois pour synchroniser votre identité. Cette première connexion enregistre votre profil utilisateur dans la base de données Harbor afin que le système reconnaisse vos autorisations :

  1. Dans un navigateur, accédez à l'URL du registre.
  2. Connectez-vous à l'aide de vos identifiants GDC.

Créer un projet Harbor

Étant donné que tear-harbor dans le projet tear est la seule instance Harbor disponible et qu'elle sert de registre partagé pour l'ensemble de l'appliance, vous devez créer tous les projets Harbor dans le projet tear, y compris ceux qui stockent des images pour les charges de travail dans d'autres projets client. Créez un projet Harbor à l'aide de la console GDC ou de la CLI gdcloud.

Console

Dans la console GDC, procédez comme suit dans le projet tear :

  1. Sélectionnez le projet tear.
  2. Cliquez sur le lien Harbor Container Registry dans la section CI/CD du menu de navigation.
  3. Cliquez sur Create a Harbor project (Créer un projet Harbor).
  4. Saisissez le nom du projet Harbor.
  5. Facultatif : L'analyse des failles est activée par défaut. Pour désactiver l'analyse automatique des failles pour les projets Harbor, cliquez sur le bouton Activer l'analyse des failles pour le projet. Pour en savoir plus, consultez Rechercher des failles.
  6. Cliquez sur Créer. Un message de confirmation s'affiche pour indiquer que votre projet a été créé.
  7. Connectez-vous à l'interface utilisateur Harbor pour vérifier que vous pouvez afficher le projet Harbor.

gdcloud

Créez le projet Harbor dans le projet tear :

gdcloud harbor harbor-projects create HARBOR_PROJECT \
  --project=tear \
  --instance=tear-harbor

Remplacez HARBOR_PROJECT par le nom du projet Harbor à créer.