Sandboxes d'agents
Une machine à vous pour Claude Code, Codex, OpenCode et Pi : créée en une minute, arrêtée quand elle ne sert plus, facturée seulement quand elle tourne, et accessible depuis les outils déjà installés sur votre poste.
Une sandbox d'agent est un conteneur SailOps créé avec le preset agent-sandbox. Elle exécute une image gérée par SailOps, monte un espace de travail persistant sur /home/agent/workspace et s'utilise de trois façons : depuis le terminal du conteneur dans le navigateur, en SSH depuis votre IDE ou votre terminal, et comme environnement d'exécution de votre agent de code local grâce aux outils MCP. Tout ce qu'offre un conteneur (démarrage, arrêt, snapshots de volume, connexions à vos bases de données, logs, métriques, journal d'activité) s'applique à une sandbox.
Les sandboxes se trouvent dans IA › Sandboxes dans la console du projet.
Démarrage rapide
curl -fsSL https://raw.githubusercontent.com/herewecloud/sailops-sandbox/main/install.sh | sh # la CLI sailops-sandbox
export PATH="$HOME/.local/bin:$PATH" # inclut l'installation sans droits administrateur
sailops-sandbox init # collez une clé d'API du projet, une fois
sailops-sandbox run -- claude # Claude Code, dans une sandbox nommée comme votre dépôt
init enregistre le serveur MCP SailOps dans chaque outil de code trouvé sur la machine (Claude Code, Codex, OpenCode, Cursor), installe les consignes de la sandbox et configure SSH pour que ssh sailops-<nom> fonctionne. Dès lors, votre agent local exécute ses commandes dans la sandbox et jamais sur votre poste.
L'installateur télécharge le binaire depuis les releases du dépôt public herewecloud/sailops-sandbox. SAILOPS_SANDBOX_VERSION=v0.1.3 fige une version. Pour le staging ou un déploiement personnalisé, utilisez sailops-sandbox init --api-url https://votre-console ; le panneau Connect inclut cette URL automatiquement. Relancez l'installation puis init pour actualiser les entrées SSH existantes ; le proxy généré utilise le binaire installé et le dossier d'identifiants, sans dépendre du PATH du terminal dans votre IDE.
La clé d'API doit porter les scopes containers:list, containers:update, sandboxes:exec et sandboxes:connect ; le bouton Connect d'une sandbox en crée une avec ces scopes présélectionnés.
Utiliser la sandbox depuis vos propres outils
Deux portes d'entrée, toutes deux via SailOps et toutes deux auditées :
- Les outils MCP (
sandbox_exec,sandbox_write_file,sandbox_read_file, …) du serveur MCP SailOps àhttps://app.sailops.io/api/mcp. Votre agent local garde son contexte et son éditeur, et exécute dans la sandbox. - SSH via le pont
wss://app.sailops.io/api/ai/v1/sandboxes/<nom>/ssh, que la CLI transforme enProxyCommand. Fonctionne avecssh, Remote-SSH de VS Code et Cursor,rsyncetscp.
Claude Code (et Conductor)
Ce que vous tapez une fois :
sailops-sandbox init
La commande lance claude mcp add --transport http --scope user sailops https://app.sailops.io/api/mcp --header "X-Api-Key: …" et installe la skill ~/.claude/skills/sailops-sandbox/SKILL.md. Conductor fait tourner Claude Code en coulisses, il est donc couvert aussi. Ajoutez cette ligne au CLAUDE.md d'un projet qui doit toujours s'exécuter là-bas :
This project's execution environment is the SailOps sandbox `<name>` (MCP server `sailops`). Run every shell command through the `sandbox_exec` tool and edit files with `sandbox_write_file`; never run commands locally.
Ce que l'agent peut alors faire : lister, créer et démarrer des sandboxes, lancer compilations, tests et commandes git avec sandbox_exec (code de sortie, stdout et stderr reviennent), lire et écrire des fichiers, et arrêter la sandbox à la fin.
Pour lancer Claude Code dans la sandbox (votre poste peut se fermer), avec l'ANTHROPIC_API_KEY de la sandbox :
sailops-sandbox run -- claude # = up + ssh -t sailops-<nom> tmux new -A -s main claude
Codex
sailops-sandbox init
ajoute [mcp_servers.sailops] à ~/.codex/config.toml et une section délimitée à ~/.codex/AGENTS.md. L'équivalent manuel :
[mcp_servers.sailops]
url = "https://app.sailops.io/api/mcp"
http_headers = { "X-Api-Key" = "<votre-clé-api>" }
Mettez la même consigne que ci-dessus dans l'AGENTS.md du projet, ou lancez Codex dans la sandbox avec sailops-sandbox run -- codex.
Dans la sandbox, codex utilise le fournisseur défini par OPENAI_BASE_URL et la clé OPENAI_API_KEY. Avec les Modèles SailOps, le modèle par défaut est gpt-oss-120b avec un raisonnement moyen ; utilisez OPENAI_MODEL ou -m pour en choisir un autre. La recherche web du fournisseur et les espaces de noms multi-agents de Codex sont désactivés, car le fournisseur ne les prend pas en charge. Vos options en ligne de commande peuvent remplacer ces valeurs par défaut. Codex s’appuie sur l’isolation gVisor de la sandbox ; son isolation Linux imbriquée est désactivée dans l’image, car la configuration réseau de bubblewrap est incompatible avec ce runtime. Cela concerne seulement Codex exécuté dans le conteneur distant, pas votre Codex local.
OpenCode
init ajoute mcp.sailops à ~/.config/opencode/opencode.json et une section à ~/.config/opencode/AGENTS.md :
{
"mcp": {
"sailops": { "type": "remote", "url": "https://app.sailops.io/api/mcp", "headers": { "X-Api-Key": "<votre-clé-api>" }, "enabled": true }
}
}
Cursor
init ajoute mcpServers.sailops à ~/.cursor/mcp.json et affiche un lien Add to Cursor (le panneau Connect propose le même bouton). Pour Remote-SSH, ouvrez directement l'espace de travail :
sailops-sandbox up mon-depot && cursor --remote ssh-remote+sailops-mon-depot /home/agent/workspace
VS Code
Avec l'extension Remote - SSH :
sailops-sandbox up mon-depot && code --remote ssh-remote+sailops-mon-depot /home/agent/workspace
up crée la sandbox si besoin, la démarre, autorise votre ~/.ssh/id_ed25519.pub (ou en génère une) et régénère ~/.config/sailops/ssh_config, inclus par ~/.ssh/config. Chaque sandbox du projet y a son bloc Host sailops-<nom>.
Démarrage à la connexion SSH
Après un premier sailops-sandbox up mon-depot pour enregistrer votre clé, connectez-vous directement :
ssh sailops-mon-depot
Si la sandbox est arrêtée, la CLI 0.1.3 la démarre, attend sa disponibilité puis ouvre SSH automatiquement. Un démarrage déjà en cours est attendu. Cela s'applique aussi à scp, rsync et aux connexions IDE utilisant le bloc Host généré. La clé API doit disposer de containers:list, containers:update et sandboxes:connect. Une sandbox absente n'est pas créée par SSH.
Le proxy attend au maximum dix minutes et affiche sa progression uniquement sur stderr. Les blocs Host générés utilisent ConnectTimeout 660 ; relancez sailops-sandbox ssh-config --all après la mise à jour de la CLI. VS Code et Cursor Remote-SSH peuvent remplacer ce délai : réglez remote.SSH.connectTimeout à 660 dans les paramètres de l'IDE pour les démarrages à froid. Les options de ligne de commande OpenSSH sont prioritaires sur le bloc Host. Une connexion websocat directe exige une sandbox déjà démarrée.
rsync et scp
Avec le même bloc Host :
sailops-sandbox sync mon-depot # rsync du répertoire courant vers /home/agent/workspace/mon-depot, en respectant .gitignore
rsync -az --filter=':- .gitignore' ./ sailops-mon-depot:/home/agent/workspace/mon-depot/
scp build.log sailops-mon-depot:/home/agent/workspace/
sync prend en charge le rsync système de macOS et GNU rsync, crée le dossier de destination et conserve les fichiers partiels pour permettre une reprise en relançant la commande. Il préserve les permissions et les liens symboliques et respecte .gitignore ; il ne supprime pas les autres fichiers présents à destination. Privilégiez-le pour les dossiers contenant beaucoup de petits fichiers. Une copie échouée ou interrompue reste incomplète tant qu’un nouveau transfert n’a pas réussi ; scp ne reprend pas automatiquement. Les transferts de fichiers et le presse-papiers Xpra restent désactivés : utilisez les outils SSH pour déplacer des fichiers.
La CLI, et sans elle
| Commande | Effet |
|---|---|
sailops-sandbox init | Stocke la clé, enregistre le serveur MCP dans chaque outil, installe la skill et les consignes, configure SSH |
sailops-sandbox up [nom] | Crée si absente, démarre, attend Running, autorise votre clé SSH, régénère la config SSH |
sailops-sandbox open [nom] | ssh -t sailops-<nom> tmux new -A -s main |
sailops-sandbox run [nom] -- claude | up, puis la commande dans une session tmux |
sailops-sandbox sync [nom] [chemin] | rsync vers l'espace de travail |
sailops-sandbox exec nom -- pnpm test | Une commande, sortie affichée, code de sortie conservé |
sailops-sandbox list, start, stop | Ce que vous attendez |
sailops-sandbox ssh-config nom / --all | Le bloc Host, ou tout le fichier géré |
nom vaut par défaut le nom du dépôt git courant. La CLI est un binaire statique pour macOS et Linux (amd64 et arm64) ; sa configuration est ~/.config/sailops/credentials, ou les variables d'environnement SAILOPS_API_KEY et SAILOPS_API_URL.
Sans la CLI, n'importe quel client WebSocket fait office de ProxyCommand, par exemple websocat :
ssh -o ProxyCommand="websocat --binary wss://app.sailops.io/api/ai/v1/sandboxes/mon-depot/ssh -H 'X-Api-Key: $SAILOPS_API_KEY'" -p 2222 agent@mon-depot
et l'endpoint exec est du simple HTTP : POST /api/public/api/v1/sandboxes/{nom}/exec avec {"command": ["pnpm", "test"]} ou {"shell": "cd mon-depot && pnpm test"}, et en option cwd, env et timeoutSeconds (60 par défaut, 600 au plus).
Notes de sécurité
- SSH par clé uniquement : pas de mot de passe, pas de connexion root, seulement
agent. Les clés se règlent dans les paramètres de la sandbox (panneau Connect, API, ousailops-sandbox up), sont stockées dans le secretSAILOPS_SSH_AUTHORIZED_KEYSdu conteneur et s'appliquent immédiatement à une sandbox en cours d'exécution. - sshd tourne avec l'utilisateur non privilégié
agentsur le port 2222 dans la sandbox ; rien n'est exposé sur Internet. Chaque connexion passe par un port-forward SailOps authentifié par votre clé d'API (scopesandboxes:connect) ou votre session console. - Les clés d'hôte vivent sur le volume de l'espace de travail : l'empreinte reste la même d'un arrêt à l'autre. La CLI les garde dans
~/.config/sailops/known_hosts. - Chaque session SSH, chaque
execet chaque commande MCP est écrite dans l'onglet Activité de la sandbox, avec le texte de la commande pour exec. - Un pont vit au plus 24 heures et se ferme après 30 minutes sans trafic ; 20 sessions par sandbox à la fois. Une session ouverte, comme un terminal ouvert, suspend l'arrêt automatique.
- L'environnement de la sandbox (vos clés LLM,
CLAUDE_CONFIG_DIR, …) est disponible dans les sessions SSH exactement comme dans le terminal du navigateur : à chaque démarrage, le point d'entrée copie l'environnement du conteneur, clés LLM comprises, dans~/.ssh/environment(mode 600, lisible paragentseul). Ce fichier appartient au home persistant et est réécrit à partir des secrets en vigueur à chaque démarrage ; n’y placez pas votre configuration SSH personnelle. sandboxes:execexécute n'importe quelle commande en tant qu'agent: en pratique, il accorde aussi ce que permetsandboxes:connect(une commande peut ajouter une clé SSH). Ne le donnez qu'aux clés à qui vous confieriez SSH. L'outil MCPsandbox_write_filerefuse~/.sshetworkspace/.sailops; les clés SSH se changent dans les paramètres de la sandbox.
Contenu de l'image
L'image ghcr.io/herewecloud/agent-sandbox est publique et reconstruite chaque nuit. Basée sur Ubuntu 24.04, elle contient :
| Domaine | Contenu |
|---|---|
| Utilisateur | agent (UID 1000), sans élévation de privilèges ; l'espace de travail est dans /home/agent/workspace |
| Langages | Node 24 avec pnpm, Python 3.13 avec uv, Go (dernière version stable), Rust (stable, via rustup) |
| Outils | git, git-lfs, gh (GitHub CLI), ripgrep, jq, tmux, sqlite3, rsync, build-essential |
| Agents de code | Claude Code (claude, mise à jour automatique désactivée), Codex (codex), OpenCode (opencode), Pi (pi) |
| SSH | Serveur OpenSSH sur le port 2222, lancé par agent, authentification par clé uniquement |
Les versions exactes installées dans votre sandbox sont listées dans /etc/sailops/agents.json :
cat /etc/sailops/agents.json
Docker n'est pas disponible dans une sandbox. La sandbox tourne sous gVisor, sans élévation de privilèges. Installez vos outils utilisateur dans votre home persistant ; l’installation système avec sudo n’est pas disponible.
Créer une sandbox
- Ouvrez IA › Sandboxes et cliquez sur Nouvelle sandbox.
- Choisissez un nom, la taille de l'espace de travail (10 à 100 Gio, 20 Gio par défaut) et le délai d'inactivité.
- Choisissez une classe de calcul : eco (2 vCPU / 4 Gio par défaut) ou standard (2 vCPU / 8 Gio). Les organisations en période d'essai obtiennent eco avec 1 vCPU / 2 Gio.
- Renseignez éventuellement des clés LLM (voir plus bas) et connectez des bases de données ou services du projet.
- Cliquez sur Créer la sandbox. Le premier démarrage télécharge une image de plusieurs gigaoctets et peut prendre quelques minutes ; les démarrages suivants réutilisent le cache du nœud.
Le preset est appliqué côté serveur : l'image, la commande de démarrage et le montage de l'espace de travail sont imposés, et la sandbox n'a ni port public, ni autoscaling, ni sonde de santé. Vous pouvez ensuite ajuster le CPU, la mémoire ou l'espace de travail depuis l'onglet Général du conteneur.
Depuis un outil, sailops-sandbox up, l'outil MCP sandbox_create et POST /api/public/api/v1/sandboxes en créent une avec les mêmes valeurs par défaut.
Donner une clé LLM aux agents
Les agents ont besoin d'identifiants auprès d'un fournisseur de modèles. Deux possibilités :
- SailOps Models : créez une clé d'API avec le scope
ai-models:invoke, mettez-la dansOPENAI_API_KEYet pointezOPENAI_BASE_URLvers l'endpoint Models. Codex, OpenCode et Pi parlent l'API OpenAI ; Claude Code non, il lui faut donc votre propre clé Anthropic. - Votre propre clé de fournisseur : saisissez-la dans la section Clés LLM à la création de la sandbox, ou plus tard dans l'onglet Environnements du conteneur.
ANTHROPIC_API_KEYest lue par Claude Code,OPENAI_API_KEYetOPENAI_BASE_URLpar les agents compatibles OpenAI. Les clés sont stockées comme variables d'environnement secrètes du conteneur et ne sont jamais renvoyées par l'API.
Tout ce qu'un agent enregistre (~/.claude, ~/.codex, les dépôts clonés avec des jetons dans leurs remotes) se retrouve sur le volume de l'espace de travail. Les abonnements personnels Claude ou ChatGPT ne sont pas un moyen pris en charge de connecter les agents : utilisez une clé d'API. Ce volume est conservé quand la sandbox est arrêtée et copié dans chaque snapshot de volume. Traitez les snapshots comme des données sensibles et supprimez la sandbox quand vous n'en avez plus besoin.
Arrêt automatique
Une sandbox en cours d'exécution est arrêtée automatiquement quand toutes les conditions suivantes sont réunies :
- aucune session de terminal ou SSH n'a été ouverte, aucun
execn'a tourné et aucun démarrage n'a eu lieu depuis plus longtemps que le délai d'inactivité (2 heures par défaut, 30 minutes en période d'essai, réglable entre 15 minutes et 24 heures), et - le CPU de la sandbox est resté sous 2 % de sa limite pendant les 15 dernières minutes.
Le délai correspond à une durée minimale d'inactivité, pas à une heure d'arrêt exacte. Si le surcoût du runtime masque l'activité des applications, SailOps vérifie leur CPU pendant une fenêtre supplémentaire de 15 minutes. Des mesures absentes ou interrompues maintiennent la sandbox active et facturée tant que son inactivité ne peut pas être établie.
Une compilation ou une suite de tests longue maintient la sandbox active même sans rien d'attaché. L'arrêt écrit une ligne dans l'onglet Activité du conteneur, tout comme les sessions de terminal et SSH : leur ouverture et leur fermeture sont auditées.
Le délai d'inactivité se modifie depuis la carte de la sandbox ou par l'API (PUT /api/v1/organizations/{organizationId}/projects/{projectId}/ai/sandboxes/{containerName}/settings, ou PUT /api/public/api/v1/sandboxes/{nom}/settings avec une clé d'API).
Isolation réseau
Un agent exécute du code que vous n'avez pas écrit : chaque sandbox porte donc sa propre politique de sortie, en plus de l'isolation de projet dont bénéficie tout workload. Depuis une sandbox, vous atteignez Internet, les services du même projet et le DNS ; vous n'atteignez ni les pods des autres projets (utilisez un peering de projets pour cela), ni les nœuds du cluster, ni les endpoints de métadonnées du cloud (169.254.169.254, 169.254.42.42). La sandbox tourne aussi sans jeton de compte de service Kubernetes.
La politique se désactive par sandbox avec networkIsolation: false sur le même endpoint de réglages, ce qui ne laisse que l'isolation de projet de la plateforme. C'est prévu pour le cas rare d'un outil qui doit joindre un service local au nœud ; laissez-la active sinon.
Tarification
Une sandbox est facturée comme n'importe quel conteneur : le calcul quand elle tourne, le volume de l'espace de travail en permanence.
| Élément | Prix catalogue |
|---|---|
| eco, 2 vCPU / 4 Gio | environ 0,068 EUR par heure d'exécution (50 EUR par mois si jamais arrêtée) |
| standard, 2 vCPU / 8 Gio | environ 0,183 EUR par heure d'exécution (133,6 EUR par mois) |
| essai eco, 1 vCPU / 2 Gio | environ 0,034 EUR par heure d'exécution |
| Espace de travail, 20 Gio de stockage bloc standard | environ 2,47 EUR par mois, que la sandbox tourne ou non |
Une sandbox arrêtée ne coûte rien au-delà de son espace de travail. Les jetons consommés sont facturés par votre fournisseur de modèles, ou par SailOps Models quand vous l'utilisez.
Conseils
tmuxest installé : lancez les agents dans une session tmux (sailops-sandbox openle fait) pour qu'un terminal fermé ne les interrompe pas. L'arrêt automatique s'applique toujours une fois l'agent terminé et le CPU retombé.- Les snapshots du volume de l'espace de travail servent de points de reprise avant de laisser un agent travailler sur un dépôt.
- Connectez une base de données du projet depuis l'onglet Connexions : ses identifiants sont injectés comme variables d'environnement que les agents peuvent lire, en SSH aussi.
Accès réseau
L'onglet Network choisit les destinations accessibles depuis la sandbox. Par défaut, le workspace peut joindre Internet et uniquement les services privés ajoutés dans Connections. Une connexion crée les identifiants du service et l'autorisation réseau. Sa suppression retire cette autorisation lors de la convergence du provisionnement.
Project network autorise les autres services privés du même projet. Les nouvelles connexions entrantes vers une sandbox isolée restent bloquées ; le terminal, SSH et MCP utilisent leurs ponts authentifiés. Les nœuds, l'API Kubernetes et les métadonnées cloud restent bloqués. Les peerings confirmés conservent leurs propres ports de destination.
Désactivez Allow Internet access pour un workspace hors ligne. Le DNS et la télémétrie de la plateforme restent disponibles, mais les dépôts Git publics, registres de paquets et API de modèles deviennent inaccessibles. Ce réglage ne filtre pas les domaines individuellement.
sailops-sandbox network show mon-repo
sailops-sandbox network set mon-repo --private-access connected-services --internet false
Ces réglages sont aussi exposés dans les paramètres publics : networkAccess.privateAccess (connected-services ou project) et networkAccess.internetAccess, ainsi que par les outils MCP sandbox_network_get et sandbox_network_update. La modification exige containers:update ; la lecture exige containers:list. Le formulaire et ces commandes de modification maintiennent l'isolation supplémentaire de la sandbox activée.
Applications graphiques
Les applications graphiques sont désactivées par défaut sur les nouvelles sandboxes. Activez-les dans Connect → Sandbox software, ou avec le CLI 0.2.1 ou ultérieur :
sailops-sandbox software set ma-sandbox --graphics true
Changer les logiciels redémarre une sandbox active et ferme ses sessions. Les fichiers et identifiants du workspace sont conservés ; une sandbox arrêtée reste arrêtée. L'activation seule ne lance aucune application et ne change pas la classe de calcul. Chromium + Xpra ont utilisé environ 700–800 Mio de RAM en staging et partagent le CPU et la RAM avec vos agents pendant leur exécution. Un affichage connecté maintient le calcul actif et facturé. Le premier téléchargement de l'image graphique peut prendre plusieurs minutes.
Après activation, lancez ces commandes sur votre ordinateur :
# Ouvrir le navigateur Chromium inclus sans installer de client local.
sailops-sandbox app ma-sandbox --browser -- sailops-browser
# Ouvrir un terminal graphique dans une fenêtre native (client Xpra local requis).
sailops-sandbox app ma-sandbox -- xterm
# Ouvrir le bureau Linux léger dans votre navigateur.
sailops-sandbox desktop ma-sandbox --browser
Si Xpra est absent, les commandes natives proposent son installation après confirmation dans un terminal interactif. Tu peux aussi lancer sailops-sandbox install-xpra sans clé API. Sur macOS, le CLI vérifie le téléchargement officiel et installe dans ~/Applications sans sudo ; une application existante n’est jamais remplacée. Sous Linux, il utilise le gestionnaire de paquets de la distribution, qui peut demander une autorisation administrateur. La commande native reprend après installation. Refuse ou utilise --browser pour éviter toute installation locale ; les scripts ne reçoivent jamais de demande interactive d’installation.
Le mode natif nécessite Xpra sur votre ordinateur. Le mode navigateur nécessite uniquement OpenSSH et votre navigateur. Remplacez le programme après -- par une application graphique Linux installée et ses arguments. Les applications réservées à macOS ou Windows ne fonctionnent pas dans cet environnement Linux. L'accélération GPU n'est pas fournie.
Le CLI démarre une sandbox arrêtée, prépare votre clé SSH puis ouvre un tunnel SSH authentifié. Le mode navigateur affiche une URL locale privée et l'ouvre automatiquement. Gardez la commande ouverte ; Ctrl+C déconnecte l'affichage. Fermer le navigateur ferme le tunnel après deux minutes sans affichage connecté. Un clic droit sur le bureau ouvre le menu navigateur et terminal. Ne partagez pas le lien. Aucun port graphique n'est exposé publiquement. La synchronisation du presse-papiers, les transferts de fichiers, l'impression, l'audio et la webcam sont désactivés.
Un affichage connecté maintient le calcul actif et facturé. Après déconnexion, les règles habituelles d'arrêt sur inactivité reprennent. Une session graphique sans client expire également après 15 minutes. Les applications ouvertes ne survivent pas à l'arrêt de la sandbox ; les fichiers du workspace sont conservés.
sailops-sandbox apps ma-sandbox
sailops-sandbox app-attach ma-sandbox --browser IDENTIFIANT_SESSION
sailops-sandbox app-stop ma-sandbox IDENTIFIANT_SESSION
Le navigateur inclus s'exécute avec l'utilisateur agent et s'appuie sur l'isolation gVisor : l'isolation Linux imbriquée de Chromium est incompatible avec ce runtime. Les versions actuelles de Firefox sont incompatibles avec le runtime gVisor de staging. Les anciennes images sandbox n'incluent pas cette fonction : sauvegardez votre travail puis appliquez la mise à jour de l'environnement avant d'utiliser ces commandes.
Choisir les outils préinstallés
Le formulaire de création et Connect → Sandbox software proposent une checklist : Claude Code, Codex, OpenCode et Pi. Les quatre sont cochés par défaut ; vous pouvez choisir un sous-ensemble ou aucun. Git, SSH, tmux, Node.js, Python, Go et Rust restent dans le socle commun. Les outils sélectionnés sont installés depuis un bundle hors ligne géré par SailOps avant le démarrage, sans sudo ni accès Internet, et utilisent du disque temporaire supplémentaire. Leurs réglages et connexions restent dans le workspace persistant.
sailops-sandbox software show ma-sandbox
sailops-sandbox software set ma-sandbox --tools codex,opencode
sailops-sandbox software set ma-sandbox --graphics false --tools none
Les mêmes réglages sont exposés dans software à la création et dans les paramètres sandbox de l'API publique, et dans spec.sandboxSoftware du conteneur côté API utilisateur. MCP fournit sandbox_software_get et sandbox_software_update ; la création accepte graphicsEnabled et preinstalledTools. Les changements de logiciels demandent une approbation dans Bosco car ils peuvent redémarrer la sandbox. Seuls les noms du catalogue sont acceptés ; les commandes d'installation et URL de paquets arbitraires sont refusées.
Home persistant
Tout /home/agent, y compris /home/agent/workspace, partage le volume persistant et son quota existants. Les fichiers .bashrc et .gitconfig, clés SSH privées, historiques du shell, réglages applicatifs et outils installés dans le home survivent aux arrêts, remplacements de pods et changements de logiciels. Au premier démarrage, le home fourni par l’image est initialisé sans écraser les fichiers utilisateur ; ses toolchains occupent une partie du même quota. Les chemins et fichiers du workspace existant sont conservés. Une ancienne sandbox arrêtée reçoit ce montage au prochain démarrage ; cela ne récupère pas des données déjà perdues dans un ancien home éphémère.
Le répertoire géré .sailops/home-v1 du workspace stocke le home : conservez-le. Les snapshots du volume contiennent donc aussi le home, ses identifiants et les données applicatives. Les choix de suppression et de conservation du volume s’appliquent à l’ensemble. Les processus, sessions applicatives ouvertes et modifications système hors de /home/agent ne persistent pas. SailOps réécrit ses fichiers SSH authorized_keys et environment au démarrage à partir des accès et secrets courants ; vos clés privées et autres réglages SSH restent conservés.
Points de restauration
Avant un snapshot manuel, SailOps synchronise les fichiers de la sandbox active, y compris les montages du home et du workspace. Si la sandbox démarre, s’arrête ou ne peut pas synchroniser ses fichiers, la création échoue au lieu de publier un point de restauration non fiable. Suspendez les écritures applicatives ou arrêtez d’abord la sandbox pour obtenir une sauvegarde cohérente de l’application : un point de restauration du système de fichiers ne garantit pas les transactions encore en cours.
La restauration remplace le volume du workspace et son home persistant par le contenu du snapshot. Les fichiers écrits après ce point sont perdus et les applications doivent être relancées. Une sandbox déjà arrêtée reste arrêtée. Les accès SSH autorisés dans SailOps sont réappliqués au démarrage.
Les snapshots planifiés ne sont pas encore disponibles pour les sandboxes : utilisez un snapshot manuel. La sauvegarde et la restauration du volume d’état des agents managés ne sont pas actuellement exposées par ce service.