Passer au contenu principal
Research exécute les commandes dans la sandbox par défaut d’Enclave. Si votre équipe a besoin d’autres langages, d’autres outils ou d’une autre distribution Linux, un propriétaire ou un administrateur peut créer une sandbox personnalisée à partir d’un Dockerfile. Tous les membres de l’organisation peuvent ensuite lancer une session dessus.

​
Avant de commencer

  • Créer, reconstruire et supprimer une sandbox nécessite l’autorisation de gérer les intégrations : le rôle Owner ou Admin. Consultez Rôles et autorisations.
  • Les sandboxes personnalisées ne sont pas disponibles pour les déploiements bring-your-own-cloud.

​
Créer une sandbox

1

Demandez à Research

Dans une session Research, décrivez ce dont vous avez besoin et donnez-lui un nom. Par exemple : « J’ai besoin d’une sandbox où l’agent peut exécuter jq et protoc. Appelle-la tools. »
2

Approuvez le Dockerfile

Research rédige un Dockerfile et affiche une carte Create the sandbox tools? avec l’image de base et le Dockerfile. Relisez-le et cliquez sur Approve.
3

Suivez la construction

Une carte de construction affiche le statut (Queued, Building, Testing, Ready, Build failed ou Cancelled), le temps écoulé et le journal de construction. Cliquez sur Cancel pour l’arrêter.
À la fin de la construction, la session reçoit le résultat et Research vous indique la marche à suivre. Si la construction a échoué, Research en explique la raison et peut proposer un Dockerfile corrigé. Vous recevez aussi une notification, pour être averti depuis n’importe quelle page. Une sandbox n’est enregistrée que si sa construction réussit. Une construction échouée ou annulée ne change rien pour les membres. Pour modifier une sandbox, demandez à Research de la mettre à jour en la désignant par son nom. Il affiche une carte Update the sandbox. La version actuelle reste utilisée jusqu’à ce que la nouvelle construction réussisse.

​
Règles du Dockerfile

  • Le Dockerfile part de enclave/base, l’image de sandbox par défaut d’Enclave, sauf si vous avez besoin d’un autre système d’exploitation. Les autres images de base doivent provenir d’un registre public.
  • Il n’y a pas de contexte de construction. COPY et ADD ne peuvent pas lire de fichiers locaux, mais ADD peut télécharger une URL http(s) ou cloner un dépôt git.
  • Un Dockerfile peut faire jusqu’à 64 Ko et 100 instructions.
  • Une construction peut durer jusqu’à 30 minutes.

​
Lancer une session sur une sandbox

Dans une nouvelle session, cliquez sur le sélecteur de sandbox dans la zone de saisie et choisissez une sandbox sous Sandbox environment. Enclave default est la sandbox propre à Enclave. Une session conserve sa sandbox. Pour en utiliser une autre, lancez une nouvelle session. Une sandbox en cours de reconstruction affiche Rebuilding dans le sélecteur. Les nouvelles sessions utilisent sa dernière construction réussie jusqu’à ce que la nouvelle réussisse.

​
Gérer les sandboxes

Accédez à Settings → Sandboxes pour voir les sandboxes de votre organisation, leur statut (Ready ou Rebuilding) et la date de la construction utilisée. Les propriétaires et les administrateurs cliquent sur Manage pour voir le Dockerfile en vigueur et le journal de la dernière construction, et pour :
  • Rebuild : reconstruire la sandbox à partir de son Dockerfile.
  • Cancel : annuler une construction en cours.
  • Delete : supprimer la sandbox. Les sessions qui l’utilisent ne peuvent plus redémarrer leur sandbox et vous invitent à lancer une nouvelle session.
Lorsqu’Enclave met à jour le logiciel de ses sandboxes, une sandbox personnalisée se reconstruit automatiquement la prochaine fois que quelqu’un lance une session dessus. D’ici là, les sessions utilisent la dernière construction réussie.

​
Limites

  • 3 sandboxes par organisation. Une nouvelle sandbox dont la première construction est en cours compte dans la limite.
  • 20 constructions par organisation sur toute période de 24 heures. Les reconstructions lancées par Enclave après une mise à jour ne comptent pas.