Deutsch
Loslegen

Agent Sandboxes Volumes, die Sandboxes überdauern

Volumes: eine Disk, die ihre Sandboxes überdauert

Manche Daten sollen eine Sandbox überdauern oder von vielen gelesen werden: ein Datensatz, ein Paket-Cache, die Gewichte eines Modells. Ein Volume hält sie: eine Disk außerhalb jeder Sandbox, beim Erstellen einer Sandbox unter einem Pfad gemountet und behalten, wenn die Sandbox gelöscht wird.

Wie Volumes für Sandboxes funktionieren

Ein Volume ist eine Disk mit 1 bis 1.000 GiB auf einem unserer Server, ein Sparse-Image mit ext4 außerhalb jeder Sandbox. Du erstellst eins mit create_volume und mountest es beim Erstellen einer Sandbox unter einem absoluten Pfad wie /data. Eine Sandbox mountet bis zu 4 Volumes und läuft auf dem Server, der sie hält.

Eine Sandbox mountet ein Volume mit Schreibzugriff, oder beliebig viele Sandboxes mounten es nur lesbar, nie beides zugleich. Eine Sandbox behält ihren Mount, bis sie gelöscht wird: Pausieren oder Stoppen behält den Mount. Um ein Volume von der Sandbox, die es gefüllt hat, an seine Leser zu übergeben, lösch also die schreibende und erstell dann die lesenden mit Mounts, die nur lesen. Ein Fork einer Sandbox, die Volumes nur lesbar mountet, mountet sie auch.

Wird eine Sandbox gelöscht, bleibt das Volume mit seinen Dateien, und die nächste Sandbox, die es mountet, findet sie, wie sie hinterlassen wurden. Jedes Volume meldet die Bytes, die es belegt, und die Sandboxes, die es mounten, und sein Löschen wird abgelehnt, solange eine Sandbox es mountet. Die Anleitung zu Volumes hat jeden Aufruf und jedes Feld.

from pethost.sandboxes import Mount, Sandboxes

sandboxes = Sandboxes()  # liest PETHOST_TOKEN
volume = sandboxes.create_volume("datasets", size_gib=50)

writer = sandboxes.create_sandbox(mounts=[Mount(volume_id=volume.volume_id, path="/data")])
sandboxes.run_command(writer.sandbox_id, command="seq 1 1000000 > /data/numbers.txt")
sandboxes.delete_sandbox(writer.sandbox_id)  # das Volume bleibt

readers = [
    sandboxes.create_sandbox(mounts=[Mount(volume_id=volume.volume_id, path="/data", read_only=True)])
    for _ in range(3)
]
print(sandboxes.run_command(readers[0].sandbox_id, command="wc -l /data/numbers.txt").stdout)
# 1000000 /data/numbers.txt
vol=$(pethost sandbox volume new datasets --size 50)
pethost sandbox new --name writer --mount "$vol:/data"
pethost sandbox run writer -- 'seq 1 1000000 > /data/numbers.txt'
pethost sandbox rm writer -y                 # das Volume bleibt
pethost sandbox new --mount "$vol:/data:ro"  # eine lesende

Was du wissen solltest, bevor du dich auf ein Volume verlässt

Ein Volume liegt auf der Disk eines Servers und wird nirgendwohin kopiert. Geht dieser Server verloren, geht das Volume mit ihm verloren, und die Sandboxes, die es gemountet haben, verlieren es auch. Bewahre eine Kopie von allem, was du nicht verlieren darfst, woanders auf. Die eigene Disk einer Sandbox dagegen wird eine Minute nach ihrem Stopp in den Objektspeicher kopiert.

Ein Volume bindet seine Sandboxes außerdem an seinen Server. Eine gestoppte Sandbox, die eins mountet, startet nur dort wieder, während eine Sandbox ohne Volumes auf einem anderen Server mit Platz starten kann. Ein Fork wird abgelehnt, solange die Sandbox ein Volume mit Schreibzugriff mountet. Ein Volume lässt sich noch nicht vergrößern oder in eine laufende Sandbox mounten, und eines, das größer ist als die halbe Disk eines Servers, wird abgelehnt. Hat eine schreibende Sandbox geendet, ohne es auszuhängen, weil sie abgestürzt ist oder pausiert gelöscht wurde, mounte das Volume einmal mit Schreibzugriff, was sein Journal nachspielt, bevor du es nur lesbar mountest.

Ein Volume bringt keine zusätzliche Disk-Geschwindigkeit. Die Volumes einer Sandbox teilen sich die Disk-Rate ihrer Größe mit ihrer eigenen Disk: 64 MiB/s und 1.500 Operationen pro Sekunde pro vCPU, also 128 MiB/s und 3.000 bei SMALL.

Was ein Volume kostet

Ein Volume wird nach seiner ganzen Größe abgerechnet, genutzt oder nicht, zu 0,20 $ pro GiB und Monat, pro Sekunde gezählt. Dein Tarif begrenzt die GiB, die deine Volumes zusammen haben:

TarifVolumes, alle zusammen
Die Testphase10 GiB
20 $ im Monat100 GiB
100 $ im Monat600 GiB
500 $ im Monat3.500 GiB
2.000 $ im Monat16.000 GiB

Für Dateien, die zu einer Sandbox gehören, kostet ihre eigene Disk weniger: Eine gestoppte Sandbox zahlt 0,03 $ pro GiB und Monat der Daten, die sie hält, und eine Vorlage bringt Dateien kostenlos in neue Sandboxes, im Platz für Vorlagen deines Tarifs. Ein Fork kopiert die eigene Disk einer Sandbox samt RAM; ein Volume wird nie kopiert.

Im Vergleich

Volumes kosten bei Pethost mehr als bei den Anbietern, die wir am 21. November 2026 gelesen haben. Modal berechnete 0,09 $ pro GiB und Monat, Blaxel 0,12 $ pro GB, und bei Daytona waren Volumes kostenlos enthalten, bis zu 100 pro Organisation; die Volumes von E2B waren in einer privaten Beta. Nutze ein Volume, wo mehrere Sandboxes dieselben Daten lesen oder wo Daten die Sandbox überdauern müssen, die sie erzeugt hat; behalte den Rest auf der eigenen Disk einer Sandbox.

Doku lesen

Fragen

Wird ein Volume einer Sandbox gesichert?

Nein. Es liegt auf der Disk eines Servers und wird nicht kopiert. Bewahre eine Kopie von dem, was du nicht verlieren darfst, woanders auf. Die eigene Disk einer gestoppten Sandbox wird in den Objektspeicher kopiert.

Können zwei Sandboxes auf ein Volume schreiben?

Nicht gleichzeitig. Eine Sandbox mountet es mit Schreibzugriff, oder beliebig viele mounten es nur lesbar, und eine Sandbox behält ihren Mount, bis sie gelöscht wird.

Kann ich ein Volume in eine laufende Sandbox mounten?

Noch nicht. Mounts werden beim Erstellen einer Sandbox festgelegt, bis zu 4.

Was kostet ein Volume?

0,20 $ pro GiB und Monat seiner ganzen Größe, genutzt oder nicht, pro Sekunde gezählt.

Verwandte Funktionen

Gib deinem Agenten einen Computer in 0,15 s

Kostenlose Testphase starten