Creación

Imagen base

Cada plantilla parte de un entorno de origen. El SDK admite varios puntos de entrada según el nivel de control que necesites.

fromPythonImage(...) / from_python_image(...) para un runtime estándar de Python
fromUbuntuImage(...) / from_ubuntu_image(...) o fromDebianImage(...) / from_debian_image(...) para una base estándar de Linux
fromNodeImage(...) / from_node_image(...) y fromBunImage(...) / from_bun_image(...) para bases específicas de lenguaje
fromImage(...) / from_image(...) para una imagen de contenedor arbitraria
fromDockerfile(...) / from_dockerfile(...) cuando tu Dockerfile ya es la fuente de referencia
fromBaseImage() / from_base_image() para empezar desde la base predeterminada de la plataforma
fromTemplate(...) / from_template(...) para crear una capa sobre otra plantilla

fromPythonImage("3.12") y from_python_image("3.12") equivalen a empezar desde:

Dockerfile

FROM python:3.12

Registros privados

Si tu imagen base reside en un registro privado, pasa las credenciales al definir el origen de la plantilla. Los SDK de JS y Python admiten:

credenciales genéricas de registro con nombre de usuario y contraseña
credenciales de registro de AWS
credenciales de registro de GCP
credenciales de registro de Huawei Cloud

Ejemplo de registro privado genérico:

import { Template } from "novita-sandbox"

const template = Template().fromRegistry(
  "registry.example.com/team/myimage:latest",
  {
    username: process.env.REGISTRY_USERNAME,
    password: process.env.REGISTRY_PASSWORD,
  }
)

const build = await Template.build(template, "my-private-image-template")
console.log(build.templateId)

import os

from novita_sandbox.core import Template

template = Template().from_registry(
    "registry.example.com/team/myimage:latest",
    username=os.environ.get("REGISTRY_USERNAME"),
    password=os.environ.get("REGISTRY_PASSWORD"),
)

build = Template.build(template, "my-private-image-template")
print(build.template_id)

Definición de la plantilla

La API del builder te permite componer el entorno final directamente en código. Los pasos habituales de definición incluyen:

runCmd(...) / run_cmd(...) para instalar paquetes o ejecutar comandos de aprovisionamiento
copy(...) para incluir archivos locales
makeDir(...), remove(...), rename(...) y makeSymlink(...) para dar forma al sistema de archivos
setEnvs(...) / set_envs(...) para variables de entorno
pipInstall(...), npmInstall(...), bunInstall(...) y aptInstall(...) para la configuración de paquetes
gitClone(...) / git_clone(...) para incorporar código en la imagen

Ejemplo:

import { Template } from "novita-sandbox"

const template = Template()
  .fromPythonImage("3.12")
  .setWorkdir("/app")
  .setEnvs({
    APP_ENV: "production",
    PORT: "8000",
  })
  .runCmd("pip install fastapi uvicorn")
  .copy("app.py", "/app/app.py")

from novita_sandbox.core import Template

template = (
    Template()
    .from_python_image("3.12")
    .set_workdir("/app")
    .set_envs(
        {
            "APP_ENV": "production",
            "PORT": "8000",
        }
    )
    .run_cmd("pip install fastapi uvicorn")
    .copy("app.py", "/app/app.py")
)

Comandos de inicio y de preparación

Usa un comando de inicio cuando la plantilla deba arrancar un servicio de larga duración durante el resultado de la compilación, y usa un comando de preparación para definir cuándo se considera que ese servicio está en buen estado. Esto resulta útil para apps web, servidores de API, workers en segundo plano y cualquier plantilla que deba estar ya inicializada cuando se inicia un sandbox.

import { Template } from "novita-sandbox"

const template = Template()
  .fromPythonImage("3.12")
  .runCmd("pip install fastapi uvicorn")
  .copy("app.py", "/home/user/app.py")
  .setStartCmd(
    "uvicorn app:app --host 0.0.0.0 --port 8000",
    "python - <<'PY'\nimport urllib.request\nurllib.request.urlopen('http://127.0.0.1:8000', timeout=2)\nPY"
  )

from novita_sandbox.core import Template

template = (
    Template()
    .from_python_image("3.12")
    .run_cmd("pip install fastapi uvicorn")
    .copy("app.py", "/home/user/app.py")
    .set_start_cmd(
        "uvicorn app:app --host 0.0.0.0 --port 8000",
        "python - <<'PY'\nimport urllib.request\nurllib.request.urlopen('http://127.0.0.1:8000', timeout=2)\nPY",
    )
)

También puedes configurar la preparación por separado con setReadyCmd(...) / set_ready_cmd(...).

Get started

Model APIs

Agent Sandbox

GPUs

Observability

Resources

Imagen base

Registros privados

Definición de la plantilla

Comandos de inicio y de preparación

​Imagen base

​Registros privados

​Definición de la plantilla

​Comandos de inicio y de preparación

Imagen base

Registros privados

Definición de la plantilla

Comandos de inicio y de preparación