Pular para o conteúdo principal
O Research executa comandos no sandbox padrão do Enclave. Quando sua equipe precisa de outras linguagens, outras ferramentas ou outra distribuição Linux, um owner ou admin pode criar um sandbox personalizado a partir de um Dockerfile. Depois disso, todos na organização podem iniciar uma sessão nele.

​
Antes de começar

  • Criar, recriar e excluir um sandbox exige permissão para gerenciar integrações: a função Owner ou Admin. Consulte Funções e permissões.
  • Sandboxes personalizados não estão disponíveis em deployments bring-your-own-cloud.

​
Criar um sandbox

1

Peça ao Research

Em uma sessão do Research, descreva o que você precisa e dê um nome ao sandbox. Por exemplo: “Preciso de um sandbox em que o agente possa executar jq e protoc. Chame-o de tools.”
2

Aprove o Dockerfile

O Research escreve um Dockerfile e mostra um card Create the sandbox tools? com a imagem base e o Dockerfile. Revise e clique em Approve.
3

Acompanhe o build

Um card de build mostra o status (Queued, Building, Testing, Ready, Build failed ou Cancelled), o tempo decorrido e o log do build. Clique em Cancel para interrompê-lo.
Quando o build termina, a sessão recebe o resultado e o Research diz o que fazer em seguida. Se o build falhou, o Research explica o motivo e pode propor um Dockerfile corrigido. Você também recebe uma notificação, então fica sabendo de qualquer página. Um sandbox só é salvo quando o build dele passa. Um build com falha ou cancelado não muda nada do que os membros veem. Para alterar um sandbox, peça ao Research para atualizá-lo pelo nome. Ele mostra um card Update the sandbox. A versão atual continua em uso até que o novo build passe.

​
Regras do Dockerfile

  • O Dockerfile começa a partir de enclave/base, a imagem padrão de sandbox do Enclave, a menos que você precise de outro sistema operacional. Outras imagens base precisam vir de um registro público.
  • Não há contexto de build. COPY e ADD não conseguem ler arquivos locais, mas ADD pode baixar uma URL http(s) ou clonar um repositório git.
  • Um Dockerfile pode ter até 64 KB e 100 instruções.
  • Um build pode durar até 30 minutos.

​
Iniciar uma sessão em um sandbox

Em uma nova sessão, clique no seletor de sandbox no campo de mensagem e escolha um sandbox em Sandbox environment. Enclave default é o sandbox do próprio Enclave. Uma sessão mantém o sandbox dela. Para usar outro, inicie uma nova sessão. Um sandbox que está sendo recriado mostra Rebuilding no seletor. Novas sessões usam o último build bem-sucedido até que o novo passe.

​
Gerenciar sandboxes

Acesse Settings → Sandboxes para ver os sandboxes da sua organização, o status deles (Ready ou Rebuilding) e quando o build em uso foi feito. Owners e admins clicam em Manage para ver o Dockerfile ativo e o log do build mais recente, e para:
  • Rebuild: recriar o sandbox a partir do Dockerfile dele.
  • Cancel: cancelar um build em andamento.
  • Delete: excluir o sandbox. As sessões que o usam não conseguem iniciar o sandbox de novo e pedem que você inicie uma nova sessão.
Quando o Enclave atualiza o software do sandbox, um sandbox personalizado é recriado automaticamente na próxima vez que alguém iniciar uma sessão nele. Até lá, as sessões usam o último build bem-sucedido.

​
Limites

  • 3 sandboxes por organização. Um novo sandbox com o primeiro build em andamento conta para o limite.
  • 20 builds por organização em qualquer período de 24 horas. Builds que o Enclave inicia após uma atualização não contam.