Aanmaken

Basisimage

Elke template begint vanuit een bronomgeving. De SDK ondersteunt verschillende ingangspunten, afhankelijk van hoeveel controle je nodig hebt.

fromPythonImage(...) / from_python_image(...) voor een standaard Python-runtime
fromUbuntuImage(...) / from_ubuntu_image(...) of fromDebianImage(...) / from_debian_image(...) voor een standaard Linux-basis
fromNodeImage(...) / from_node_image(...) en fromBunImage(...) / from_bun_image(...) voor taalspecifieke bases
fromImage(...) / from_image(...) voor een willekeurig containerimage
fromDockerfile(...) / from_dockerfile(...) wanneer je Dockerfile al de bron van waarheid is
fromBaseImage() / from_base_image() om te starten vanuit de standaardbasis van het platform
fromTemplate(...) / from_template(...) om boven op een andere template te bouwen

fromPythonImage("3.12") en from_python_image("3.12") zijn gelijkwaardig aan starten vanuit:

Dockerfile

FROM python:3.12

Privéregisters

Als je basisimage zich in een privéregister bevindt, geef dan inloggegevens door bij het definiëren van de templatebron. De JS- en Python-SDK’s ondersteunen:

generieke registerinloggegevens met gebruikersnaam en wachtwoord
AWS-registerinloggegevens
GCP-registerinloggegevens
Huawei Cloud-registerinloggegevens

Voorbeeld van een generiek privéregister:

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)

Template definiëren

Met de builder-API kun je de uiteindelijke omgeving rechtstreeks in code samenstellen. Veelvoorkomende definitiestappen zijn onder andere:

runCmd(...) / run_cmd(...) om pakketten te installeren of provisioning-opdrachten uit te voeren
copy(...) om lokale bestanden op te nemen
makeDir(...), remove(...), rename(...), en makeSymlink(...) voor het vormgeven van het bestandssysteem
setEnvs(...) / set_envs(...) voor omgevingsvariabelen
pipInstall(...), npmInstall(...), bunInstall(...), en aptInstall(...) voor pakketconfiguratie
gitClone(...) / git_clone(...) om code in het image op te nemen

Voorbeeld:

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")
)

Start- en ready-opdrachten

Gebruik een startopdracht wanneer de template tijdens het buildresultaat een langlopende service moet opstarten, en gebruik een ready-opdracht om te definiëren wanneer die service als gezond wordt beschouwd. Dit is handig voor webapps, API-servers, achtergrondwerkers en elke template die al geïnitialiseerd moet zijn wanneer een sandbox start.

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",
    )
)

Je kunt readiness ook afzonderlijk configureren met setReadyCmd(...) / set_ready_cmd(...).

Get started

Model APIs

Agent Sandbox

GPUs

Observability

Resources

Basisimage

Privéregisters

Template definiëren

Start- en ready-opdrachten

​Basisimage

​Privéregisters

​Template definiëren

​Start- en ready-opdrachten

Basisimage

Privéregisters

Template definiëren

Start- en ready-opdrachten