Polski
Zacznij

Agent Sandboxes Zapisz sandbox jako szablon

Szablony: zainstaluj raz, uruchamiaj z nich każdy sandbox

Zainstaluj to, czego potrzebuje twoja praca, raz, w sandboxie, ręcznie albo rękami agenta. Zapisz dysk sandboxa jako szablon, a każdy nowy sandbox wystartuje ze wszystkim na miejscu: pakietami, plikami, obrazami Dockera.

Nasz: base

Każdy sandbox startuje z szablonu. Nasz to base: Ubuntu 24.04 z build-essential, git, curl, wget, ripgrep i jq; Python 3 z pip i venv; Node.js 22; Claude Code, Codex i OpenCode z ich SDK; Docker z Compose i Buildx; i pulpit 1280×800 z Google Chrome. Pracujesz jako user, z sudo bez hasła. Jego główny system plików jest tylko do odczytu i czytany prosto z dysku serwera, więc to, czego sandbox nie uruchamia, nie zajmuje mu pamięci, a ani pulpit, ani Docker nie startują, dopóki coś ich nie potrzebuje.

Każda wersja base jest nazwana sha256 tego, co zawiera: systemu operacyjnego, jego pakietów i jądra gościa. Nową budujemy co miesiąc, a od razu przy poprawce bezpieczeństwa Chrome, jądra albo pakietów. Nowe sandboxy startują z najnowszej; sandbox i zapisany z niego szablon zostają przy bazie, z której sandbox wystartował.

Własne szablony, zapisane z sandboxa

Własny szablon to dysk sandboxa zapisany na naszej bazie. Przygotuj sandbox, ręcznie albo rękami agenta, a potem create_template zapisze jego dysk jako następną wersję nazwy: my-app@1, potem my-app@2. Zapisuje tylko pliki: bez pamięci, bez działających procesów i bez historii poleceń sandboxa ani rozmów agentów, bez których nowe sandboxy startują.

Wywołanie odpowiada w 28–49 ms wersją w stanie SAVING. Działający sandbox działa dalej, z przerwą na kilka milisekund, gdy zapisujemy jego dysk. Potem serwer sprawdza system plików i zmniejsza go do tego, co zawiera, w osobnej pomocniczej maszynie wirtualnej, i wysyła do magazynu obiektów tylko twoje fragmenty, skompresowane i zaszyfrowane kluczem tylko dla tej wersji. Wersja małego sandboxa jest READY 0,9–1,5 s po wywołaniu; w ogólności trwa to ok. 5 s plus 10 s na każdy GiB twoich własnych danych. Wersja READY podaje swój min_size, najmniejszy rozmiar, którego dysk zmieści to, co zapisała.

Uruchamianie z niego sandboxów

Podaj szablon przy tworzeniu sandboxa: my-app bierze jego najnowszą wersję READY, my-app@3 dokładnie tę. Każdy serwer uruchamia sandboxy z każdej wersji. Panel najpierw pyta serwery, które już mają tę wersję, i tam utworzenie trwa 218–225 ms. Serwer, który jej nie ma, pobiera ją raz, ok. 10 s na każdy GiB wersji, i trzyma ją na następny raz. Sandbox z szablonu może mieć dowolny rozmiar od min_size wersji w górę.

Obrazy Dockera leżą na dysku sandboxa, więc szablon je przenosi: sandbox z niego uruchamia docker run na obrazie, którego nigdy nie pobierał. (Czasy zmierzono przez panel oddalony o 16 ms od serwera).

import time

from pethost.sandboxes import Sandboxes

sandboxes = Sandboxes()  # czyta PETHOST_TOKEN
sandbox = sandboxes.create_sandbox()  # z base
sandboxes.run_command(
    sandbox.sandbox_id,
    command="python3 -m venv ~/venv && ~/venv/bin/pip install pandas && docker pull postgres:18",
)

version = sandboxes.create_template("my-app", sandbox_id=sandbox.sandbox_id)
name = f"my-app@{version.version}"
while sandboxes.get_template(name).state.name == "SAVING":
    time.sleep(1)

copy = sandboxes.create_sandbox(name)  # pandas i obraz postgres są na miejscu
print(sandboxes.run_command(copy.sandbox_id, command="docker images postgres").stdout)
pethost sandbox template save api-dev my-app   # jego dysk jako następna wersja my-app
pethost sandbox template show my-app           # SAVING, potem READY
pethost sandbox new --template my-app          # nowy sandbox z najnowszej wersji

Wersje, miejsce i cena

Nazwa mieści do 10 wersji. Przestrzeń robocza zapisuje jedną wersję naraz, a wszystkie jej wersje razem mieszczą się w miejscu na szablony z jej planu, liczonym jako to, co zajmują w magazynie obiektów, po kompresji:

PlanMiejsce na szablony
20 $ miesięcznie5 GiB
100 $ miesięcznie30 GiB
500 $ miesięcznie175 GiB
2000 $ miesięcznie800 GiB

Szablony nic nie kosztują poza tym miejscem. Usunięcie szablonu, czyli każdej wersji jego nazwy, od razu zwalnia jego miejsce, a sandboxy z niego utworzone dalej działają, wstrzymują się, zatrzymują i wznawiają: magazyn obiektów trzyma wersję, dopóki nie zostanie usunięty ostatni z nich.

Czego szablony jeszcze nie robią

Nie ma jeszcze budowania z Dockerfile: zainstaluj wszystko w sandboxie i zapisz go, jak wyżej. Szablon przenosi pliki, nigdy działające procesy. Żeby skopiować sandbox z pamięcią i procesami, z działającym serwerem deweloperskim albo agentem w połowie zadania, zrób jego fork. Każdy sandbox, z szablonu czy nie, to osobna microVM Firecracker z własnym jądrem. Przewodnik po szablonach ma każde wywołanie i pole.

Jak to wypada na tle innych

21 listopada 2026 E2B budowało szablony swoim kreatorem szablonów, a Daytona robiła snapshoty z obrazu albo z Dockerfile, czego Pethost jeszcze nie robi. boat.dev zapisuje snapshoty i liczy 0,056 $ za snapshot dziennie ponad te zawarte w planie. Szablon w Pethost nic nie kosztuje w ramach miejsca w twoim planie.

Przeczytaj dokumentację

Pytania

Czy mogę zbudować szablon sandboxa z Dockerfile?

Jeszcze nie. Uruchom sandbox z base, wykonaj w nim kroki swojego Dockerfile jako polecenia i zapisz go. Możesz też uruchomić docker build w sandboxie: zbudowany obraz leży na dysku sandboxa, a szablon go przeniesie.

Ile kosztuje szablon?

Nic. Jego wersje liczą się do miejsca na szablony w twoim planie, 5 GiB w planie za 20 $, mierzonego tak, jak są przechowywane, po kompresji.

Czy szablon zachowuje działające procesy?

Nie, zachowuje pliki. Sandbox z pamięcią i działającymi procesami kopiuje fork.

Jak szybko sandbox startuje z szablonu?

W 218–225 ms na serwerze, który ma tę wersję. Pierwszy start na serwerze, który jej nie ma, najpierw ją pobiera, ok. 10 s na każdy GiB, który zawiera.

Powiązane

Daj swojemu agentowi komputer w 0,15 s

Zacznij darmowy okres próbny