Registres - Utiliser et gérer vos registres

Objectif

Ce guide a pour but de vous aider à utiliser et gérer vos registres publics et privés via l'interface de ligne de commande ovhai (CLI AI), l'API et la console OVHcloud. Cela vous sera utile lorsque vous travaillez avec les OVHcloud AI Tools, en particulier avec AI Training et AI Deploy.

Prérequis

• Un projet Public Cloud

Accès à la console OVHcloud

• Lien direct : Projets
• Pour accéder à vos services : Public Cloud > Sélectionnez votre projet

En pratique

Cette documentation est divisée en plusieurs parties :

• Gérer les registres existants via
  • la console OVHcloud (interface)
  • la CLI OVHcloud AI ovhai
• Créer, configurer et utiliser de nouveaux registres
  • Registre privé Harbor
  • Registre privé Docker
  • Registre GitHub (packages)

Gérer les registres existants

Le Public Cloud fournit un registre par défaut appelé registre partagé (shared registry), où les utilisateurs d'un même projet Public Cloud peuvent pousser leurs images personnalisées et les utiliser via nos AI Tools.

C'est pourquoi il peut être intéressant d'ajouter et de gérer d'autres registres. Vous pouvez le faire soit via la console OVHcloud (interface), soit via la CLI ovhai.

Gérer les registres existants via l'interface

Dans le menu de gauche de votre projet Public Cloud, cliquez sur AI Notebooks, AI Training ou AI Deploy sous AI, puis sur Configuration, et ouvrez l'onglet Registres Docker.

La partie haute de l'onglet liste vos registres privés : vous pouvez en ajouter avec Ajouter un registre et les supprimer depuis la liste.

La partie basse de l'onglet est consacrée au registre partagé : sélectionnez une région pour afficher son URL du registry et les commandes pour vous connecter, taguer et pousser une image.

Gérer les registres existants via la CLI

Si vous préférez, vous pouvez également utiliser la CLI ovhai d'OVHcloud :

Listez tous vos registres disponibles avec :

ovhai registry list

Ajoutez un registre en utilisant :

ovhai registry add <registry-url>

Mettez à jour l'un de vos registres avec la commande suivante :

ovhai registry update <id>

Supprimez un registre en utilisant :

ovhai registry delete <id>

Si vous n'avez pas encore notre CLI ovhai, découvrez comment l'installer ici.

Créer, configurer et utiliser de nouveaux registres

Utiliser vos propres registres privés est la meilleure façon d'utiliser vos images sans les exposer à tout le monde. Nous distinguons 3 possibilités principales :

• Registre privé Harbor
• Registre privé Docker
• Registre GitHub / packages

Nous allons voir comment mettre en œuvre chacun de ces registres et les utiliser via les AI Tools.

Registre privé Harbor

Le service OVHcloud Managed Private Registry vous permet de créer votre propre registre Docker authentifié, où vous pouvez stocker vos images Docker en privé. Ce registre est une instance de Harbor, un projet open source de registre cloud natif de confiance qui stocke, signe et scanne les images Docker.

Création

Pour créer votre nouveau registre privé, nous vous conseillons de lire et de suivre les étapes mentionnées dans la documentation sur la création d'un registre privé.

À la fin de cette étape, vous devriez disposer des informations d'identification de votre registre.

Configuration

Vous devrez ensuite utiliser ces identifiants pour vous connecter à l'interface Harbor. Cela vous permettra de gérer ce registre privé. Cette simple étape est expliquée dans la documentation sur la connexion à l'interface.

Pour terminer la configuration de votre registre Harbor privé, vous devrez créer un projet sur Harbor et lui associer un utilisateur (l'utilisateur Administrateur est ajouté par défaut, mais vous pouvez en créer un nouveau pour ce projet). Vous trouverez toutes les informations nécessaires dans cette documentation.

Récupérer l'URL de l'API de votre OVHcloud Managed Private Registry

Afin d'ajouter ce registre aux AI Tools, vous devrez récupérer son URL. Pour cela, cliquez sur Managed Private Registry sous Conteneurs dans le menu de gauche de votre projet Public Cloud, puis sur le nom de votre registre.

Dans la carte Informations de connexion, copiez l'URL de l’API Harbor, qui est l'URL de votre registre privé.

Ajouter le registre Harbor

Pour ajouter votre registre, vous pouvez soit utiliser la console OVHcloud (interface), soit la CLI ovhai.

Au cours de cette étape, il vous sera demandé les identifiants de votre utilisateur (ID utilisateur et mot de passe). Vous pouvez utiliser les identifiants de l'utilisateur par défaut (administrateur), obtenus lors de la première partie de l'étape « Créer et configurer un nouveau registre privé », ou ceux d'un autre utilisateur si vous en avez créé un.

ovhai registry add <registry-url>

Une fois votre registre ajouté, vous devriez le voir apparaître dans votre liste de registres. Vous pouvez ensuite utiliser toute image poussée sur ce registre pour vos jobs AI Training et vos apps AI Deploy.

Pousser une image vers votre registre

Connectez-vous à votre registre privé, en utilisant un utilisateur disposant des droits d'écriture sur votre projet de registre, avec la commande suivante :

docker login -u <user> -p <password> <private-registry-address>

Une fois connecté, il ne vous reste plus qu'à construire, taguer et pousser votre image. Voici un exemple :

Construisez l'image depuis le Dockerfile du répertoire courant :

docker build . -t <image-name>:<tag-name>

Taguez l'image compilée :

docker tag <image-name>:<tag-name> <private-registry-address>/<harbor_project_name>/<image-name>:<tag-name>

Poussez l'image vers le projet de votre registre privé :

docker push <private-registry-address>/<harbor_project_name>/<image-name>:<tag-name>

Utiliser les images de votre registre privé avec les OVHcloud AI Tools

Maintenant que votre registre privé a été créé et ajouté à votre compte Public Cloud, vous pouvez utiliser ses images dans AI Training et AI Deploy.

Voici un exemple basique avec AI Training, en utilisant la CLI :

ovhai job run <private-registry-address>/<harbor_project_name>/<image-name>:<tag-name>

Si vous préférez utiliser la console OVHcloud, cela est également possible. Dans ce cas, vous devrez indiquer votre image Docker personnalisée dans la section Image Docker de la page de création de votre job/app (pour un job, sélectionnez Image personnalisée). Ce chemin sera <private-registry-address>/<harbor_project_name>/<image-name>:<tag-name>.

Registre privé Docker

Si vous préférez utiliser un registre privé de votre compte Docker, c'est également possible.

Supposons que nous ayons créé un dépôt privé sur notre compte Docker.

Nous construisons, taguons et poussons notre image Docker dans ce dépôt privé :

docker build . -t <image-name>:<tag-name>
docker tag <image-name>:<tag-name> <docker_hub_username>/<private_repository_name>:<tag-name>
docker push <docker_hub_username>/<private_repository_name>:<tag-name>

Ajouter le registre Docker privé

Une fois votre image poussée sur votre compte Docker, vous devrez ajouter votre registre Docker privé aux registres de votre projet Public Cloud.

Comme pour Harbor, cela peut se faire via l'interface ou la CLI. Cette fois, l'URL de votre registre privé sera index.docker.io, et le nom d'utilisateur et le mot de passe demandés correspondent à ceux de votre compte Docker.

Au cours de cette étape, il vous sera demandé vos identifiants Docker.

Depuis l'interface

Dans le menu de gauche de votre projet Public Cloud, cliquez sur AI Notebooks, AI Training ou AI Deploy sous AI, puis sur Configuration, et ouvrez l'onglet Registres Docker.

Cliquez sur Ajouter un registre, puis sélectionnez la Région et renseignez les champs URL, Nom d’utilisateur et Mot de passe. Ici, vous devrez fournir vos identifiants Docker ainsi que l'URL du registre.

Une fois le formulaire rempli, cliquez sur Ajouter.

Depuis la CLI

Pour ajouter votre registre Docker privé via la CLI, utilisez :

ovhai registry add index.docker.io

Une fois votre registre ajouté, vous devriez le voir apparaître dans votre liste de registres.

Utiliser les images de votre registre privé avec les OVHcloud AI Tools

Vous pouvez désormais utiliser les images contenues dans ce registre Docker privé dans les AI Tools en spécifiant index.docker.io. Voici un exemple pour déployer une application Streamlit sur AI Deploy :

ovhai app run index.docker.io/<docker_hub_username>/<private_repository_name>:<tag-name> \
--default-http-port 8501

Vous pouvez également utiliser la console OVHcloud pour déployer un job ou une app depuis votre registre Docker privé. Vous devrez simplement spécifier le chemin de votre image Docker dans la section Image Docker de la page de création de votre job/app. Ce chemin sera index.docker.io/<docker_hub_username>/<private_repository_name>:<tag-name>.

Registre GitHub

Vous pouvez également utiliser un registre GitHub, aussi connu sous le nom de GitHub Packages.

Comme indiqué dans leur documentation, vous pouvez construire et pousser une image de package en utilisant les commandes suivantes :

docker login ghcr.io --username <your_username> --password <your_token>
docker tag app ghcr.io/<your_username>/<repo-name>:<tag-name>
docker push ghcr.io/<your_username>/<repo-name>:<tag-name>

Ajouter un registre GitHub

Une fois votre image poussée sur votre compte GitHub, vous devrez ajouter votre registre GitHub aux registres de votre projet Public Cloud. Comme pour Harbor et Docker, cela peut se faire via l'interface ou la CLI. Cette fois, l'URL de votre registre sera ghcr.io.

Vos identifiants GitHub vous seront demandés.

ovhai registry add ghcr.io

Utiliser les images de votre registre GitHub avec les OVHcloud AI Tools

Vous pouvez désormais utiliser les packages/images contenus dans ce registre GitHub dans les AI Tools en spécifiant ghcr.io. Voici un exemple pour déployer une application Streamlit sur AI Deploy :

ovhai app run ghcr.io/<your_username>/<repo-name>:<tag-name> \
--default-http-port 8501

Vous pouvez également utiliser la console OVHcloud pour déployer un job ou une app depuis un registre GitHub. Vous devrez simplement spécifier le chemin de votre image GitHub dans la section Image Docker de la page de création de votre job/app. Ce chemin sera ghcr.io/<your_username>/<repo-name>:<tag-name>.

Aller plus loin

• Vous pouvez consulter la documentation officielle sur comment soumettre un job.
• Découvrez comment déployer une app.
• Vous pouvez consulter la documentation sur la CLI ovhai.

Pour une formation ou une assistance technique sur la mise en œuvre de nos solutions, contactez votre commercial ou consultez la page Professional Services pour obtenir un devis et faire analyser votre projet par nos experts.

Votre avis nous intéresse !

N’hésitez pas à nous faire part de vos questions, retours et suggestions pour améliorer le service :

• Sur le serveur Discord OVHcloud