Vai al contenuto principale
Research esegue i comandi nella sandbox predefinita di Enclave. Quando il tuo team ha bisogno di altri linguaggi, strumenti o di un’altra distribuzione Linux, un Owner o un Admin può creare una sandbox personalizzata da un Dockerfile. Tutti i membri dell’organizzazione possono poi avviare una sessione su di essa.

​
Prima di iniziare

  • Per creare, ricostruire ed eliminare una sandbox serve il permesso di gestire le integrazioni: il ruolo Owner o Admin. Vedi Ruoli e permessi.
  • Le sandbox personalizzate non sono disponibili nei deployment bring-your-own-cloud.

​
Crea una sandbox

1

Chiedi a Research

In una sessione di Research, descrivi ciò che ti serve e assegna un nome. Ad esempio: “Mi serve una sandbox in cui l’agente possa eseguire jq e protoc. Chiamala tools.”
2

Approva il Dockerfile

Research scrive un Dockerfile e mostra una scheda Create the sandbox tools? con l’immagine di base e il Dockerfile. Controllalo e fai clic su Approve.
3

Segui la build

Una scheda di build mostra lo stato (Queued, Building, Testing, Ready, Build failed o Cancelled), il tempo trascorso e il log della build. Fai clic su Cancel per interromperla.
Al termine della build, la sessione riceve il risultato e Research ti dice cosa fare dopo. Se la build non è riuscita, Research spiega il motivo e può proporre un Dockerfile corretto. Ricevi anche una notifica, così lo vieni a sapere da qualsiasi pagina. Una sandbox viene salvata solo quando la sua build va a buon fine. Una build non riuscita o annullata non cambia nulla di ciò che vedono i membri. Per modificare una sandbox, chiedi a Research di aggiornarla indicandone il nome. Research mostra una scheda Update the sandbox. La versione attuale resta in uso finché la nuova build non va a buon fine.

​
Regole per il Dockerfile

  • Il Dockerfile parte da enclave/base, l’immagine della sandbox predefinita di Enclave, a meno che non ti serva un altro sistema operativo. Le altre immagini di base devono provenire da un registry pubblico.
  • Non c’è un build context. COPY e ADD non possono leggere file locali, ma ADD può scaricare un URL http(s) o clonare un repository git.
  • Un Dockerfile può arrivare a 64 KB e 100 istruzioni.
  • Una build può durare fino a 30 minuti.

​
Avvia una sessione su una sandbox

In una nuova sessione, fai clic sul selettore della sandbox nel campo di composizione e scegli una sandbox in Sandbox environment. Enclave default è la sandbox di Enclave. Una sessione mantiene la sua sandbox. Per usarne un’altra, avvia una nuova sessione. Una sandbox in fase di ricostruzione mostra Rebuilding nel selettore. Le nuove sessioni usano la sua ultima build riuscita finché quella nuova non va a buon fine.

​
Gestisci le sandbox

Vai in Settings → Sandboxes per vedere le sandbox della tua organizzazione, il loro stato (Ready o Rebuilding) e quando è stata creata la build in uso. Owner e Admin fanno clic su Manage per vedere il Dockerfile attivo e il log dell’ultima build, e per:
  • Rebuild: ricostruire la sandbox dal suo Dockerfile.
  • Cancel: annullare una build in corso.
  • Delete: eliminare la sandbox. Le sessioni che la usano non possono più riavviare la loro sandbox e ti chiedono di avviare una nuova sessione.
Quando Enclave aggiorna il software delle sue sandbox, una sandbox personalizzata si ricostruisce automaticamente la volta successiva in cui qualcuno avvia una sessione su di essa. Fino ad allora le sessioni usano l’ultima build riuscita.

​
Limiti

  • 3 sandbox per organizzazione. Una nuova sandbox con la prima build in corso conta ai fini del limite.
  • 20 build per organizzazione in un arco di 24 ore. Le ricostruzioni avviate da Enclave dopo un aggiornamento non contano.