Sandbox'u sonlandırmadan yerel HTTP istemcisini serbest bırakın. İdempotenttir.

Pool kum havuzları için no-op (istemci, pool'un ana bilgisayarına aittir).

Sadece kimliğini kullanarak, her yerden çalışan bir kum havuzuna yeniden bağlanın.

Özel bir kum havuzu (tek bir HF Job) oluşturun ve hazır olana kadar (~7s on cpu-basic) bekleyin.

Her sandbox, tam yalıtılmış bir sanal makinedir; bu nedenle GPU iş yükleri veya güvenilmeyen kod için doğru seçimdir. Bunun yerine birçok ucuz CPU sandbox dağıtmak için SandboxPool kullanın.

İş, sabit 24 saatlik maksimum bir ömürle çalışır; idle_timeout asıl bekçidir — boşta kalan bir kum havuzu, o süreden çok önce kendini kapatır.

Görsel yalnızca /bin/sh gerektirir. Sandbox sunucusu, kullanılabilirse başlangıçta wget/curl ile indirilir, aksi halde her zaman bağlı olan bir sunucu kovasından okunur (bu, soğuk başlatmaya ~2-3 sn ekler, bu nedenle wget/curl dağıtılması hızı korur).

Bu kum havuzunun arka plan süreçlerini listeleyin.

Sandbox.run()(..., background=True) ile başlatılan süreçleri döndürür; birini SandboxProcess.kill() ile durdurabilirsiniz. Yakın zamanda tamamlanan süreçler listede kalır (running=False ve exit_code değerleriyle); sunucu bunların sınırlı bir sayısını tutar, bu yüzden binlerce kısa komut çalıştırmış bir sandbox bunların hepsini listelemez.

Bu kum havuzu içinde çalışan bir sunucuya yönlendiren herkese açık URL.

Dönen URL'ye yapılan istekler, iş içi kum havuzu sunucusu tarafından, kum havuzunda başlattığınız port üzerindeki sunucuya yönlendirilir; bu yönlendirme WebSocket (ws(s)://) yükseltmelerini ve akışlı yanıtları da içerir. Kimlik doğrulama için proxy_headers ile birlikte kullanın.

Sandbox'ın port üzerinde dinlemesi gerektiği:

• Pool / paylaşılan sandbox: bir TCP portuna bağlanamaz (Landlock), bu nedenle $SBX_PROXY_DIR/<port>.sock adresinde bir unix soketi bağlayın (SBX_PROXY_DIR ortam değişkeni her sandbox'ta ayarlanır). Örn. uvicorn app:app --uds $SBX_PROXY_DIR/8000.sock.
• Özel kum havuzu: 127.0.0.1:<port> üzerinde normal bir TCP portu bağlayın. (Portu buradan geçmeden doğrudan iş vekili (job proxy) üzerinden de açabilirsiniz.)

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

Sandbox'ta bir komut çalıştırın ve bekleyin, çıktıyı canlı olarak akışa alın.

background=True ile komut ayrılmış olarak başlatılır ve run, sürecin bitmesini beklemeden hemen bir SandboxProcess döndürür — bu, sunucular ve diğer uzun süreli süreçler için kullanışlıdır. Bunları daha sonra Sandbox.processes() ile listeleyebilir ve SandboxProcess.kill() ile birini durdurabilirsiniz. Akış/yalnızca bekleme seçenekleri (timeout, stdin, on_stdout, on_stderr, check) bu modda geçerli değildir.

Dönüş: background=True olduğunda bir SandboxProcess, aksi halde exit_code, stdout, stderr, duration_ms içeren bir SandboxCommandResult.

Havuzu serbest bırakın. İdempotent.

Oluşturduğumuz bir havuz için bu, tüm ana bilgisayar işlerini (ve dolayısıyla tüm kum havuzlarını) sonlandırır. connect() ile bağlanmış bir tutamaç için yalnızca yerel HTTP istemcileri serbest bırakılır: paylaşılan ana bilgisayarlar diğer istemcilere hizmet verebilir, bu nedenle — Sandbox.connect() gibi — with bloğundan çıkarken onları kapatmamalıdır. Bağlı bir havuzun ana bilgisayarlarını hf sandbox pool delete <id> ile açıkça sonlandırın.

Yalnızca bu tarafından başlatılan hostlar iptal edilir. Etiketler aracılığıyla keşfedilen bir host, başka bir sürecin kum havuzlarını sunabilir; bu nedenle sonlandırılmak yerine serbest bırakılır.

Bir host işi iptal edilemediğinde SandboxError yükseltilir ve hâlâ çalışan işler adlandırılır — bunlar faturalandırmaya devam eder ve keşfedilebilir kalmaları için önbellek girdileri korunur. close(), __exit__ üzerinden zaten uçuşta olan bir istisna ile ulaşıldığında, hata yerine kayıt altına alınır, böylece orijinal hatayı gizleyemez.

Herhangi bir makineden, yerel durum gerektirmeden, kimlik numarası üzerinden çalışan bir havuza yeniden bağlanın.

pool_id etiketli çalışan bir host bulur ve havuzun yapılandırmasını (image/flavor/density/host-idle) o host işinin spec ve env değişkenlerinden yeniden oluşturur; ardından daha fazla sandbox create() etmeye hazır bir SandboxPool döndürür — çalışan hostlara paketler veya hostlar doluysa bir kopya (aynı yapılandırma) başlatır.

Çalışan bir host bulunamazsa SandboxError fırlatılır (bir havuz, tüm hostları gittiğinde — boşta zaman aşımına uğradığında veya öldürüldüğünde — var olmaktan çıkar).

Gerekirse bir ana bilgisayar tahsis ederek tek bir kum havuzu oluşturun.

Boş kapasiteye sahip bir ana makineyi (bu havuzunkini veya iş etiketleri / yerel önbellek yoluyla bulunan sıcak bir ana makineyi) yeniden kullanır, böylece yeni bir ana makine başlatmadan önce create() çağrısı sıcak bir ana makine üzerinde ~bir gidiş-dönüş maliyetiyle gerçekleşir. Dağıtım yapmak için bunu tekrar tekrar çağırın; ilk çağrılarda soğuk başlatmayı önlemek ve ana makineleri önceden sağlamak için warm_up (veya warm) kullanın. Bir ana makine altında dolarsa (başka bir süreç onu doldurduysa) veya önbellekteki bir ana makine yoksa, sandbox başka bir ana makineye (veya yenisine) yeniden yerleştirilir.

num_hosts boş hostun çalıştığından emin olun ve çalışmaya devam etmelerini sağlayın. Havuzun host iş kimliklerini döndürür.

Bir havuzu önceden “oluşturmak” için kullanılır: konaklar havuz etiketini ve yapılandırmasını (ortam değişkenlerinde) taşır, böylece sonraki bir SandboxPool.connect(pool_id) çağrısı (hatta başka bir makineden bile) onları bulur ve soğuk başlatma olmadan kum havuzları oluşturur. Konaklar, öldürülene veya boşta kalana kadar faturalandırmaya devam eder.

Bu havuz için zaten çalışan hostları (iş etiketleri üzerinden bulunan) başlatmadan önce benimser, böylece connect() sonrası bir warm() — veya tekrarlanan bir warm() — canlı hostları çoğaltıp max_hosts sınırını aşmak yerine num_hosts değerine tamamlama yapar.

Arka plan sürecini sonlandırın. İdempotenttir.

Bu çağrının durdurma nedenini döndürür: False, zaten çıkış yapıldığı veya sonlandırıldığı anlamına gelir ve bu bir hata değildir.

setsid() ile ayrışan bir torun, sinyal gönderilen süreç grubundan ayrılır ve bu çağrının ötesinde yaşamaya devam eder. Başlattığı her şeyin ortadan kalktığından emin olmak için kum havuzunu silin.