cwsandbox d’acheminer les opérations d’exécution, de journalisation et sur les fichiers directement vers l’exécuteur. Ces opérations utilisent le protocole mTLS (mutual Transport Layer Security) au lieu de transiter par la passerelle CoreWeave Sandboxes. Les appels de cycle de vie et de gestion, eux, continuent de passer par la passerelle.
Cette page s’adresse aux administrateurs qui exploitent un exécuteur géré sur un cluster CoreWeave Kubernetes Service (CKS). Elle aborde les sujets suivants :
- La manière dont le chemin direct atteint l’exécuteur.
- Le choix et la configuration d’un mode d’exposition.
- L’acheminement du point de terminaison via votre propre contrôleur d’ingress.
- La vérification que le point de terminaison est prêt.
Chemin de connexion directe vers l’exécuteur
Chaque exécuteur géré peut exposer un point de terminaison de plan de données stable, placé en amont de toutes ses répliques. La plateforme résout l’adresse de ce point de terminaison à partir de la configurationdataPlane de l’exécuteur et délivre à ce dernier un certificat serveur pour cette adresse. La passerelle CoreWeave Sandboxes renvoie l’adresse aux clients, accompagnée d’un certificat client limité à la sandbox.
Les propriétés suivantes de ce chemin déterminent les choix de configuration présentés sur cette page :
- La session TLS se termine au niveau de l’exécuteur : l’exécuteur authentifie chaque connexion au moyen d’un certificat client. Les intermédiaires doivent transmettre le flux TCP (Transmission Control Protocol) sans le modifier. C’est notamment le cas des équilibreurs de charge, des contrôleurs d’ingress et des réseaux privés virtuels (VPN). Un proxy qui termine la session TLS puis la chiffre à nouveau, ou qui remplace l’identité du client par un en-tête, rompt le chemin direct.
- Le certificat serveur est émis pour l’adresse annoncée : la plateforme dérive les noms alternatifs du sujet (SAN) du certificat à partir de l’adresse que vous configurez. Les clients vérifient l’exécuteur par rapport à ce nom ; l’adresse doit donc être stable et se résoudre vers le point de terminaison.
- Le Service du plan de données expose un seul port : chaque mode d’exposition activé crée un Service uniquement pour l’écouteur du plan de données, sur le port TCP
9443. Un ingress personnalisé peut publier un autre port, par exemple443, et le rediriger vers ce Service. Le Service du plan de données n’expose pas les ports d’état de santé, de métriques ou de contrôle.
AUTO par défaut peuvent se replier sur la passerelle si la configuration de la connexion directe n’est pas disponible. En revanche, une erreur PERMISSION_DENIED ou UNAUTHENTICATED lors de l’émission des identifiants d’authentification entraîne toujours un échec. Si un certificat direct ne dispose pas de l’autorisation requise pour une opération, AUTO peut passer par la passerelle. Le repli ne garantit pas qu’une opération déjà envoyée à l’exécuteur puisse être relancée sans risque.
Prérequis
Avant de configurer le plan de données direct, assurez-vous de remplir les conditions suivantes :- Déployez un exécuteur géré et vérifiez que
installStatusa la valeurRUNNER_INSTALL_STATUS_READY. Dans les exemples, remplacezRUNNER_IDpar l’identifiant de votre exécuteur. Pour savoir comment le déployer, consultez Déployer et gérer un exécuteur. - Authentifiez-vous auprès de la CoreWeave Intelligent CLI ou exportez un jeton d’accès à l’API CoreWeave pour
curl, comme indiqué dans la section Avant de commencer de la page consacrée à l’exécuteur. Les exemples de cette page utilisent la même variable$TOKEN. - Utilisez un jeton disposant de l’autorisation
sandbox_adminpour consulter ou mettre à jour l’exécuteur. - Disposez d’un accès
kubectlau cluster CKS qui héberge l’exécuteur. Les ressources de l’exécuteur se trouvent dans le namespacecw-sandbox-system. Pour les exemples d’exposition personnalisée, installez également Helm et assurez-vous de disposer des autorisations nécessaires pour gérer les ressources de portée cluster, telles que les CustomResourceDefinitions (CRD) etGatewayClass.
Choisir un mode d’exposition
Le champspec.data_plane sélectionne un seul et unique mode d’exposition. Si vous ne définissez pas ce champ, l’exécuteur hérite de la valeur par défaut de la plateforme pour son canal de publication. Définissez explicitement disabled pour ne pas hériter d’une valeur par défaut activée.
Dans les adresses suivantes, remplacez SERVICE_NAME par le nom du Service de l’exécuteur et HOSTNAME par le nom d’hôte configuré.
La plateforme nomme le Service d’après son identifiant interne pour l’exécuteur. Récupérez donc le nom dans le cluster plutôt que de le déduire. Le Service porte l’étiquette
sandbox.coreweave.com/component=data-plane :
- Une fois qu’une valeur non vide est définie pour
load_balancer.load_balancer_class, vous ne pouvez plus la modifier ni l’effacer directement, y compris en passant à un autre mode d’exposition activé. Définissez d’aborddisabled, attendez que le Service soit supprimé, puis appliquez la nouvelle configuration. - Un changement de mode d’exposition peut modifier l’adresse annoncée et interrompre les opérations directes actives. Vérifiez à nouveau la connectivité après le changement.
Exposer le point de terminaison avec un Service LoadBalancer
Le modeload_balancer crée un Service LoadBalancer qui transfère le port TCP 9443 vers l’exécuteur sans terminaison TLS. Définissez l’accessibilité souhaitée avec scope et configurez la sélection d’adresse du fournisseur via annotations ou load_balancer_class. Indiquez les plages réseau des clients en notation CIDR (classless inter-domain routing) via source_ranges. Le fournisseur doit prendre en charge et appliquer ces plages sources.
hostname est requis. La plateforme l’inclut dans le certificat du serveur, annonce https://HOSTNAME:9443 aux clients et définit l’annotation external-dns.alpha.kubernetes.io/hostname sur le Service pour les clusters qui exécutent ExternalDNS. Sur CKS, publiez plutôt le nom via l’External Hostname Controller. Ajoutez l’annotation service.beta.kubernetes.io/external-hostname et définissez hostname sur le nom entièrement qualifié alloué par CKS. La valeur d’annotation courte runner-a donne runner-a.ORG_ID-CLUSTER_NAME.coreweave.app. Suivez uniquement les instructions d’allocation DNS de Create a public DNS name. L’exécuteur fournit son propre certificat TLS ; ne configurez donc pas de terminaison TLS au niveau de l’ingress pour ce point de terminaison.
Pour obtenir une adresse publique sur CKS, ajoutez également service.beta.kubernetes.io/coreweave-load-balancer-type: public. Avec la configuration d’adresse CKS par défaut, une adresse privée est attribuée si cette annotation est omise. Pour plus de détails sur la sélection d’adresse, voir Expose a Service. Une portée PRIVATE nécessite soit un load_balancer_class, soit une annotation de fournisseur, car la plateforme ne peut pas déduire la manière dont votre fournisseur sélectionne une adresse privée.
Remplacez ORG_ID et CLUSTER_NAME par l’identifiant de votre organisation et le nom du cluster, puis remplacez CLIENT_CIDR dans source_ranges par le CIDR d’un réseau depuis lequel vos clients se connectent.
- CLI
- curl
data-plane.yaml
cw-sandbox-system. Vérifiez l’adresse et le DNS du Service, puis testez la connexion depuis un client. Une mise à jour de configuration réussie ne garantit pas l’accessibilité réseau.
Acheminer le point de terminaison via votre propre contrôleur d’ingress
Si votre cluster assure déjà la terminaison du trafic entrant au niveau d’un contrôleur d’ingress, utilisez le modecustom pour un point de terminaison situé derrière la même adresse. La plateforme crée un Service ClusterIP sur le port 9443, et vous indiquez dans advertised_uri l’adresse que les clients doivent contacter.
Les exigences sont les mêmes que pour tout chemin placé devant l’exécuteur :
- Utilisez le TLS passthrough pour la route, avec une correspondance sur l’indication du nom de serveur TLS (SNI) de la connexion. N’effectuez pas la terminaison TLS au niveau du contrôleur d’ingress.
- Définissez
advertised_urisur une originehttps://absolue, sans chemin, requête ni identifiants d’authentification, par exemplehttps://runner-a.ORG_ID-CLUSTER_NAME.coreweave.app:443. L’hôte doit être résolu vers le contrôleur d’ingress, et le port doit correspondre à celui sur lequel le contrôleur écoute. - Installez des CRD Gateway API compatibles avec votre contrôleur. Le chart Traefik de CoreWeave et l’exemple Envoy Gateway
v1.9.1prennent tous deux en chargeTLSRouteen versionv1. Ne remplacez pas un ensemble de CRD appartenant à un autre composant sans vous coordonner au préalable avec son propriétaire.
.coreweave.app de votre cluster. Traefik s’appuie sur l’enregistrement générique (wildcard) du cluster, tandis que l’exemple Envoy crée un enregistrement spécifique via l’annotation external-hostname. Remplacez ORG_ID et CLUSTER_NAME par vos valeurs.
Préparer le contrôleur d’ingress
Choisissez le contrôleur que vous utilisez. Les deux configurations exposent un écouteur TLS passthrough pour le nom d’hôte de l’exécuteur sur un ServiceLoadBalancer public doté d’un nom DNS .coreweave.app.
- Traefik (graphique CoreWeave)
- Envoy Gateway
Le chart CoreWeave Traefik peut servir des routes Gateway API sur les mêmes Pods et le même Service
LoadBalancer que ses routes Ingress. Le Service du chart porte déjà les annotations service.beta.kubernetes.io/coreweave-load-balancer-type: public et service.beta.kubernetes.io/external-hostname: '*'. Grâce au caractère générique, les noms d’hôte sous *.ORG_ID-CLUSTER_NAME.coreweave.app se résolvent en Traefik, sauf si un enregistrement DNS spécifique est prioritaire. Avant d’utiliser le nom d’hôte de l’exécuteur, vérifiez qu’il se résout en l’adresse de Traefik. Si un enregistrement existant pointe ailleurs, choisissez un nom d’hôte inutilisé ou mettez à jour cet enregistrement. Consultez Gateway API pour connaître les prérequis du chart et les recommandations relatives à la propriété des CRD.- Suivez Install the Gateway API CRDs pour installer le bundle du canal standard pris en charge par le chart. Si un bundle compatible est déjà installé, réutilisez-le.
-
Activez le fournisseur Gateway API et ajoutez un listener TLS passthrough sur le point d’entrée
websecure. Leportdu listener correspond au port de conteneur de Traefik (8443), et non au port publié par leLoadBalancer(443) :traefik-values.yamlSi Traefik est déjà installé à partir de ce chart, fusionnez ces valeurs dans votre fichier de valeurs existant, puis mettez à niveau la release.
traefik-gateway et se trouve dans le namespace traefik. Utilisez ces valeurs pour GATEWAY_NAME et GATEWAY_NAMESPACE dans la route ci-dessous.Pointer l’exécuteur vers l’adresse de l’ingress
La valeurcustom.advertised_uri correspond à l’adresse que contactent les clients : elle doit donc indiquer le nom d’hôte et le port de l’ingress, et non le Service ClusterIP.
-
Définissez
custom.advertised_urisur l’adresse servie par votre contrôleur d’ingress. Cette configuration crée également le Service du plan de données que cible la route à l’étape suivante.- CLI
- curl
data-plane.yaml - Attendez la fin du déploiement progressif de l’exécuteur.
-
Relevez le nom du Service qu’il a créé :
Lier la route au Service de l’exécuteur
Créez uneTLSRoute dans le namespace de l’exécuteur afin de lier l’écouteur en mode passthrough au Service du plan de données.
-
Remplacez
GATEWAY_NAMEetGATEWAY_NAMESPACEpar les valeurs du contrôleur que vous avez préparé, etSERVICE_NAMEpar le nom du Service obtenu à l’étape précédente :runner-tlsroute.yaml -
Vérifiez la présence de
Accepted: Trueet deResolvedRefs: Truedansstatus.parents[].conditions. - Effectuez une vérification depuis un client du réseau qui utilise le point de terminaison.
Vérifier le statut du point de terminaison
Inspectez l’exécuteur après chaque modification de configuration.-
Vérifiez
installStatusetconnectionStatus, et assurez-vous queactiveRevisiona atteinttargetRevision.- CLI
- curl
-
Vérifiez le Service du plan de données :
Pour
load_balancer, assurez-vous que le Service dispose d’une adresse et que le nom d’hôte configuré se résout bien en cette adresse. Pourcustom, vérifiez l’adresse du contrôleur d’ingress ainsi que les conditions de laTLSRoute.
Vérifier depuis un client
Le client Python a besoin de sa propre variable d’environnement de jeton, même si vous avez utilisécwic auth login pour les commandes de gestion. Dans la commande suivante, remplacez API_ACCESS_TOKEN par le secret de votre jeton d’accès à l’API CoreWeave.
-
Installez le client dans un environnement virtuel Python actif, comme décrit dans Préparer votre environnement Python :
-
Exécutez une opération sur l’exécuteur CKS configuré, en définissant la politique de transport du client sur
DIRECT. Ce mode ne bascule jamais vers la passerelle : un appel réussi prouve donc que le chemin direct fonctionne depuis ce réseau :
DataPlaneMode.GATEWAY réussit, consultez la section Dépannage. Pour connaître l’ensemble des options du client, consultez Connexions directes aux sandbox.
Désactiver le point de terminaison
Définissezdisabled pour supprimer le Service créé par la plateforme. Les nouvelles opérations en mode AUTO peuvent passer par la passerelle lorsque la configuration directe n’est pas disponible. Les opérations forcées sur DIRECT échouent si elles ne parviennent pas à établir une connexion directe. Les opérations directes en cours risquent d’être interrompues.
- CLI
- curl