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 l'espace client 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 à l'espace client OVHcloud

• Lien direct : Tous mes projets Public Cloud
• 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
  • l'OVHcloud Control Panel (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 l'OVHcloud Control Panel (interface), soit via la CLI ovhai.

Gérer les registres existants via l'interface

Cliquez sur ce lien pour accéder à votre projet Public Cloud, puis rendez-vous dans la section AI Training, située sous AI & Machine Learning.

En cliquant sur le bouton Registres Docker Privés, vous devriez pouvoir voir et gérer (ajouter, supprimer) vos différents registres privés.

Notez que le registre partagé n'apparaîtra pas ici. Celui-ci est affiché dans le panneau Home d'AI Training.

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, rendez-vous dans la section Managed Private Registry de l'OVHcloud Public Cloud Manager, et dans le bouton « plus d'options » (...) à droite, cliquez sur Harbor API :

Copiez ensuite 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 l'OVHcloud Control Panel (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.

Depuis l'espace client (UI)

Depuis la CLI ovhai

Pour ajouter votre registre privé via l'interface, cliquez sur ce lien pour accéder à votre projet Public Cloud, puis rendez-vous dans la section AI Dashboard, située sous AI & Machine Learning.

Par défaut, vous serez redirigé vers le panneau Dashboard. Pour ajouter une URL de registre personnalisée, cliquez sur le bouton Registres Docker. Une fois là, cliquez sur le bouton + Ajouter pour ajouter votre registre Docker privé.

Ici, vous devrez fournir les identifiants de votre registre ainsi que son URL.

Une fois le formulaire rempli, cliquez sur Ajouter.

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

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 l'OVHcloud Control Panel, cela est également possible. Dans ce cas, vous devrez indiquer votre image Docker personnalisée à l'étape 2 de la création de votre job/app. 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

Cliquez sur ce lien pour accéder à votre projet Public Cloud, puis rendez-vous dans la section AI Dashboard, située sous AI & Machine Learning.

Par défaut, vous serez redirigé vers le panneau Dashboard. Pour ajouter une URL de registre personnalisée, cliquez sur le bouton Registres Docker. Une fois là, cliquez sur le bouton + Ajouter pour ajouter votre registre Docker privé.

Ici, vous devrez fournir vos identifiants Docker ainsi que son URL.

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 le Control Panel pour déployer un job ou une app depuis votre registre Docker privé. Vous devrez simplement spécifier le chemin de votre image Docker à l'étape 2 de la 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.

Depuis l'espace client (UI)

Depuis la CLI ovhai

Cliquez sur ce lien pour accéder à votre projet Public Cloud, puis rendez-vous dans la section AI Dashboard, située sous AI & Machine Learning.

Par défaut, vous serez redirigé vers le panneau Dashboard. Pour ajouter une URL de registre personnalisée, cliquez sur le bouton Registres Docker. Une fois là, cliquez sur le bouton + Ajouter pour ajouter votre registre Docker privé.

Ici, vous devrez fournir vos identifiants GitHub ainsi que l'URL du registre.

Une fois le formulaire rempli, cliquez sur Ajouter.

ovhai registry add ghcr.io

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

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 le Control Panel pour déployer un job ou une app depuis un registre GitHub. Vous devrez simplement spécifier le chemin de votre image GitHub à l'étape 2 de la 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