Concepts

Fonctionnement

À un niveau général, la création d’un template fonctionne comme suit :

Résoudre la source du template, comme une image de base standard, une image existante, un Dockerfile ou un autre template.
Appliquer les instructions du template, comme runCmd, copy, makeDir, setEnvs, et les assistants d’installation de packages.
Si cela est configuré, démarrer la commande de démarrage du template.
Attendre que la commande ready réussisse.
Enregistrer l’environnement préparé comme template réutilisable.

La création produit un templateId / template_id et un buildId / build_id. Utilisez ensuite l’ID du template avec Sandbox.create(...).

Utilisateur et répertoire de travail

Les templates peuvent définir l’utilisateur Linux par défaut et le répertoire de travail utilisés par les étapes de build ultérieures et par l’environnement final. Utilisez setUser(...) / set_user(...) lorsque les commandes de build doivent s’exécuter en tant qu’utilisateur spécifique. Utilisez setWorkdir(...) / set_workdir(...) lorsque les commandes ultérieures et les fichiers copiés doivent être résolus relativement à un répertoire spécifique.

import { Template } from "novita-sandbox"

const template = Template()
  .fromUbuntuImage("24.04")
  .setUser("root")
  .setWorkdir("/app")
  .runCmd("apt-get update && apt-get install -y curl")
  .copy("package.json", "/app/package.json")

from novita_sandbox.core import Template

template = (
    Template()
    .from_ubuntu_image("24.04")
    .set_user("root")
    .set_workdir("/app")
    .run_cmd("apt-get update && apt-get install -y curl")
    .copy("package.json", "/app/package.json")
)

Si vous ne définissez pas ces valeurs, le sandbox utilise les valeurs par défaut de l’image de base sélectionnée.

Mise en cache

Les builds de templates mettent en cache les couches précédemment terminées afin que les builds répétés n’aient pas à réexécuter chaque instruction. C’est généralement ce que vous souhaitez pour itérer rapidement. Lorsque vous avez besoin d’un build entièrement frais, désactivez le cache pour tout le build avec skipCache: true / skip_cache=True, ou marquez la chaîne de templates avec skipCache() / skip_cache().

import { Template } from "novita-sandbox"

const template = Template()
  .fromPythonImage("3.12")
  .skipCache()
  .runCmd("pip install -U pip")

const build = await Template.build(template, "my-template-no-cache", {
  skipCache: true,
})

from novita_sandbox.core import Template

template = (
    Template()
    .from_python_image("3.12")
    .skip_cache()
    .run_cmd("pip install -U pip")
)

build = Template.build(
    template,
    "my-template-no-cache",
    skip_cache=True,
)

Utilisez l’invalidation du cache intentionnellement. Elle ralentit les builds et devrait normalement être réservée aux actualisations de dépendances, au débogage ou aux modifications d’entrées qui ne sont pas visibles depuis la seule définition du template.

Get started

Model APIs

Agent Sandbox

GPUs

Observability

Resources

Fonctionnement

Utilisateur et répertoire de travail

Mise en cache

​Fonctionnement

​Utilisateur et répertoire de travail

​Mise en cache

Fonctionnement

Utilisateur et répertoire de travail

Mise en cache