Container

API reference for Cloudflare Container resources

Container

Deploy and manage container applications on Cloudflare’s global network.

Container Binding

Creates a Container binding for use in Cloudflare Workers.

Props

className · string · required

The class name for the container binding.

const container = await Container("my-container", {
  className: "MyContainerClass",
  build: {
    context: "./docker/container"
  }
});

build · object

Docker build configuration.

Show properties

context · string · required

Build context directory.

dockerfile · string · default: "Dockerfile"

Path to Dockerfile.

platform · string · default: "linux/amd64"

Target platform.

image · string

Pre-built image reference (alternative to build).

maxInstances · number · default: "10"

Maximum number of container instances that can be running.

instanceType · InstanceType · default: "dev"

Instance type determining compute resources.

Options: lite, dev, basic, standard, standard-1, standard-2, standard-3, standard-4

Output

id · string

Unique identifier for the container.

className · string

Class name used to identify the container in Worker bindings.

image · Image

Docker image configuration for the container.

type · container

Type identifier for the binding.

Example

const container = await Container("my-container", {
  className: "MyContainerClass",
  build: {
    context: "./docker/container"
  },
  maxInstances: 100
});

const worker = await Worker("my-worker", {
  entrypoint: "./src/worker.ts",
  bindings: {
    MY_CONTAINER: container
  }
});

ContainerApplication

Deploy a managed container application with automatic scaling.

Props

name · string

The name of the container application.

Hide default

${app}-${stage}-${id}

image · Image · required

The Docker image to deploy in the container application.

instances · number · default: "1"

The initial number of container instances to deploy.

maxInstances · number · default: "1"

The maximum number of instances to be used for the deployment.

instanceType · InstanceType · default: "dev"

The instance type to be used for the deployment.

Instance Type	vCPU	Memory (Min)	Memory (Max)
lite	1/16	256 MiB	2 GB
basic	1/4	1 GiB	4 GB
standard-1	1/2	4 GiB	8 GB
standard-2	1	6 GiB	12 GB
standard-3	2	8 GiB	16 GB
standard-4	4	12 GiB	20 GB

schedulingPolicy · SchedulingPolicy · default: "default"

Scheduling policy that controls container placement.

Options: moon, gpu, regional, fill_metals, default

rollout · ContainerApplicationRollout

Configuration for progressive rollout when updating.

Show properties

strategy · rolling | immediate · default: "rolling"

The rollout strategy to use.

stepPercentage · number · default: "25"

Percentage of instances to update in each step (1-100).

adopt · boolean · default: "false"

Whether to adopt an existing container application with the same name.

Output

id · string

Unique identifier for the container application.

name · string

Human-readable name of the container application.

Examples

Simple Web Application

const webApp = await ContainerApplication("my-web-app", {
  name: "my-web-app",
  image: await Image("web-app", {
    name: "web-app",
    build: {
      context: "./docker/web-app"
    }
  }),
  instances: 1,
  maxInstances: 3
});

GPU-Enabled AI Application

const aiApp = await ContainerApplication("ai-inference", {
  name: "ai-inference",
  image: await Image("ai-model", {
    name: "ai-model",
    build: {
      context: "./docker/ai"
    }
  }),
  schedulingPolicy: "gpu",
  instances: 2,
  maxInstances: 5
});

Container with Durable Objects

const doNamespace = DurableObjectNamespace("my-do", {
  className: "MyDO"
});

const worker = await Worker("do-worker", {
  entrypoint: "./src/worker.ts",
  bindings: {
    DO: doNamespace
  }
});

const containerApp = await ContainerApplication("stateful-app", {
  name: "stateful-app",
  image: await Image("do-app", {
    name: "do-app",
    build: {
      context: "./container"
    }
  }),
  durableObjects: {
    namespaceId: doNamespace.namespaceId
  },
  instances: 1,
  maxInstances: 10
});

Progressive Rollout

const app = await ContainerApplication("my-app", {
  image: await Image("app", {
    build: { context: "./docker" }
  }),
  instances: 10,
  maxInstances: 20,
  rollout: {
    strategy: "rolling",
    stepPercentage: 10  // Update 10% at a time
  }
});