[changelog] Support for Containers with the Cloudflare Vite plugin

Author: CarmenPopoviciu

src/content/changelog/workers/2025-07-22-containers-in-vite-dev.mdx

@@ -0,0 +1,87 @@
+---
+title: Support for Containers with the Cloudflare Vite plugin
+description: The Cloudflare Vite plugin now supports configuring Containers in your Worker
+products:
+  - workers
+date: 2025-07-22
+---
+
+You can now configure Cloudflare Containers in your Worker during local development using the Cloudflare Vite plugin and `vite dev`.
+
+#### Prerequisites
+
+To develop Container-enabled Workers locally with `vite dev`, you will need to first ensure that a Docker compatible CLI tool and Engine are installed. For instance, you can use [Docker Desktop](https://docs.docker.com/desktop/) on Mac, Windows, or Linux.
+
+Once installed, make sure that Docker is running locally before you start the local development server using `vite dev`.
+
+#### Configuration
+
+You can simply configure your Worker and your Container(s) in your Wrangler configuration file:
+
+<WranglerConfig>
+```jsonc
+{
+  "name": "container-starter",
+  "main": "src/index.js",
+  "containers": [
+    {
+      "class_name": "MyContainer",
+      "image": "./Dockerfile",
+      "instances": 5,
+      "name": "hello-containers-go"
+    }
+  ],
+  "durable_objects": {
+    "bindings": [
+      {
+        "class_name": "MyContainer",
+        "name": "MY_CONTAINER"
+      }
+    ]
+  },
+  "migrations": [
+    {
+      "new_sqlite_classes": [
+        "MyContainer"
+      ],
+      "tag": "v1"
+    }
+  ],
+}
+```
+</WranglerConfig>
+
+#### Worker Code
+
+Once your Worker and Containers are configured, you can access the Container instances from your Worker code:
+
+```ts
+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
+}
+
+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);
+}
+```
+
+#### Local development
+
+To develop your Worker locally, start a local dev server by running
+
+```sh
+vite dev
+```
+
+in your terminal.
+
+#### Resources
+
+Learn more about [Cloudflare Containers](https://developers.cloudflare.com/containers/) or the [Cloudflare Vite plugin](https://developers.cloudflare.com/workers/vite-plugin/) in our developer docs.