Lier une version d'artifact à une collection

Pour rendre une version d’artifact accessible à votre organisation, liez-la à une collection dans W&B Registry. La liaison fait passer la version d’une portée privée au niveau du projet à une portée partagée au niveau de l’organisation. Vous pouvez lier une version d’artifact par programmation à l’aide du W&B Python SDK ou de manière interactive dans la W&B App. Lorsque vous liez un artifact, W&B crée une référence entre l’artifact source et l’entrée de collection. La version liée pointe vers la version de l’artifact source qui a été enregistrée dans un run d’un projet. Vous pouvez consulter à la fois la version liée dans la collection et la version source dans le projet où elle a été enregistrée.

Lier un artifact à une collection

Choisissez un flux de travail selon que vous souhaitez créer l’artifact pendant un run, le créer sans run ou lier une version d’artifact existante.

Avant de commencer, vérifiez les points suivants :

Les types d’artifacts autorisés par la collection. Pour plus d’informations sur les types de collection, voir “Types de collection” dans Créer une collection.
Le registre auquel appartient la collection existe déjà. Pour vérifier que le registre existe, accédez à Registry App et recherchez le nom du registre.

SDK pour Python
Registre W&B
Explorateur d’artefacts

Liez par programmation une version d’artefact à une collection avec wandb.Run.link_artifact() ou wandb.Artifact.link()Le tableau suivant résume les méthodes que vous pouvez utiliser pour lier une version d’artefact à une collection, ainsi que ce que W&B enregistre pour chacune d’elles.

Cas d’utilisation	Méthode	Ce que W&B enregistre
Créer un artefact pendant un run et le lier à une collection	`wandb.Run.link_artifact()`	Journalise l’artefact comme sortie du run actif, puis le lie
Créer et lier un artefact sans démarrer explicitement un run	`wandb.Artifact.link()` sur un brouillon d’artefact	Enregistre d’abord l’artefact ; si aucun run n’est actif, crée un run automatique
Lier un artefact existant déjà validé	`wandb.Artifact.link()` sur un artefact de `wandb.Api().artifact()`	Lie l’artefact sans créer de nouveau run

Passez le chemin de la collection de destination au paramètre target_path. Le chemin se compose du préfixe wandb-registry-, du nom du registre et du nom de la collection :

wandb-registry-{REGISTRY_NAME}/{COLLECTION_NAME}

Utilisez wandb.Run.link_artifact() pour créer et lier une version d’artefact pendant un run actif. W&B journalise les brouillons d’artefacts en tant que sorties du run avant de les lier.Pour créer et lier une version d’artefact :

Initialisez un run avec wandb.init().
Créez un objet Artifact et ajoutez un ou plusieurs fichiers.
Appelez wandb.Run.link_artifact() et spécifiez la collection de destination.

Remplacez les valeurs entre chevrons (<>) par vos propres valeurs :

import wandb

entity = "<team_entity>"          # Votre entité d'équipe
project = "<project_name>"        # Le nom du projet contenant votre artifact

# Initialiser un run
with wandb.init(entity = entity, project = project) as run:

  # Créer un objet artifact
  # Le paramètre type spécifie à la fois le type de
  # l'objet artifact et le type de la collection
  artifact = wandb.Artifact(name = "<name>", type = "<type>")

  # Ajouter le fichier à l'objet artifact.
  # Indiquez le chemin vers le fichier sur votre machine locale.
  artifact.add_file(local_path = "<local_path_to_artifact>")

  # Spécifier la collection et le registre auxquels lier l'artifact
  REGISTRY_NAME = "<registry_name>"  
  COLLECTION_NAME = "<collection_name>"
  target_path=f"wandb-registry-{REGISTRY_NAME}/{COLLECTION_NAME}"

  # Lier l'artifact à la collection
  run.link_artifact(artifact = artifact, target_path = target_path)

Utilisez wandb.Artifact.link() pour créer et lier un brouillon d’artefact sans initialiser explicitement un run. W&B crée automatiquement un run si nécessaire pour enregistrer l’artefact avant de le lier.Pour créer et lier une version d’artefact :

Créez un objet Artifact et ajoutez-y un ou plusieurs fichiers.
Appelez wandb.Artifact.link() et indiquez la collection de destination.

Remplacez les valeurs entre chevrons (<>) par vos propres valeurs :

import wandb

# Créer un objet artifact
# Le paramètre type spécifie à la fois le type de 
# l'objet artifact et le type de la collection
artifact = wandb.Artifact(name = "<name>", type = "<type>")

# Ajouter le fichier à l'objet artifact. 
# Indiquez le chemin vers le fichier sur votre machine locale.
artifact.add_file(local_path = "<local_path_to_artifact>")

# Indiquer la collection et le registre auxquels lier l'artifact
REGISTRY_NAME = "<registry_name>"  
COLLECTION_NAME = "<collection_name>"
target_path=f"wandb-registry-{REGISTRY_NAME}/{COLLECTION_NAME}"

# Lier l'artifact à la collection
artifact.link(target_path = target_path)

Utilisez wandb.Artifact.link() sur un artifact récupéré avec wandb.Api().artifact() pour lier une version existante d’un artifact déjà validé sans créer de nouveau run.

Créez un client d’API publique avec wandb.Api().
Récupérez la version de l’artifact avec wandb.Api.artifact().
Appelez wandb.Artifact.link() et spécifiez la collection de destination.

import wandb

api = wandb.Api()

artifact = api.artifact(
    "<entity>/<project>/<artifact-name>:<alias-or-version>"
)

artifact.link(
    target_path="wandb-registry-<registry-name>/<collection-name>",
    aliases=["latest"],
)

Accédez au navigateur d’artefacts de votre projet dans l’application W&B à l’adresse suivante : https://wandb.ai/<entity>/<project>/artifacts
Sélectionnez l’icône Artifacts dans la barre latérale du projet.
Cliquez sur la version de l’artefact que vous souhaitez lier à votre Registry.
Dans la section Version overview, cliquez sur le bouton Link to registry.
Dans la fenêtre modale qui s’affiche à droite de l’écran, sélectionnez un artefact dans le menu déroulant Select a registered model.
Cliquez sur Next step.
(Facultatif) Sélectionnez un alias dans le menu déroulant Aliases.
Cliquez sur Link to registry.

Vous pouvez consulter les métadonnées, les informations de version, l’utilisation et les informations de traçabilité d’un artifact lié ainsi que d’autres éléments dans la Registry App.

Dissocier une version d’artifact d’une collection

Utilisez le SDK Python W&B ou W&B Registry pour dissocier une version d’artifact d’une collection. La dissociation retire la version d’artifact de la collection, mais ne supprime ni la version source de l’artifact ni ses fichiers.

L’association d’une version d’artifact à une collection de registre désactive sa stratégie de durée de vie (TTL) et définit sa valeur TTL sur None. Si vous dissociez ultérieurement la version, W&B ne restaure pas la valeur TTL précédente et ne conserve pas sa durée initiale. Reconfigurez la TTL après la dissociation si la version en nécessite toujours une.Pour plus d’informations sur les stratégies TTL, voir Gérer la rétention des données d’artifact.

SDK Python
W&B Registry

Pour dissocier une version d’artifact avec le SDK Python W&B :

Créez un client de l’API publique avec wandb.Api().
Récupérez la version d’artifact liée avec wandb.Api.artifact().
Appelez wandb.Artifact.unlink() pour dissocier la version d’artifact de la collection.

wandb-registry-<registry_name>/<collection_name>:<version_or_alias>

Remplacez les valeurs d’espace réservé par vos propres valeurs :

import wandb

registry_name = "your-registry-name"  # Remplacez par le nom du registre
collection_name = "your-collection-name"  # Remplacez par le nom de la collection
version = "version-or-alias"  # Remplacez par la version de l’artifact à dissocier

target_path=f"wandb-registry-{registry_name}/{collection_name}:{version}"

api = wandb.Api()
linked_artifact = api.artifact(name=target_path)

# Dissocier la version d’artifact de la collection
linked_artifact.unlink()

Afficher les artifacts liés dans un registre

Affichez des informations sur les artifacts liés, comme les métadonnées, la traçabilité et les informations d’utilisation, dans le W&B Registry.

Accédez au W&B Registry.
Sélectionnez le nom du registre auquel vous avez lié l’artifact.
Sélectionnez le nom de la collection.
Si les artifacts de la collection consignent des métriques, comparez les métriques entre les versions en cliquant sur Afficher les métriques.
Dans la liste des versions d’artifact, sélectionnez la version à laquelle vous souhaitez accéder. Les numéros de version sont attribués de façon incrémentielle à chaque version d’artifact liée, à partir de v0.
Pour afficher les détails d’une version d’artifact, cliquez sur la version. Dans les onglets de cette page, vous pouvez consulter les métadonnées de cette version (y compris les métriques enregistrées), sa traçabilité et ses informations d’utilisation.

Notez le champ Nom complet dans l’onglet Version. Le nom complet d’un artifact lié se compose du registre, du nom de la collection, ainsi que de l’alias ou de l’index de la version d’artifact.

Full name of a linked artifact

wandb-registry-{REGISTRY_NAME}/{COLLECTION_NAME}:v{INTEGER}

Vous avez besoin du nom complet d’un artifact lié pour accéder à la version de l’artifact par programmation.

Dépannage

Voici quelques points courants à vérifier si vous ne parvenez pas à lier un artifact.

Enregistrer des Artifacts depuis un compte personnel

Les Artifacts enregistrés dans W&B avec une entité personnelle ne peuvent pas être liés au registre. Veillez à enregistrer les Artifacts à l’aide d’une entité d’équipe au sein de votre organisation. Seuls les Artifacts enregistrés au sein de l’équipe d’une organisation peuvent être liés au registre de l’organisation.

Veillez à enregistrer un artifact avec une entité d’équipe si vous souhaitez le lier à un registre.

Trouvez votre entité d’équipe

W&B utilise le nom de votre équipe comme entité d’équipe. Par exemple, si votre équipe s’appelle team-awesome, votre entité d’équipe est team-awesome. Vous pouvez confirmer le nom de votre équipe en :

Accédez à la page de profil W&B de votre équipe.
Copiez l’URL du site. Elle se présente sous la forme https://wandb.ai/<team>, où <team> correspond à la fois au nom de votre équipe et à son entité.

Journal depuis une entité d’équipe

Spécifiez l’équipe comme entité lorsque vous initialisez un run avec wandb.init(). Si vous ne spécifiez pas entity lors de l’initialisation d’un run, le run utilise votre entité par défaut, qui peut être ou non votre entité d’équipe.
import wandb with wandb.init(entity='<team_entity>', project='<project_name>') as run: # Journalisez votre artifact ici
Journalisez l’artifact dans le run soit avec wandb.Run.log_artifact(), soit en créant un objet Artifact puis en y ajoutant des fichiers avec :
artifact = wandb.Artifact(name="<artifact_name>", type="<type>")
Pour journaliser des Artifacts, voir Créer des Artifacts.
Si un artifact est enregistré dans votre entité personnelle, vous devrez le journaliser à nouveau dans une entité de votre organisation.

Confirmer le chemin d’un registre dans l’interface de l’application W&B

Créez une collection vide pour confirmer le chemin du registre dans l’interface de l’application W&B. Pour ce faire, suivez les étapes ci-dessous :

Accédez au W&B Registry à l’adresse https://wandb.ai/registry/.
Cliquez sur le registre auquel vous souhaitez lier un artifact.
Cliquez sur la collection vide. Si aucune collection vide n’existe, créez-en une.
Dans l’extrait de code qui s’affiche, identifiez le champ target_path dans .link_artifact().
(Facultatif) Supprimez la collection.

Par exemple, une fois ces étapes terminées, vous trouverez le bloc de code contenant le paramètre target_path :

target_path = 
      "smle-registries-bug-bash/wandb-registry-Golden Datasets/raw_images"

En le décomposant en composants, vous pouvez voir ce que vous devrez utiliser pour créer par programmation le chemin permettant de lier votre artifact :

ORG_ENTITY_NAME = "smle-registries-bug-bash"
REGISTRY_NAME = "Golden Datasets"
COLLECTION_NAME = "raw_images"

Assurez-vous de remplacer le nom de la collection temporaire par celui de la collection à laquelle vous souhaitez lier votre artifact.

Guides

Intégrations

Référence

Lier un artifact à une collection

Dissocier une version d’artifact d’une collection

Afficher les artifacts liés dans un registre

Dépannage

Enregistrer des Artifacts depuis un compte personnel

Trouvez votre entité d’équipe

Journal depuis une entité d’équipe

Confirmer le chemin d’un registre dans l’interface de l’application W&B

​Lier un artifact à une collection

​Dissocier une version d’artifact d’une collection

​Afficher les artifacts liés dans un registre

​Dépannage

​Enregistrer des Artifacts depuis un compte personnel

​Trouvez votre entité d’équipe

​Journal depuis une entité d’équipe

​Confirmer le chemin d’un registre dans l’interface de l’application W&B

Lier un artifact à une collection

Dissocier une version d’artifact d’une collection

Afficher les artifacts liés dans un registre

Dépannage

Enregistrer des Artifacts depuis un compte personnel

Trouvez votre entité d’équipe

Journal depuis une entité d’équipe

Confirmer le chemin d’un registre dans l’interface de l’application W&B