Utiliser les sandboxes avec le Cloud dédié de W&B

Si votre organisation utilise le Cloud dédié de W&B, authentifiez les sandboxes serverless à l’aide d’une clé API provenant de votre instance dédiée, et non de wandb.ai. Le client Python transmet votre clé et le nom d’hôte de votre instance au service de sandbox de CoreWeave, qui vérifie la validité de la clé auprès de votre instance. Faites pointer le client vers l’URL de votre instance pour que l’authentification s’effectue auprès de la bonne instance.

Avant de commencer

Vous avez besoin des éléments suivants :

L’accès aux sandboxes activé pour votre instance de Cloud dédié de W&B. Contactez votre équipe de compte W&B pour vérifier que votre instance dispose des mises à jour serveur requises et pour demander l’accès.
L’URL de votre instance de Cloud dédié de W&B, par exemple https://[INSTANCE].wandb.io. Le nom d’hôte doit se terminer par .wandb.io. Les instances sur des domaines personnalisés ne sont pas prises en charge.
Python 3.11 ou version ultérieure.

Les déploiements W&B autogérés, y compris les installations isolées du réseau, ne sont pas pris en charge. Le client TypeScript ne prend pas encore en charge les instances de Cloud dédié : utilisez donc le client Python.

Obtenir une clé API depuis votre instance

Créez une clé API personnelle sur votre instance dédiée, et non sur forge.coreweave.com/settings#apikeys :

Connectez-vous à votre instance de Cloud dédié de W&B.
Cliquez sur l’icône de votre profil utilisateur, puis sur User Settings.
Faites défiler jusqu’à la section API Keys et créez une clé.

W&B n’affiche la clé complète qu’une seule fois, au moment de sa création. Pour plus d’informations, voir Comment puis-je trouver ma clé API ? dans la documentation W&B. La clé doit être une clé API personnelle (utilisateur). Les autres types d’identifiants d’authentification W&B sont refusés.

Configurer le client pour votre instance

Installez le client Python avec la dépendance optionnelle wandb :

uv pip install 'cwsandbox[wandb]>=1.10.0'

Définissez l’URL de votre instance et votre clé API. Remplacez [INSTANCE] par le préfixe du nom d’hôte de votre instance et [WANDB-API-KEY] par la clé que vous avez créée :

export WANDB_BASE_URL="https://[INSTANCE].wandb.io"
export WANDB_API_KEY="[WANDB-API-KEY]"

Le client récupère les identifiants d’authentification via la bibliothèque wandb, qui lit WANDB_BASE_URL pour déterminer quelle instance W&B a émis votre clé.

Exécuter une sandbox

Passez auth=AuthStrategy.WANDB pour utiliser l’authentification W&B. À défaut, le client recherche un jeton d’accès à l’API CoreWeave dans CWSANDBOX_API_KEY.

from cwsandbox import AuthStrategy, Sandbox

with Sandbox.run(
    auth=AuthStrategy.WANDB,
    resources={"cpu": "1", "memory": "1Gi"},
) as sandbox:
    result = sandbox.exec(["echo", "Hello!"]).result()
    print(result.stdout)

Si la commande réussit, Hello! s’affiche dans la sortie. Si l’authentification échoue, vérifiez que WANDB_BASE_URL correspond à l’instance sur laquelle vous avez créé la clé. Une clé issue d’une instance dédiée ne permet pas de s’authentifier auprès de wandb.ai, et inversement, une clé wandb.ai ne permet pas de s’authentifier auprès d’une instance dédiée.

Étapes suivantes

Premiers pas avec CoreWeave Sandboxes présente les modes de placement, les identifiants d’authentification et le débordement.
La documentation du client Python traite du cycle de vie, de l’exécution, des opérations sur les fichiers et d’autres modèles d’utilisation du SDK.

​Avant de commencer

​Obtenir une clé API depuis votre instance

​Configurer le client pour votre instance

​Exécuter une sandbox

​Étapes suivantes

Avant de commencer

Obtenir une clé API depuis votre instance

Configurer le client pour votre instance

Exécuter une sandbox

Étapes suivantes