For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/fr/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/fr/llms-full.txt, and this page is available as Markdown at https://docs.ovhcloud.com/fr/guides/public-cloud/ai-machine-learning/ai-cli-overview.md.

CLI - Commandes principales

Voir en Markdown

Découvrez les principales commandes de la CLI pour interagir sur les AI Tools

Objectif

Ce guide couvre l'utilisation de la CLI ovhai.

Prérequis

En pratique

Lancer un job

Pour soumettre un job, vous avez besoin d'une image docker et éventuellement de données.

Commençons par soumettre un job simple, une image ubuntu publique qui exécute une commande echo :

ovhai job run ubuntu --gpu 1 -- echo "Hello from my first job"
Info
  • Ajoutez le flag --help pour obtenir plus d'informations sur une commande.
  • Vous pouvez augmenter le nombre de GPUs avec le flag --gpu <x> ou choisir d'utiliser des CPUs avec le flag --cpu <x>.

Vous pouvez ensuite lister vos jobs actuels et anciens avec :

ovhai job list
Info
  • Ajoutez le flag --watch pour suivre les changements en direct.
  • La plupart des commandes gèrent le flag --output <format> si vous souhaitez un format de sortie différent (JSON ou YAML)

Vous devriez voir le job que vous venez d'exécuter, vous avez besoin de son ID pour obtenir plus d'informations à son sujet.

Pour voir les informations d'un job, utilisez la commande suivante :

ovhai job get <job-id>

Pour voir ses logs en direct, utilisez la commande suivante :

ovhai job logs <job-id> --follow

Vous devriez voir la sortie de la commande echo :

Hello from my first job

Utiliser des données dans votre job

Vous pouvez envoyer des données vers l'Object Storage et monter ces données lors de l'exécution d'un job. Si vous montez ces données en lecture/écriture, elles seront sauvegardées sur l'Object Storage à la fin du job.

Envoyons quelques données et utilisons-les dans un job qui produira davantage de données.

ovhai bucket object upload `<container>`@`<region>` some-file.txt
Info
  • Si vous avez déjà utilisé la CLI Swift, les commandes sont similaires.

Maintenant que vous avez des données dans un conteneur, vous pouvez les monter lors de l'exécution d'un job avec le flag --volume.

ovhai job run <image> --volume <container>@<region>:/data:rw
Info
  • Vous pouvez utiliser le flag --volume plusieurs fois si vous souhaitez monter plusieurs conteneurs.
  • Les conteneurs montés avec accès en écriture ne sont synchronisés qu'à la fin du job.

Vous pouvez lister et télécharger les données que vous avez envoyées ou générées par un job avec :

ovhai bucket object list `<container>`@`<region>`
ovhai bucket object download `<container>`@`<region>` --prefix /some-data

Synchroniser des données pendant l'exécution d'un job

Vous pouvez synchroniser des données vers l'Object Storage pendant l'exécution d'un job avec :

ovhai job push-data `<job-id>`

Vous pouvez suivre la progression avec :

ovhai job get `<job-id>`

Exécuter des commandes à l'intérieur d'un job en cours d'exécution

Vous pouvez exécuter des commandes (comme bash) pendant qu'un job est en cours d'exécution.

ovhai job exec -it <id> -- bash

Cela vous permet d'interagir avec un job en cours d'exécution.

Lancer un job avec un accès ssh

Vous pouvez créer un job avec un accès ssh :

ovhai job run -s ~/.ssh/id_ed25519.pub ovhcom/ai-training-fastai

Plusieurs arguments -s peuvent être utilisés pour fournir plusieurs clés publiques SSH.

Une fois que le job est à l'état RUNNING, vous pouvez récupérer la sshUrl avec :

ovhai job get `<job-id>`

---
id: 0d916855-1cd4-4b66-8803-b4782bc13902
createdAt: "2021-02-23T08:45:01.297780Z"
updatedAt: "2021-02-23T08:45:19.823082Z"
user: user-xxx
spec:
  image: ovhcom/ai-training-fastai
  env: []
  defaultHttpPort: 8080
  resources:
    gpu: 1
    gpuModel: Tesla-V100S
    cpu: 7
  volumes: []
  timeout: 0
  name: ai-training-fastai-kind
  sshPublicKeys:
    - ssh-ed25519 AAAAC3NzaC1someKey
status:
  state: RUNNING
  queuedAt: "2021-02-23T08:45:01.297318Z"
  startedAt: "2021-02-23T08:45:13Z"
  stoppedAt: ~
  ip: 10.42.155.122
  infos: ~
  history:
    - state: QUEUED
      date: "2021-02-23T08:45:01.297012Z"
    - state: INITIALIZING
      date: "2021-02-23T08:45:04.356856Z"
    - state: PENDING
      date: "2021-02-23T08:45:10.163754Z"
    - state: RUNNING
      date: "2021-02-23T08:45:19.822354Z"
  duration: 6
  jobUrl: "http://0d916855-1cd4-4b66-8803-b4782bc13902.job.gra.ai.cloud.ovh.net"
  sshUrl: "ssh://0d916855-1cd4-4b66-8803-b4782bc13902@gra.ai.cloud.ovh.net"
  monitoringUrl: "http://monitoring.gra.ai.cloud.ovh.net/d/job/job-monitoring?var-job=0d916855-1cd4-4b66-8803-b4782bc13902&from=1614069913000"

Vous pouvez ensuite vous y connecter avec un terminal :

ssh 0d916855-1cd4-4b66-8803-b4782bc13902@gra.ai.cloud.ovh.net -i ~/.ssh/id_ed25519

Gérer les registres

Vous pouvez lister les registres disponibles avec :

ovhai registry list

Par défaut, vous avez accès à des registres publics, ainsi qu'à un registre partagé rattaché à votre projet.

Warning

Ce registre partagé peut vous aider à réaliser vos tests, mais ne doit pas être utilisé en production, car nous nous réservons le droit de supprimer son contenu si cela s'avère nécessaire. Les images envoyées vers ce registre sont destinées uniquement aux charges de travail AI Tools, et ne seront pas accessibles pour des usages externes.

C'est pourquoi il peut être intéressant d'ajouter et de gérer d'autres registres. Pour ajouter un registre privé, utilisez :

ovhai registry add `<url>`

Il vous sera demandé de saisir vos identifiants.

Vous trouverez plus d'informations sur l'ajout et la gestion des registres publics et privés ici.

Changer de région dans la CLI

Les régions disponibles pour installer et utiliser la CLI ovhai sont GRA et BHS. Si vous souhaitez changer de région dans la CLI, vous pouvez utiliser les commandes suivantes.

Vous pouvez lister les noms et URLs des régions disponibles avec :

ovhai config list
Info

La région en vert est celle dans laquelle vous vous trouvez actuellement.

Pour changer de région, utilisez :

ovhai config set <region>
Info

<region> est le nom de la nouvelle région (GRA ou BHS), dans laquelle vous souhaitez être placé.

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 :

Cette page vous a-t-elle aidé ?