Lepaskan klien HTTP lokal tanpa mengakhiri sandbox. Idempoten.

Tidak ada efek untuk sandbox pool (klien milik host pool).

Lampirkan kembali ke sandbox yang sedang berjalan dari mana saja, hanya menggunakan id-nya.

Buat sandbox khusus (satu HF Job) dan blokir hingga siap (~7 detik di cpu-basic).

Setiap sandbox adalah VM terisolasi penuh, sehingga ini adalah pilihan yang tepat untuk workload GPU atau kode yang tidak tepercaya. Untuk mendistribusikan banyak sandbox CPU yang murah, gunakan SandboxPool sebagai gantinya.

Job berjalan dengan masa hidup maksimum tetap 24 jam; idle_timeout adalah penjaga yang sebenarnya — sandbox yang idle akan mematikan dirinya sendiri jauh sebelum batas waktu tersebut.

Gambar hanya membutuhkan /bin/sh. Server sandbox diunduh saat startup dengan wget/curl jika tersedia, jika tidak, dibaca dari bucket server yang selalu dimount (yang menambahkan ~2-3 detik ke cold start, sehingga menyertakan wget/curl menjaganya tetap cepat).

Daftarkan proses latar belakang dari sandbox ini.

Mengembalikan proses yang dimulai dengan Sandbox.run()(..., background=True); hentikan salah satunya dengan SandboxProcess.kill(). Proses yang baru saja selesai tetap terdaftar (dengan running=False dan exit_code mereka); server mempertahankan jumlah terbatas dari proses tersebut, sehingga sandbox yang telah menjalankan ribuan perintah singkat tidak akan mendaftar semuanya.

URL publik yang memproksikan ke server yang berjalan di dalam sandbox ini.

Permintaan ke URL yang dikembalikan diteruskan oleh server sandbox dalam-jobs ke server yang Anda mulai di sandbox pada port, termasuk upgrade WebSocket (ws(s)://) dan respons yang di-stream. Gunakan bersama proxy_headers untuk autentikasi.

Bagaimana sandbox harus mendengarkan di port:

• Pool / sandbox bersama: tidak dapat mengikat port TCP (Landlock), jadi ikat unix socket di $SBX_PROXY_DIR/<port>.sock (variabel lingkungan SBX_PROXY_DIR diatur di setiap sandbox). Contoh: uvicorn app:app --uds $SBX_PROXY_DIR/8000.sock.
• Sandbox khusus: bind port TCP biasa di 127.0.0.1:<port>. (Anda juga dapat mengekspos port secara langsung melalui job proxy tanpa melalui sini.)

>>> url = sandbox.proxy_url_for(8000, "/ws", scheme="wss://")
>>> import websockets
>>> async with websockets.connect(url, additional_headers=sandbox.proxy_headers) as ws:
...     await ws.send("hello")

Jalankan perintah di sandbox dan tunggu hingga selesai, dengan streaming output secara langsung.

Dengan background=True, perintah dimulai secara terputus dan run langsung mengembalikan SandboxProcess tanpa menunggu proses selesai — berguna untuk server dan proses jangka panjang lainnya. Anda dapat melihat daftarnya kemudian dengan Sandbox.processes() dan menghentikan salah satunya dengan SandboxProcess.kill(). Opsi streaming/hanya-menunggu (timeout, stdin, on_stdout, on_stderr, check) tidak berlaku dalam mode tersebut.

Mengembalikan: SandboxCommandResult (dengan exit_code, stdout, stderr, duration_ms), atau SandboxProcess ketika background=True.

Lepaskan pool. Idempoten.

Untuk pool yang kami buat, ini mengakhiri semua pekerjaan host (dan dengan demikian semua sandbox mereka). Untuk handle yang terhubung melalui connect(), ini hanya melepaskan klien HTTP lokal: host bersama mungkin masih melayani klien lain, jadi — seperti Sandbox.connect() — keluar dari blok with tidak boleh menghancurkannya. Akhiri host dari pool yang terhubung secara eksplisit dengan hf sandbox pool delete <id>.

Hanya host yang menangani proses yang dimulai yang dibatalkan. Host yang ditemukan melalui label mungkin masih melayani sandbox dari proses lain, sehingga dilepaskan, bukan diakhiri.

Membuang SandboxError jika pekerjaan host tidak dapat dibatalkan, dengan menyebutkan pekerjaan yang masih berjalan — mereka tetap ditagih, dan entri cache mereka dipertahankan agar tetap dapat ditemukan. Ketika close() dicapai melalui __exit__ dengan pengecualian yang sudah terjadi, kegagalan tersebut dicatat ke log, sehingga tidak dapat menutupi error asli.

Lampirkan kembali ke pool yang sedang berjalan berdasarkan id, dari mesin mana pun — tidak memerlukan status lokal.

Mencari host yang sedang berjalan dengan label pool_id dan membangun ulang konfigurasi pool (image/flavor/density/host-idle) dari spesifikasi dan variabel lingkungan job host tersebut, mengembalikan SandboxPool yang siap untuk create() lebih banyak sandbox — mengemas ke host yang sedang berjalan, atau memulai duplikat (konfigurasi sama) jika mereka penuh.

Membuang SandboxError jika tidak ada host yang sedang berjalan (pool berhenti ada begitu semua hostnya hilang — karena idle-timed-out atau dihentikan).

Buat satu sandbox, dengan menyediakan host jika diperlukan.

Memanfaatkan ulang host dengan kapasitas kosong (dari pool ini, atau host hangat yang ditemukan melalui label job / cache lokal) sebelum memulai host baru, sehingga create() terhadap host hangat hanya memakan waktu sekitar satu round-trip. Panggil berulang kali untuk fan out; gunakan warm_up (atau warm) untuk menyediakan host terlebih dahulu dan menghindari cold start pada panggilan pertama. Jika host terisi penuh di bawah kami (proses lain memakainya) atau host yang di-cache sudah hilang, sandbox akan ditempatkan ulang di host lain (atau host baru).

Pastikan num_hosts host kosong sedang berjalan dan biarkan tetap berjalan. Mengembalikan id pekerjaan host dari pool.

Digunakan untuk “membuat” pool di awal: host membawa label dan konfigurasi pool (di variabel lingkungan mereka), sehingga SandboxPool.connect(pool_id) yang kemudian (bahkan dari mesin lain) dapat menemukannya dan memunculkan sandbox tanpa cold start. Host terus menagih biaya hingga dihentikan atau tidak aktif.

Mengadopsi host yang sudah berjalan untuk pool ini (ditemukan melalui label job) sebelum booting, sehingga warm() setelah connect() — atau warm() yang diulang — akan menambah hingga num_hosts alih-alih menduplikasi host yang aktif dan melampaui max_hosts.

Akhiri proses latar belakang. Idempoten.

Mengembalikan apakah panggilan ini yang menghentikannya: False berarti proses tersebut sudah keluar atau dihentikan, yang bukan merupakan kesalahan.

Perhatikan bahwa keturunan yang melepaskan diri dengan setsid() akan keluar dari grup proses yang diberi sinyal dan bertahan setelah panggilan ini. Hapus sandbox untuk memastikan bahwa semua yang dimulainya telah hilang.