Zum Hauptinhalt springen
Research führt Befehle in der Standard-Sandbox von Enclave aus. Wenn Ihr Team andere Sprachen, Tools oder eine andere Linux-Distribution benötigt, kann ein Owner oder Admin aus einem Dockerfile eine benutzerdefinierte Sandbox erstellen. Danach kann jeder in der Organisation eine Session darauf starten.

​
Bevor Sie beginnen

  • Zum Erstellen, Neuerstellen und Löschen einer Sandbox benötigen Sie die Berechtigung, Integrationen zu verwalten: die Rolle Owner oder Admin. Siehe Rollen und Berechtigungen.
  • Benutzerdefinierte Sandboxes sind bei Bring-your-own-Cloud-Deployments nicht verfügbar.

​
Sandbox erstellen

1

Research fragen

Beschreiben Sie in einer Research-Session, was Sie benötigen, und geben Sie der Sandbox einen Namen. Zum Beispiel: “I need a sandbox where the agent can run jq and protoc. Call it tools.”
2

Dockerfile genehmigen

Research schreibt ein Dockerfile und zeigt eine Karte Create the sandbox tools? mit dem Base-Image und dem Dockerfile an. Prüfen Sie es und klicken Sie auf Approve.
3

Build verfolgen

Eine Build-Karte zeigt den Status (Queued, Building, Testing, Ready, Build failed oder Cancelled), die verstrichene Zeit und das Build-Log. Klicken Sie auf Cancel, um den Build abzubrechen.
Wenn der Build fertig ist, erhält die Session das Ergebnis, und Research teilt Ihnen die nächsten Schritte mit. Wenn der Build fehlschlägt, erklärt Research den Grund und kann ein korrigiertes Dockerfile vorschlagen. Außerdem erhalten Sie eine Benachrichtigung, sodass Sie es auf jeder Seite erfahren. Eine Sandbox wird nur gespeichert, wenn ihr Build erfolgreich ist. Ein fehlgeschlagener oder abgebrochener Build ändert nichts an dem, was Mitglieder sehen. Um eine Sandbox zu ändern, bitten Sie Research, sie unter ihrem Namen zu aktualisieren. Research zeigt dann eine Karte Update the sandbox an. Die aktuelle Version bleibt in Verwendung, bis der neue Build erfolgreich ist.

​
Regeln für Dockerfiles

  • Das Dockerfile basiert auf enclave/base, dem Standard-Sandbox-Image von Enclave, sofern Sie kein anderes Betriebssystem benötigen. Andere Base-Images müssen aus einer öffentlichen Registry stammen.
  • Es gibt keinen Build-Kontext. COPY und ADD können keine lokalen Dateien lesen, aber ADD kann eine http(s)-URL herunterladen oder ein Git-Repository klonen.
  • Ein Dockerfile darf bis zu 64 KB groß sein und bis zu 100 Anweisungen enthalten.
  • Ein Build kann bis zu 30 Minuten laufen.

​
Session auf einer Sandbox starten

Klicken Sie in einer neuen Session im Eingabefeld auf die Sandbox-Auswahl und wählen Sie unter Sandbox environment eine Sandbox aus. Enclave default ist die eigene Sandbox von Enclave. Eine Session behält ihre Sandbox. Um eine andere zu verwenden, starten Sie eine neue Session. Eine Sandbox, die gerade neu erstellt wird, zeigt in der Auswahl Rebuilding an. Neue Sessions verwenden ihren letzten erfolgreichen Build, bis der neue erfolgreich ist.

​
Sandboxes verwalten

Unter Settings → Sandboxes sehen Sie die Sandboxes Ihrer Organisation, ihren Status (Ready oder Rebuilding) und wann der verwendete Build erstellt wurde. Owner und Admins klicken auf Manage, um das aktuelle Dockerfile und das Log des letzten Builds zu sehen und um:
  • Die Sandbox mit Rebuild aus ihrem Dockerfile neu zu erstellen.
  • Einen laufenden Build mit Cancel abzubrechen.
  • Die Sandbox mit Delete zu löschen. Sessions, die sie verwenden, können ihre Sandbox nicht erneut starten und fordern Sie auf, eine neue Session zu starten.
Wenn Enclave seine Sandbox-Software aktualisiert, wird eine benutzerdefinierte Sandbox automatisch neu erstellt, sobald jemand das nächste Mal eine Session darauf startet. Bis dahin verwenden Sessions den letzten erfolgreichen Build.

​
Limits

  • 3 Sandboxes pro Organisation. Eine neue Sandbox, deren erster Build läuft, zählt zum Limit.
  • 20 Builds pro Organisation innerhalb von 24 Stunden. Neuerstellungen, die Enclave nach einem Update startet, zählen nicht.