Nevi/wrangler-resource-provisioning

src/content/changelog/workers/2025-02-14-automatic-resource-creation-beta.mdx

@@ -0,0 +1,45 @@
+---
+title: Automatic Resource Creation (Beta)
+description: When you deploy a Worker that binds to a Cloudflare resource, Wrangler will automatically detect and create any resources that do not exist on your account. 
+products:
+  - workers
+date: 2025-02-14 00:00:00 UTC
+---
+
+You can now automatically create Cloudflare resources as part of your deployment! You no longer need to manually create any resources that do not yet exist on your account prior to deploying. Wrangler will automatically detect any required [KV](/kv), [D1](/d1), or [R2](/r2) resources and create them on your behalf. 
+
+For more details, check out our [documentation](/workers/wrangler/automatic-resource-creation) on how to get started with automatic resource creation. 
+
+```bash
+$ wrangler deploy --x-provision
+ ⛅️ wrangler 3.109.0
+--------------------
+
+Total Upload: 0.29 KiB / gzip: 0.22 KiB
+
+The following bindings need to be provisioned:
+- KV Namespaces:
+  - MY_KV 
+- D1 Databases:
+  - MY_D1 
+- R2 Buckets:
+  - MY_R2 
+
+...
+
+🎉 All resources provisioned, continuing with deployment...
+
+Your worker has access to the following bindings:
+- KV Namespaces:
+  - MY_KV: ...
+- D1 Databases:
+  - MY_D1: ...
+- R2 Buckets:
+  - MY_R2: ...
+Uploaded my-worker
+Deployed my-worker triggers
+  https://my-worker.workers.dev
+Current Version ID: ...
+```
+
+Resource provisiong is currently a beta feature. If you run into issues or would like to leave feedback for the team to help us improve, please send us a message in our [Cloudflare Developers Discord](https://discord.cloudflare.com/) in the [Wrangler channel](https://discord.com/channels/595317990191398933/799437470004412476).

src/content/docs/workers/wrangler/automatic-resource-creation.mdx

@@ -0,0 +1,97 @@
+---
+pcx_content_type: concept
+title: Automatic Resource Creation
+description: When you deploy a Worker that binds to a Cloudflare resource, Wrangler will automatically detect and create any resources that do not exist on your account. 
+sidebar:
+  badge:
+    text: Beta
+---
+
+import { PackageManagers, WranglerConfig } from "~/components";
+
+You can now automatically provision Cloudflare resources as part of your deployment.  You no longer need to manually create any resources that do not yet exist on your account prior to deploying. 
+
+With resource provisioning, if your Wrangler configuration file includes a [KV namespace](/kv/), [D1 database](/d1/), or [R2 bucket](/r2/) that does not yet exist, Wrangler will create these resources upon deployment. This is done by adding the experimental `-–x-provision` flag to your commands. 
+
+## Wrangler Configuration 
+You can set up your Wrangler configuration file like the following:
+
+<WranglerConfig>
+```json
+{
+  "kv_namespaces": [
+    {
+      "binding": "MY_KV"
+    }
+  ],
+  "r2_buckets": [
+    {
+      "binding": "MY_R2"
+    }
+  ],
+  "d1_databases": [
+    {
+      "binding": "MY_D1"
+    }
+  ]
+}
+```
+</WranglerConfig>
+
+When using the experimental `-–x-provision` flag, the `id` field for KV and D1 and the `bucket_name` for R2 are optional in your wrangler configuration. 
+
+## Developing locally and deploying
+When developing locally, you can interact with local versions of any KV, D1, R2 resources configured in your Wrangler configuration file by running:
+
+<PackageManagers
+	type="exec"
+	pkg="wrangler"
+	args={"dev –-x-provision"}
+/>
+
+When you're ready to deploy, run: 
+
+<PackageManagers
+	type="exec"
+	pkg="wrangler"
+	args={"deploy –-x-provision"}
+/>
+
+Upon deploy Wrangler will automatically create the resources that do not yet exist on your accound and bind them to your Worker. 
+
+```bash
+$ wrangler deploy --x-provision
+ ⛅️ wrangler 3.109.0
+--------------------
+
+Total Upload: 0.29 KiB / gzip: 0.22 KiB
+
+The following bindings need to be provisioned:
+- KV Namespaces:
+  - MY_KV 
+- D1 Databases:
+  - MY_D1 
+- R2 Buckets:
+  - MY_R2 
+
+...
+
+🎉 All resources provisioned, continuing with deployment...
+
+Your worker has access to the following bindings:
+- KV Namespaces:
+  - MY_KV: ...
+- D1 Databases:
+  - MY_D1: ...
+- R2 Buckets:
+  - MY_R2: ...
+Uploaded my-worker
+Deployed my-worker triggers
+  https://my-worker.workers.dev
+Current Version ID: ...
+```
+
+The newly created resource will be named with the format `<worker-name>-<binding-name>` by default.
+
+## Feedback 
+Resource provisiong is currently a beta feature. If you run into issues or would like to leave feedback for the team to help us improve, please send us a message in our [Cloudflare Developers Discord](https://discord.cloudflare.com/) in the [Wrangler channel](https://discord.com/channels/595317990191398933/799437470004412476).