Gérer la rétention des données des artifacts

Planifiez la suppression des artifacts de W&B à l’aide d’une politique TTL (time-to-live, durée de vie) d’artifact W&B. Lorsque vous supprimez un artifact, W&B le marque comme soft-delete (suppression logique). Autrement dit, l’artifact est marqué pour suppression, mais ses fichiers ne sont pas immédiatement supprimés du stockage. Pour plus d’informations sur la façon dont W&B supprime les artifacts, consultez la page Supprimer des artifacts. Regardez le tutoriel vidéo Managing data retention with Artifacts TTL pour apprendre à gérer la rétention des données avec Artifacts TTL dans la W&B App.

Seuls les administrateurs d’équipe peuvent consulter les paramètres d’une équipe et accéder aux paramètres TTL au niveau de l’équipe, par exemple pour (1) définir qui est autorisé à configurer ou modifier une politique TTL ou (2) définir une TTL par défaut pour l’équipe.
Si l’option permettant de définir ou de modifier une politique TTL n’apparaît pas dans les détails d’un artifact dans l’interface de la W&B App, ou si la définition d’une TTL par programmation ne modifie pas la propriété TTL d’un artifact, cela signifie que votre administrateur d’équipe ne vous a pas accordé les autorisations nécessaires.

Artifacts générés automatiquement

Seuls les artifacts générés par les utilisateurs peuvent faire l’objet d’une politique TTL. Il est impossible de définir une politique TTL pour les artifacts générés automatiquement par W&B. Les types d’artifacts suivants signalent un artifact généré automatiquement :

run_table
code
job
Tout type d’artifact commençant par : wandb-*

Vous pouvez vérifier le type d’un artifact sur la plateforme W&B ou par programmation :

import wandb

with wandb.init(project="<my-project-name>") as run:
    artifact = run.use_artifact(artifact_or_name="<my-artifact-name>")
    print(artifact.type)

Remplacez les valeurs entre <> par les vôtres.

Définir qui peut modifier et configurer les politiques TTL

Définissez qui peut configurer et modifier les politiques TTL au sein d’une équipe. Vous pouvez réserver les autorisations TTL aux administrateurs d’équipe, ou bien les accorder à la fois aux administrateurs d’équipe et aux membres de l’équipe.

Seuls les administrateurs d’équipe peuvent définir qui peut configurer ou modifier une politique TTL.

Accédez à la page de profil de votre équipe.
Sélectionnez l’onglet Paramètres.
Accédez à la section Artifacts time-to-live (TTL) section.
Dans le menu déroulant TTL permissions dropdown, indiquez qui peut configurer et modifier les politiques TTL.
Cliquez sur Vérifier et enregistrer les paramètres.
Confirmez les modifications et sélectionnez Enregistrer les paramètres.

Créer une politique TTL

Définissez une politique TTL pour un artifact soit lors de sa création, soit rétroactivement, une fois l’artifact créé. Pour utiliser les extraits de code ci-dessous, remplacez le contenu entre <> par vos propres informations.

Définir une politique TTL lors de la création d’un artifact

Utilisez le SDK Python W&B pour définir une politique TTL lors de la création d’un artifact. Les politiques TTL sont généralement exprimées en jours.

Définir une politique TTL lors de la création d’un artifact revient à créer un artifact de la manière habituelle, à ceci près que vous transmettez un delta temporel à l’attribut ttl de l’artifact.

Procédez comme suit :

Créez un artifact.
Ajoutez du contenu à l’artifact, par exemple des fichiers, un répertoire ou une référence.
Définissez une durée limite TTL à l’aide du type de données datetime.timedelta de la bibliothèque standard de Python.
Journalisez l’artifact.

L’extrait de code suivant montre comment créer un artifact et définir une politique TTL.

import wandb
from datetime import timedelta

with wandb.init(project="<my-project-name>", entity="<my-entity>") as run:
    artifact = wandb.Artifact(name="<artifact-name>", type="<type>")
    artifact.add_file("<my_file>")

    artifact.ttl = timedelta(days=30)  # Définir la politique TTL
    run.log_artifact(artifact)

L’extrait de code ci-dessus définit une politique TTL de 30 jours pour l’artifact. Autrement dit, W&B supprime l’artifact au bout de 30 jours.

Définir ou modifier une politique TTL après la création d’un artifact

Utilisez l’interface de l’application W&B ou le SDK Python W&B pour définir une politique TTL sur un artifact existant.

Lorsque vous modifiez la TTL d’un artifact, son délai d’expiration reste calculé à partir de son horodatage createdAt.

SDK Python W&B
W&B App

Récupérez votre artifact.
Affectez une durée (timedelta) à l’attribut ttl de l’artifact.
Mettez à jour l’artifact avec la méthode save.

L’extrait de code suivant montre comment définir une politique TTL pour un artifact :

import wandb
from datetime import timedelta

artifact = run.use_artifact("<my-entity/my-project/my-artifact:alias>")
artifact.ttl = timedelta(days=365 * 2)  # Supprimer dans deux ans
artifact.save()

L’exemple de code ci-dessus fixe la politique TTL à deux ans.

Définir des politiques TTL par défaut pour une équipe

Seuls les administrateurs d’équipe peuvent définir une politique TTL par défaut pour une équipe.

Définissez une politique TTL par défaut pour votre équipe. Les politiques TTL par défaut s’appliquent à tous les artifacts existants et futurs, en fonction de leur date de création respective. Les artifacts qui disposent déjà d’une politique TTL au niveau de la version ne sont pas concernés par la politique TTL par défaut de l’équipe.

Accédez à la page de profil de votre équipe.
Sélectionnez l’onglet Settings.
Accédez à la section Artifacts time-to-live (TTL) section.
Cliquez sur Set team’s default TTL policy.
Dans le champ Duration, définissez la politique TTL en nombre de jours.
Cliquez sur vérifier et enregistrer les paramètres. 7/ Confirmez les modifications, puis sélectionnez enregistrer les paramètres.

Définition d’une politique TTL par défaut

Définir une politique TTL en dehors d’un run

Utilisez l’API publique pour récupérer un artifact sans passer par un run, puis définissez sa politique TTL. Les politiques TTL sont généralement exprimées en jours. L’exemple de code suivant montre comment récupérer un artifact à l’aide de l’API publique et définir sa politique TTL.

api = wandb.Api()

artifact = api.artifact("entity/project/artifact:alias")

artifact.ttl = timedelta(days=365)  # Suppression dans un an

artifact.save()

Désactiver une politique TTL

Utilisez le SDK Python W&B ou l’interface de l’application W&B pour désactiver la politique TTL d’une version spécifique d’un artifact.

SDK Python W&B
W&B App

Récupérez votre artifact.
Définissez l’attribut ttl de l’artifact sur None.
Mettez à jour l’artifact à l’aide de la méthode save.

L’extrait de code suivant montre comment désactiver la politique TTL d’un artifact :

artifact = run.use_artifact("<my-entity/my-project/my-artifact:alias>")
artifact.ttl = None
artifact.save()

Afficher les politiques TTL

Affichez les politiques TTL des artifacts avec le SDK Python ou avec l’interface de l’application W&B.

SDK Python W&B
W&B App

Utilisez une instruction print pour afficher la politique TTL d’un artifact. L’exemple suivant montre comment récupérer un artifact et afficher sa politique TTL :

artifact = run.use_artifact("<my-entity/my-project/my-artifact:alias>")
print(artifact.ttl)

Affichez la politique TTL d’un artifact avec l’interface de l’application W&B.

Accédez à la W&B App.
Accédez à votre projet W&B.
Dans votre projet, sélectionnez l’onglet Artifacts dans la barre latérale du projet.
Cliquez sur une collection.

La vue de la collection affiche tous les artifacts de la collection sélectionnée. La colonne Time to Live indique la politique TTL attribuée à chaque artifact.

Politiques TTL pour les versions d’artifact liées

W&B désactive les politiques TTL des versions d’artifact liées afin d’éviter que les artifacts utilisés dans des flux de travail de production n’expirent. Lorsque vous liez une version d’artifact à une collection du registre, W&B désactive sa politique TTL et définit son TTL sur None. Si vous dissociez ensuite la version d’artifact, W&B ne rétablit ni la politique TTL précédente ni sa durée. Si la version d’artifact en a toujours besoin, définissez une nouvelle politique TTL après la dissociation.

​Artifacts générés automatiquement

​Définir qui peut modifier et configurer les politiques TTL

​Créer une politique TTL

​Définir une politique TTL lors de la création d’un artifact

​Définir ou modifier une politique TTL après la création d’un artifact

​Définir des politiques TTL par défaut pour une équipe

​Définir une politique TTL en dehors d’un run

​Désactiver une politique TTL

​Afficher les politiques TTL

​Politiques TTL pour les versions d’artifact liées

Artifacts générés automatiquement

Définir qui peut modifier et configurer les politiques TTL

Créer une politique TTL

Définir une politique TTL lors de la création d’un artifact

Définir ou modifier une politique TTL après la création d’un artifact

Définir des politiques TTL par défaut pour une équipe

Définir une politique TTL en dehors d’un run

Désactiver une politique TTL

Afficher les politiques TTL

Politiques TTL pour les versions d’artifact liées