Supprimez des artefacts de manière interactive avec la W&B App ou par programmation avec le SDK Python W&B. Lorsque vous supprimez un artefact, W&B marque cet artefact comme étant en soft-delete. En d’autres termes, l’artefact est marqué comme devant être supprimé, mais les fichiers ne sont pas immédiatement supprimés du stockage.
Le contenu de l’artefact reste en état de soft-delete, c’est-à-dire en attente de suppression, jusqu’à ce qu’un processus de garbage collection exécuté régulièrement examine tous les artefacts marqués pour suppression. Le processus de garbage collection supprime les fichiers associés du stockage si l’artefact et ses fichiers associés ne sont utilisés par aucune version antérieure ou ultérieure de l’artefact.
La garbage collection est effectuée au mieux. W&B ne garantit pas le délai d’apparition de l’espace libéré dans votre stockage d’objets après la suppression d’un artefact. Les déploiements volumineux ou les files d’attente importantes peuvent prendre plus de temps que prévu. Pour savoir comment cela s’articule avec les données d’exécution, les paramètres de rétention et les actions facultatives de l’opérateur, voir Gérer le stockage du bucket et les coûts. Flux de travail de garbage collection des artefacts
Les artefacts supprimés par une politique TTL, le SDK Python de W&B ou la W&B App sont d’abord en soft-delete. Les artefacts en soft-delete sont ensuite soumis à la garbage collection avant d’être définitivement supprimés.
La suppression d’une entité, d’un projet ou d’une collection d’artefacts déclenche le processus de suppression des artefacts décrit sur cette page. Lorsque vous supprimez une run et choisissez de supprimer les artefacts qui lui sont associés, ces artefacts suivent le même flux de travail de soft-delete et de garbage collection.
Supprimer une version d’artefact
Pour supprimer une version d’artefact :
- Accédez au projet qui contient la version d’artefact que vous souhaitez supprimer.
- Sélectionnez l’onglet Artifacts.
- Dans la liste des types d’artefact, sélectionnez le type d’artefact qui contient la version que vous souhaitez supprimer.
- Cliquez sur les trois points horizontaux (
...) à côté de la version d’artefact que vous souhaitez supprimer.
- Dans le menu déroulant, choisissez Supprimer la version.
Supprimez une version d’artefact par programmation avec la méthode wandb.Artifact.delete(). Indiquez le nom complet de l’artefact. Le nom complet se compose de <entity>/<project>/<artifact_name>:<version>. Définissez le paramètre delete_aliases sur True pour supprimer l’artefact même s’il possède un ou plusieurs alias qui lui sont associés.import wandb
api = wandb.Api()
# Obtenir l'artifact à partir de son chemin
artifact = api.artifact("<entity>/<project>/<artifact_name>:<version>")
# Supprimer la version de l'artifact ainsi que tous les alias
artifact.delete(delete_aliases=True)
Supprimer plusieurs versions d’artefact
wandb.Api.run(). Cela renvoie un objet run que vous pouvez utiliser pour accéder à toutes les versions d’artefact créées par ce run. Parcourez ensuite les versions d’artefact et supprimez celles qui correspondent à vos critères.
Définissez le paramètre delete_aliases sur True (wandb.Artifact.delete(delete_aliases=True)) pour supprimer une version d’artefact ainsi que tous les alias qui lui sont associés.
<entity>, <project>, <run_id> et <artifact_name> par vos propres valeurs :
import wandb
# Initialiser l'API W&B
api = wandb.Api()
# Obtenir le run par son chemin. Composé de <entity>/<project>/<run_id>
run = api.run("<entity>/<project>/<run_id>")
# Spécifier le nom de l'artifact dont les versions doivent être supprimées
artifact_name = "<artifact_name>"
# Rechercher et supprimer les versions d'artifact portant le nom spécifié
for artifact in run.logged_artifacts():
print(f"Found artifact: {artifact.name}") # Exemple de nom : run_4dfbufgq_model:v0
# Récupérer uniquement le nom de l'artifact sans la version grâce à split()
if artifact.name.split(":")[0] == artifact_name:
print(f"Suppression de la version d'artifact : {artifact.name}")
artifact.delete(delete_aliases=True)
Supprimer plusieurs versions d’artefact avec un alias spécifique
<entity>, <project>, <run_id>, <artifact_name> et <alias> par vos propres valeurs :
import wandb
# Initialiser l'API W&B
api = wandb.Api()
# Obtenir le run par son chemin. Composé de <entity>/<project>/<run_id>
run = api.run("<entity>/<project>/<run_id>")
# Spécifier le nom de l'artifact dont les versions doivent être supprimées
artifact_name = "<artifact_name>"
# Spécifier l'alias pour filtrer les versions d'artifact à supprimer
desired_alias = "<alias>"
# Supprimer les artifacts enregistrés dans le run avec les alias 'v3' et 'v4
for artifact in run.logged_artifacts():
print(f"Found artifact: {artifact.name}")
if (artifact.name.split(":")[0] == artifact_name) and (desired_alias in artifact.aliases):
artifact.delete(delete_aliases=True)
Supprimer une collection d’artifacts
Pour supprimer une collection d’artifacts :
- Accédez à la collection d’artifacts que vous souhaitez supprimer.
- Sélectionnez les trois points horizontaux (
...) à côté du nom de la collection d’artifacts.
- Dans le menu déroulant, sélectionnez Delete.
Supprimez une collection d’artifacts par programmation à l’aide de la méthode wandb.Artifact.delete().Indiquez le chemin complet de la collection d’artifacts dans wandb.Api.artifact_collection(name=""). Le chemin complet est au format <entity>/<project>/<artifact_collection_name>.import wandb
# Initialiser l'API W&B
api = wandb.Api()
# Obtenir la collection d'artifacts à partir de son chemin :
# <entity>/<project>/<artifact_collection_name>
collection = api.artifact_collection(
type_name = "<artifact_type>",
name = "<entity>/<project>/<artifact_collection_name>"
)
collection.delete()
Alias protégés et autorisations de suppression
Considérations importantes concernant les alias protégés :
- Les Artefacts avec des alias protégés ne peuvent pas être supprimés par des utilisateurs qui ne sont pas administrateurs du registre.
- Au sein d’un registre, les administrateurs du registre peuvent dissocier des versions d’Artefacts protégées et supprimer des collections/registres contenant des alias protégés.
- Pour les artefacts source : si un artefact source est lié à un registre avec un alias protégé, il ne peut être supprimé par aucun utilisateur
- Les administrateurs du registre peuvent supprimer les alias protégés des artefacts source, puis les supprimer.
Activer le garbage collection selon le mode d’hébergement de W&B
- W&B Autogéré : définissez
GORILLA_ARTIFACT_GC_ENABLED=true.
- Cloud dédié : contactez l’assistance pour vérifier que le garbage collection est actif.
- Activez la gestion des versions du bucket si vous utilisez AWS, Google Cloud ou tout autre fournisseur de stockage comme Minio. Si vous utilisez Azure, activez la suppression réversible, qui est l’équivalent de la gestion des versions du bucket.
Le tableau suivant indique comment remplir les conditions requises pour activer le garbage collection en fonction de votre type de déploiement.
Le X indique que vous devez remplir cette condition :
| Variable d’environnement | Activer la gestion des versions |
|---|
| Cloud mutualisé de W&B | | |
| Cloud mutualisé de W&B avec stockage BYOB | | X |
| Cloud dédié | | |
| Cloud dédié avec stockage BYOB | | X |
| W&B Autogéré | X | X |
remarque
Le connecteur de stockage sécurisé est actuellement disponible uniquement pour Google Cloud Platform et Amazon Web Services.
