> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wandb.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Aperçu du registre
> Utilisez W&B Registry pour gérer et partager les versions d'artifacts dans votre organisation
export const ColabLink = ({url}) =>
Essayer sur Colab
;
W\&B Registry est un dépôt central organisé de [versions de W\&B Artifact](/fr/models/artifacts/create-a-new-artifact-version) au sein de votre organisation. Les Users qui [disposent des autorisations nécessaires](/fr/models/registry/configure_registry/) dans votre organisation peuvent [télécharger et utiliser des artifacts](/fr/models/registry/download_use_artifact/), les partager et gérer de manière collaborative le cycle de vie de tous les artifacts, quelle que soit l’équipe à laquelle l’utilisateur appartient.
Utilisez le registre pour suivre les versions d’artifacts, auditer l’historique d’utilisation et des modifications d’un artifact, garantir la gouvernance et la conformité de vos artifacts, et [automatiser les processus en aval, comme le CI/CD des modèles](/fr/models/automations/).
En résumé, utilisez W\&B Registry pour :
* [Promouvoir](/fr/models/registry/link_version/) des versions d’artifacts adaptées à une tâche de machine learning auprès d’autres utilisateurs de votre organisation.
* Organiser les [artifacts avec des tags](/fr/models/registry/organize-with-tags/) afin de trouver ou référencer des artifacts spécifiques.
* Suivre la [traçabilité d’un artifact](/fr/models/registry/lineage/) et auditer l’historique des modifications.
* [Automatiser](/fr/models/automations/) des processus en aval, comme le CI/CD des modèles.
* [Gérer les personnes de votre organisation](/fr/models/registry/configure_registry/) qui peuvent accéder aux artifacts dans chaque registre.
L’image suivante montre la page d’accueil de W\&B Registry. Un registre nommé `Model` est marqué d’une étoile. Deux collections sont affichées : `DemoModels` et `Zoo_Classifier_Models`.
## Découvrez les bases
Chaque organisation contient initialement deux registres que vous pouvez utiliser pour organiser vos artifacts de modèles et de jeux de données, appelés respectivement **Models** et **Datasets**. Vous pouvez [créer des registres supplémentaires pour organiser d'autres types d'artifact selon les besoins de votre organisation](/fr/models/registry/create_registry).
Chaque [*registre*](/fr/models/registry/configure_registry/) se compose d'une ou plusieurs [*collections*](/fr/models/registry/create_collection/). Chaque collection correspond à une tâche ou à un cas d'utilisation distinct.
Pour ajouter un artifact à un registre, vous devez d'abord journaliser une [version spécifique d'artifact dans W\&B](/fr/models/artifacts/create-a-new-artifact-version/). Chaque fois que vous journalisez un artifact, W\&B lui attribue automatiquement une version. Les versions d'artifact utilisent une indexation à partir de 0 : la première version est donc `v0`, la deuxième `v1`, et ainsi de suite.
Une fois qu'un artifact est journalisé dans W\&B, vous pouvez ensuite lier cette version spécifique d'artifact à une collection dans le registre.
Le terme "lien" désigne des pointeurs qui relient l'emplacement où W\&B stocke l'artifact et l'emplacement où l'artifact est accessible dans le registre. W\&B ne duplique pas les artifacts lorsque vous liez un artifact à une collection.
Par exemple, l'exemple de code suivant journalise et lie un artifact de modèle appelé `"my_model.txt"` à une collection nommée `"first-collection"` dans un registre appelé `"model"` :
1. Initialisez un run W\&B avec `wandb.init()`.
2. Journalisez l'artifact dans W\&B avec `wandb.Run.log()`.
3. Indiquez le nom de la collection et du registre auxquels lier votre version d'artifact.
4. Liez l'artifact à la collection à l'aide de `wandb.Run.link_artifact()`.
Enregistrez ce code Python dans un script, puis exécutez-le. La version 0.18.6 ou ultérieure du SDK Python W\&B est requise.
```python title="hello_collection.py" theme={null}
import wandb
import random
# Initialiser un run W&B pour suivre l'artifact
with wandb.init(project="registry_quickstart") as run:
# Créer un fichier de modèle simulé pour pouvoir l'enregistrer
with open("my_model.txt", "w") as f:
f.write("Model: " + str(random.random()))
# Journaliser l'artifact dans W&B
logged_artifact = run.log_artifact(
artifact_or_path="./my_model.txt",
name="gemma-finetuned",
type="model" # Spécifie le type d'artifact
)
# Indiquer le nom de la collection et du registre
# dans lesquels vous souhaitez publier l'artifact
COLLECTION_NAME = "first-collection"
REGISTRY_NAME = "model"
# Lier l'artifact au registre
run.link_artifact(
artifact=logged_artifact,
target_path=f"wandb-registry-{REGISTRY_NAME}/{COLLECTION_NAME}"
)
```
W\&B crée automatiquement une collection pour vous si la collection que vous spécifiez dans la méthode `wandb.Run.link_artifact(target_path = "")` de l'objet run renvoyé n'existe pas dans le registre que vous indiquez.
En reprenant l'exemple précédent, après avoir exécuté le script, accédez à W\&B Registry pour voir les versions d'artifact que vous et les autres membres de votre organisation publiez. Sélectionnez **Registry** dans la barre latérale du projet, sous **Applications**. Sélectionnez le registre `"Model"`. Dans le registre, vous devriez voir la collection `"first-collection"` avec votre version d'artifact liée.
Une fois qu'une version d'artifact est liée à une collection dans un registre, les membres de votre organisation peuvent [voir](/fr/models/registry/lineage), [télécharger](/fr/models/registry/download_use_artifact), [organiser](/fr/models/registry/organize-with-tags) et gérer vos versions d'artifact, créer des automatisations en aval, et plus encore, s'ils disposent des autorisations appropriées.
Si une version d'artifact enregistre des métriques (par exemple avec `wandb.Run.log_artifact()`), vous pouvez consulter les métriques de cette version depuis sa page de détails, et comparer les métriques entre plusieurs versions d'artifact depuis la page de la collection. Référez-vous à [Voir les artifacts liés dans un registre](/fr/models/registry/link_version/#view-linked-artifacts-in-a-registry).
## Activer W\&B Registry
Selon votre type de déploiement, remplissez les conditions suivantes pour activer W\&B Registry :
| Type de déploiement | Comment l’activer |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Cloud mutualisé | Aucune action requise. W\&B Registry est disponible dans W\&B App. |
| Cloud dédié | Contactez l’équipe en charge de votre compte pour activer W\&B Registry pour votre déploiement. |
| Autogéré | Pour Server v0.71.0 ou version ultérieure, aucune action requise. Registry est activé par défaut. Pour les anciennes versions de Server prises en charge, contactez votre équipe de compte W\&B pour activer Registry. |
## Ressources pour bien démarrer
Selon votre cas d’usage, consultez les ressources suivantes pour démarrer avec W\&B Registry :
* Regardez la vidéo de tutoriel :
* [Bien démarrer avec W\&B Registry](https://www.youtube.com/watch?v=p4XkVOsjIeM)
* Suivez le cours W\&B [Model CI/CD](https://www.wandb.courses/courses/enterprise-model-management) et découvrez comment :
* Utiliser W\&B Registry pour gérer et versionner vos artifacts, suivre la traçabilité et faire passer vos modèles par différentes étapes de leur cycle de vie.
* Automatiser vos flux de travail de gestion des modèles à l’aide de webhooks.
* Intégrer W\&B Registry à des systèmes et outils ML externes pour l’évaluation, la surveillance et le déploiement des modèles.
