← Containers / containers

Containers

Spouštějte kód napsaný v libovolném programovacím jazyce a vytvořený pro libovolné běhové prostředí jako součást aplikací vytvořených na Workers.

Nasaďte svůj obraz kontejneru do Region:Earth aniž byste se museli starat o správu infrastruktury, stačí definovat Worker a wrangler deploy.

S Containers můžete spustit:

• Náročné aplikace, které potřebují paralelně běžící jádra CPU, velké množství paměti nebo diskového prostoru
• Aplikace a knihovny, které vyžadují úplný souborový systém, konkrétní runtime nebo prostředí podobné Linuxu
• Existující aplikace a nástroje, které byly distribuovány jako obrazy kontejnerů

Instance kontejneru se spouští na vyžádání a řídí je kód, který napíšete ve svém Worker. Místo řetězení volání API nebo psaní Kubernetes operátorů prostě napíšete JavaScript:

import { Container, getContainer } from "@cloudflare/containers";

export class MyContainer extends Container {
	defaultPort = 4000; // Port the container is listening on
	sleepAfter = "10m"; // Stop the instance if requests not sent for 10 minutes
}

export default {
	async fetch(request, env) {
		const { "session-id": sessionId } = await request.json();
		// Get the container instance for the given session ID
		const containerInstance = getContainer(env.MY_CONTAINER, sessionId);
		// Pass the request to the container instance on its default port
		return containerInstance.fetch(request);
	},
};

{
	"name": "container-starter",
	"main": "src/index.js",
	// Set this to today's date
	"compatibility_date": "2026-08-28",
	"containers": [
		{
			"class_name": "MyContainer",
			"image": "./Dockerfile",
			"max_instances": 5
		}
	],
	"durable_objects": {
		"bindings": [
			{
				"class_name": "MyContainer",
				"name": "MY_CONTAINER"
			}
		]
	},
	"migrations": [
		{
			"new_sqlite_classes": ["MyContainer"],
			"tag": "v1"
		}
	]
}

name = "container-starter"
main = "src/index.js"
# Set this to today's date
compatibility_date = "2026-08-28"

[[containers]]
class_name = "MyContainer"
image = "./Dockerfile"
max_instances = 5

[[durable_objects.bindings]]
class_name = "MyContainer"
name = "MY_CONTAINER"

[[migrations]]
new_sqlite_classes = [ "MyContainer" ]
tag = "v1"