← Sandbox SDK / sandbox / 1-0-preview / api

Chyby

Třídy a kódy chyb vracené verzí Sandbox SDK 1.0 preview, se stručnými doporučenými kroky. Úplné postupy obnovy najdete v Chyby a zotavení.

Operace vyvolávají výjimky, které můžete zachytit. Upřednostněte instanceof u tříd z @cloudflare/sandbox. Použijte code a context pro metriky a stabilní přístup k polím.

import {
	ContainerUnavailableError,
	OperationInterruptedError,
	RPCTransportError,
} from "@cloudflare/sandbox";

try {
	await sandbox.exec(["npm", "test"], { cwd: "/workspace/app" });
} catch (error) {
	if (error instanceof ContainerUnavailableError) {
		// error.code === "CONTAINER_UNAVAILABLE"
		// error.context.reason, error.context.retryAfterMs
	}
	if (error instanceof OperationInterruptedError) {
		// Convenience getters: error.reason, error.retryable, error.operationName
		// admitted is only on context: error.context.admitted
	}
	if (error instanceof RPCTransportError) {
		// Convenience getters: error.kind, error.originalMessage
	}
}

import {
	ContainerUnavailableError,
	OperationInterruptedError,
	RPCTransportError,
} from "@cloudflare/sandbox";

try {
	await sandbox.exec(["npm", "test"], { cwd: "/workspace/app" });
} catch (error) {
	if (error instanceof ContainerUnavailableError) {
		// error.code === "CONTAINER_UNAVAILABLE"
		// error.context.reason, error.context.retryAfterMs
	}
	if (error instanceof OperationInterruptedError) {
		// Convenience getters: error.reason, error.retryable, error.operationName
		// admitted is only on context: error.context.admitted
	}
	if (error instanceof RPCTransportError) {
		// Convenience getters: error.kind, error.originalMessage
	}
}

Běžné chyby životního cyklu, procesů, terminálu a zálohování jsou dostupné přímo z kořene balíčku:

import {
	ContainerUnavailableError,
	OperationInterruptedError,
	RPCTransportError,
	StaleProcessHandleError,
	// ...
} from "@cloudflare/sandbox";

import {
	ContainerUnavailableError,
	OperationInterruptedError,
	RPCTransportError,
	StaleProcessHandleError,
	// ...
} from "@cloudflare/sandbox";

Celý modul také exportuje ErrorCode, SandboxError, createErrorFromResponse, a další doménové chyby (soubory, porty, interpret, připojené svazky a související typy kontextu):

import {
	ErrorCode,
	SandboxError,
	createErrorFromResponse,
	FileNotFoundError,
	// ...
} from "@cloudflare/sandbox/errors";

import {
	ErrorCode,
	SandboxError,
	createErrorFromResponse,
	FileNotFoundError,
	// ...
} from "@cloudflare/sandbox/errors";

Pomocné funkce platformy (ne SandboxError podtřídy):

import {
	isPlatformTransientError,
	isDurableObjectCodeUpdateReset,
} from "@cloudflare/sandbox";

import {
	isPlatformTransientError,
	isDurableObjectCodeUpdateReset,
} from "@cloudflare/sandbox";

Většina chyb SDK dědí z SandboxError:

RuntimeIdentityInactiveError rozšiřuje Error přímo (nikoli SandboxError). Znamená to, že aktuální kontejner už pro tento handle nebo volání není aktivní.

Tabulky obsahují Doporučená oprava sloupec. Podrobnější postupy obnovy najdete v Chyby a zotavení.

Chyby dostupnosti a chyby neshody nasazení jsou uvedeny v samostatných sekcích. Pro oba případy nepoužívejte stejnou smyčku opakování.

Tyto chyby vznikají při běžném startu, zastavení kvůli nečinnosti, nahrazení nebo ztrátě spojení během probíhajícího volání.

context.reason:

reason / context.reason:

Pohodlné gettery na chybě: reason, retryable, a operationName. Další pole, například admitted, operationId, phase, a metadata související se zálohováním se nacházejí na error.context pouze (admitted je true | "unknown").

kind / context.kind:

Tato selhání obvykle znamenají, že si balíček Workeru a image kontejneru neodpovídají, že se image nepodařilo spustit, nebo že metadata nastavení neodpovídají tomu, co očekává SDK. Opravte nasazení. Neberte je jako pomalý start kontejneru.

Nasaďte balíček Workeru a image kontejneru sandboxu ze stejné @cloudflare/sandbox@next řádek. Preview Worker se stabilním obrazem (nebo naopak) zde často selže.

context.reason:

Následující trvalé problémy spolu souvisejí a vracejí stejnou odpověď:

getProcess a listProcesses a vrátí null nebo [] není chyba.

getTerminal a listTerminals a vrátí null nebo [] není chyba.

Tyto třídy jsou dostupné z @cloudflare/sandbox/errors (a některé pomocné nástroje pro připojení z kořenového adresáře balíčku). Podrobnosti si ověřte podle svého nainstalovaného balíčku. Ne všechny specifické návody pro jednotlivé domény jsou již zveřejněny.

Další třídy domén mohou existovat na @cloudflare/sandbox/errors v nainstalovaném balíčku. Než se spolehnete na nezdokumentované rozhraní, ověřte si ho v tomto balíčku.

Chyby související s připojením jsou také exportovány z @cloudflare/sandbox vedle API pro připojení.

Tyto pomocné funkce doplňují SandboxError podtřídy. Nenahrazují pravidla obnovy platná pro Chyby a zotavení.

V produkčním prostředí může platforma Containers odmítnout úlohu, pokud jsou překročeny limity účtu nebo nasazení (například SURPASSED_BASE_LIMITS, SURPASSED_TOTAL_LIMITS, LOCATION_SURPASSED_BASE_LIMITS). Opakování stejného přetížení problém nevyřeší. Snižte souběžnost, zvyšte limity nebo přepněte na operátorský postup. Tyto limity se obvykle neprojeví v lokálním wrangler dev.

Viz Limity platformy.

• Chyby a zotavení
• Životní cyklus sandboxu
• Processes API
• Terminals API
• Migrace