Saltar al contenido principal
Research ejecuta comandos en el sandbox predeterminado de Enclave. Cuando tu equipo necesita otros lenguajes, otras herramientas u otra distribución de Linux, alguien con el rol Owner o Admin puede crear un sandbox personalizado a partir de un Dockerfile. Después, cualquier persona de la organización puede iniciar una sesión en él.

​
Antes de empezar

  • Crear, reconstruir y eliminar un sandbox requiere permiso para gestionar integraciones: el rol Owner o Admin. Consulta Roles y permisos.
  • Los sandboxes personalizados no están disponibles en los despliegues bring-your-own-cloud.

​
Crear un sandbox

1

Pídeselo a Research

En una sesión de Research, describe lo que necesitas y ponle un nombre. Por ejemplo: “Necesito un sandbox donde el agente pueda ejecutar jq y protoc. Llámalo tools.”
2

Aprueba el Dockerfile

Research escribe un Dockerfile y muestra una tarjeta Create the sandbox tools? con la imagen base y el Dockerfile. Revísalo y haz clic en Approve.
3

Sigue la compilación

Una tarjeta de compilación muestra el estado (Queued, Building, Testing, Ready, Build failed o Cancelled), el tiempo transcurrido y el log de compilación. Haz clic en Cancel para detenerla.
Cuando termina la compilación, la sesión recibe el resultado y Research te dice qué hacer a continuación. Si la compilación falló, Research explica por qué y puede proponer un Dockerfile corregido. También recibes una notificación, así que te enteras desde cualquier página. Un sandbox solo se guarda cuando su compilación se completa correctamente. Una compilación fallida o cancelada no cambia nada de lo que ven los miembros. Para cambiar un sandbox, pide a Research que lo actualice por su nombre. Research muestra una tarjeta Update the sandbox. La versión actual sigue en uso hasta que la nueva compilación se completa correctamente.

​
Reglas del Dockerfile

  • El Dockerfile parte de enclave/base, la imagen de sandbox predeterminada de Enclave, salvo que necesites otro sistema operativo. Las demás imágenes base deben venir de un registro público.
  • No hay contexto de compilación. COPY y ADD no pueden leer archivos locales, pero ADD puede descargar una URL http(s) o clonar un repositorio git.
  • Un Dockerfile puede tener hasta 64 KB y 100 instrucciones.
  • Una compilación puede durar hasta 30 minutos.

​
Iniciar una sesión en un sandbox

En una sesión nueva, haz clic en el selector de sandbox del editor de mensajes y elige un sandbox en Sandbox environment. Enclave default es el sandbox propio de Enclave. Una sesión conserva su sandbox. Para usar otro, inicia una sesión nueva. Un sandbox que se está reconstruyendo muestra Rebuilding en el selector. Las sesiones nuevas usan su última compilación correcta hasta que la nueva se completa.

​
Gestionar sandboxes

Ve a Settings → Sandboxes para ver los sandboxes de tu organización, su estado (Ready o Rebuilding) y cuándo se hizo la compilación en uso. Quienes tienen el rol Owner o Admin hacen clic en Manage para ver el Dockerfile activo y el log de la última compilación, y para:
  • Rebuild: reconstruir el sandbox a partir de su Dockerfile.
  • Cancel: cancelar una compilación en curso.
  • Delete: eliminar el sandbox. Las sesiones que lo usan no pueden volver a iniciar su sandbox y te piden que inicies una sesión nueva.
Cuando Enclave actualiza el software de su sandbox, un sandbox personalizado se reconstruye automáticamente la próxima vez que alguien inicia una sesión en él. Hasta entonces, las sesiones usan la última compilación correcta.

​
Límites

  • 3 sandboxes por organización. Un sandbox nuevo cuya primera compilación está en curso cuenta para el límite.
  • 20 compilaciones por organización en cualquier periodo de 24 horas. Las reconstrucciones que inicia Enclave después de una actualización no cuentan.