← Sandbox SDK / sandbox / 1-0-preview

Životní cyklus sandboxu

Vaše aplikace adresuje sandbox pomocí ID sandboxu. Linuxové prostředí, které spouští příkazy a uchovává lokální soubory, je kontejner. ID může existovat déle než kterýkoli jednotlivý container.

Tento rozdíl je důležitý pro procesy, terminály, soubory a obnovu po zastavení kvůli nečinnosti nebo po nahrazení.

Většina aplikací používá jeden sandbox na uživatele nebo úlohu:

const sandbox = getSandbox(env.Sandbox, "user-123");

const sandbox = getSandbox(env.Sandbox, "user-123");

Stejné ID sandboxu neznamená stejný kontejner. Poté, co se kontejner zastaví nebo je nahrazen, může další práce pro dané ID běžet v novém kontejneru.

getSandbox() se vrátí okamžitě. Sama o sobě kontejner nespustí.

Kontejner se spustí, jakmile ho nějaká operace potřebuje, například exec(), createTerminal(), nebo zápis souboru. První spuštění po nasazení nebo po nečinnosti může trvat déle než volání za tepla. Pokud kontejner ještě není připraven, SDK může vyvolat ContainerUnavailableError. Tato chyba znamená, že operace uvnitř containeru nezačala. Viz Chyby a zotavení.

Dokud je pro dané sandbox ID spuštěný kontejner:

• Procesy a terminály běží dál, dokud neskončí nebo je nezastavíte.
• Místní soubory zůstávají v daném kontejneru k dispozici.
• Pozdější požadavky Workeru mohou volat getProcess nebo getTerminal a pokračovat, pokud to kontejner ještě má daný prostředek.

Podrobnosti procesu: Jak dlouho proces žije. Terminály: Terminály.

Kontejner není trvalý. Cloudflare jej může zastavit po době nečinnosti. Zastavit se může také po chybách, nebo když jej platforma nahradí během běžného provozu (například po některých nasazeních).

Když se to stane:

• Vaše aplikace stále používá stejné ID sandboxu.
• Procesy a terminály ze starého kontejneru zanikly, včetně jejich ID a bufferů živých logů.
• Místní soubory ze starého kontejneru jsou pryč, pokud je vaše aplikace neobnovila (například pomocí záloha nebo připojený bucket).
• Další skutečná práce může spustit nový kontejner pro stejné sandbox ID.
• Handles z předchozího kontejneru selhávají do uzavřeného stavu. getProcess a getTerminal vrátit null když daný prostředek není v aktuálním kontejneru. Tato vyhledávání nespouštějí kontejner jen kvůli zodpovězení dotazu.

Chcete-li v práci pokračovat později, uložte si úloha (co spustit, cwd, env, a libovolný checkpoint aplikace), nejen ID procesu nebo terminálu.

Po zastavení kvůli nečinnosti nebo výměně může další skutečná práce spustit nový kontejner pro stejné sandbox ID. Staré handly procesů a terminálů jsou neplatné. Postupy obnovy: Chyby a zotavení.

keepAlive a sleepAfter mění chování při nečinnosti. Nedrží jednu instanci kontejneru navždy v běhu. Podrobnosti o stabilním API životního cyklu a Možnosti sandboxu (ignoruje možnosti transport a default-session na @next).

Pouze to, co vaše aplikace uchovává (nebo obnovuje), přežije nový kontejner:

• Provádění procesů
• Terminály
• Chyby a zotavení
• Životní cyklus kontejneru
• Stabilní: Životní cyklus sandboxu