Termes et concepts de Launch

Découvrez les principaux concepts de W&B Launch, notamment les jobs, les files d’attente, les ressources cibles, les agents et les environnements d’agent.

Cette page définit les principaux termes et concepts utilisés dans l’ensemble de la documentation W&B Launch. Utilisez-la comme référence lorsque vous rencontrez des termes inconnus dans les guides de configuration, les tutoriels ou la W&B App.

Avec W&B Launch, vous placez des jobs dans des files d’attente pour créer des runs. Les jobs sont des scripts Python instrumentés avec W&B. Les files d’attente contiennent une liste de jobs à exécuter sur une ressource cible. Les agents récupèrent les jobs depuis les files d’attente et les exécutent sur des ressources cibles. W&B suit les jobs Launch de la même manière que les runs.

Les sections suivantes décrivent chacun de ces concepts plus en détail.

​

job Launch

Un job Launch est un type spécifique d’artefact W&B qui représente une tâche à exécuter. Par exemple, parmi les jobs Launch courants, on trouve l’entraînement d’un modèle ou le déclenchement d’une évaluation de modèle. Les définitions de job incluent :

• Du code Python et d’autres fichiers de ressource, dont au moins un point d’entrée exécutable.
• Des informations sur l’entrée (paramètre de configuration) et la sortie (métriques enregistrées).
• Des informations sur l’environnement (par exemple, requirements.txt, Dockerfile de base).

Les trois principaux types de définitions de job sont les suivants :

Types de job	Définition	Comment exécuter ce type de job
Jobs basés sur des artefacts (ou sur le code)	Le code et les autres ressources sont enregistrés dans un artefact W&B.	Pour exécuter des jobs basés sur des artefacts, vous devez configurer l’agent Launch avec un générateur.
Jobs basés sur Git	Le code et les autres ressources sont clonés à partir d’un commit, d’une branche ou d’un tag spécifique dans un dépôt Git.	Pour exécuter des jobs basés sur Git, vous devez configurer l’agent Launch avec un générateur et des identifiants de dépôt Git.
Jobs basés sur des images	Le code et les autres ressources sont intégrés dans une image Docker.	Pour exécuter des jobs basés sur des images, vous devrez peut-être configurer l’agent Launch avec des identifiants de dépôt d’images.

Bien que les jobs Launch puissent effectuer des activités non liées à l’entraînement de modèles (par exemple, déployer un modèle sur un serveur d’inférence Triton), tous les jobs doivent appeler wandb.init() pour s’exécuter correctement jusqu’au bout. Cela crée un run à des fins de suivi dans un espace de travail W&B.

Retrouvez les jobs que vous avez créés dans la W&B App, sous l’onglet Jobs du workspace de votre projet. À partir de là, vous pouvez configurer des jobs et les envoyer vers une file d’attente Launch pour les exécuter sur différentes ressources cibles.

​

Launch queue

Les files d’attente Launch sont des listes ordonnées de jobs à exécuter sur une ressource cible spécifique. Les files d’attente Launch fonctionnent selon le principe du premier entré, premier sorti (FIFO). Aucune limite pratique ne s’applique au nombre de files d’attente que vous pouvez avoir, mais il est généralement recommandé d’avoir une file d’attente par ressource cible. Vous pouvez mettre des jobs en file d’attente avec la W&B App UI, le W&B CLI ou le SDK Python. Vous pouvez ensuite configurer un ou plusieurs agents Launch pour extraire des éléments de la file d’attente et les exécuter sur la ressource cible de cette dernière.

​

Ressources cibles

L’environnement de calcul sur lequel une file d’attente Launch exécute des jobs est appelé ressource cible.

W&B Launch prend en charge les ressources cibles suivantes :

• Docker
• Kubernetes
• AWS SageMaker
• Google Cloud Vertex AI

Chaque ressource cible utilise un ensemble différent de paramètres de configuration appelés configurations de ressource. Les configurations de ressource reprennent par défaut les valeurs définies pour chaque file d’attente Launch, mais chaque job peut les remplacer indépendamment. Voir la documentation de chaque ressource cible pour plus de détails.

​

agent Launch

Les agents Launch sont des programmes légers et persistants qui vérifient régulièrement les files d’attente Launch à la recherche de jobs à exécuter. Lorsqu’un agent Launch reçoit un job, il commence par créer l’image à partir de la définition du job ou par la récupérer, puis l’exécute sur la ressource cible.

Un agent peut interroger plusieurs files d’attente. Cependant, vous devez configurer correctement l’agent pour prendre en charge toutes les ressources cibles sous-jacentes de chaque file d’attente qu’il interroge.

​

Environnement de l’agent Launch

L’environnement de l’agent correspond à l’environnement dans lequel un agent Launch s’exécute et interroge la file d’attente à la recherche de jobs.

L’environnement d’exécution de l’agent est indépendant de la ressource cible d’une file d’attente. En d’autres termes, vous pouvez déployer des agents n’importe où, à condition de les configurer de manière adéquate pour accéder aux ressources cibles requises.