[Workers] Add getting started guide for API and IaC

Author: markjmiller

src/content/docs/terraform/additional-configurations/link-workers.mdx

@@ -0,0 +1,7 @@
+---
+pcx_content_type: navigation
+title: Workers
+external_link: /workers/platform/infrastructure-as-code/
+sidebar:
+  order: 12
+---

src/content/docs/workers/configuration/multipart-upload-metadata.mdx

@@ -24,6 +24,11 @@ If you're using the [Workers Script Upload API](/api/resources/workers/subresour
 }
 ```
 
+:::note
+
+See examples of metadata being used with the Workers Script Upload API [here](/workers/platform/infrastructure-as-code).
+:::
+
 ## Attributes
 
 The following attributes are configurable at the top-level.

src/content/docs/workers/platform/infrastructure-as-code.mdx

@@ -0,0 +1,110 @@
+---
+title: Infrastructure as Code (IaC)
+pcx_content_type: concept
+sidebar:
+  order: 11
+---
+
+import { GitHubCode } from "~/components";
+
+Uploading and managing a Worker is easy with [Wrangler](/workers/wrangler/configuration), but sometimes you need to do it more programmatically. You might do this with IaC ("Infrastructure as Code") tools or by calling the [Cloudflare API](https://developers.cloudflare.com/api) directly. Use cases for the API include build and deploy scripts, CI/CD pipelines, custom dev tools, or testing. We provide API SDK libraries for common languages that make interacting with the API easier, such as [cloudflare-typescript](https://github.com/cloudflare/cloudflare-typescript) or [cloudflare-python](https://github.com/cloudflare/cloudflare-python). For IaC, a common tool is HashiCorp's Terraform where you can use the [Cloudflare Provider](/terraform) to create and manage Workers resources.
+
+Here are examples of deploying a Worker with common tools and languages. In particular, they highlight how to upload script content and metadata which is different with each approach. Reference the Upload Worker Module API docs [here](https://developers.cloudflare.com/api/resources/workers/subresources/scripts/methods/update/).
+
+All of these examples need an [account id](/fundamentals/setup/find-account-and-zone-ids) and [API token](/fundamentals/api/get-started/create-token) (not Global API key) to work.
+
+## Terraform
+
+In this example, you need a local file named `my-hello-world-script.mjs` with script content similar to the above examples. Replace `account_id` with your own. Learn more about the Cloudflare Terraform Provider [here](/terraform), and see an example with all the Workers script resource settings [here](https://github.com/cloudflare/terraform-provider-cloudflare/blob/main/examples/resources/cloudflare_workers_script/resource.tf).
+
+```tf
+terraform {
+  required_providers {
+    cloudflare = {
+      source = "cloudflare/cloudflare"
+      version = "~> 5"
+    }
+  }
+}
+
+resource "cloudflare_workers_script" "my-hello-world-script" {
+  account_id = "<replace_me>"
+  script_name = "my-hello-world-script"
+  main_module = "my-hello-world-script.mjs"
+  content = trimspace(file("my-hello-world-script.mjs"))
+  bindings = [{
+    name = "MESSAGE"
+    type = "plain_text"
+    text = "Hello World!"
+  }]
+}
+```
+
+:::note
+
+- `trimspace()` removes empty lines in the file
+- The Workers Script resource does not have a `metadata` property like in the other examples. All of the properties found in `metadata` are instead at the top-level of the resource class, such as `bindings` or `compatibility_date`. Please see the [cloudflare_workers_script (Resource) docs](https://registry.terraform.io/providers/cloudflare/cloudflare/latest/docs/resources/workers_script).
+  :::
+
+## Cloudflare API Libraries
+
+### JavaScript/TypeScript
+
+This example uses the [cloudflare-typescript](https://github.com/cloudflare/cloudflare-typescript) library which provides convenient access to the Cloudflare REST API from server-side JavaScript or TypeScript.
+
+<GitHubCode
+	repo="cloudflare/cloudflare-typescript"
+	file="examples/workers/script-upload.ts"
+	commit="f30592e4d10fd9090999bc63b36ca7e4eaf66f74"
+	lang="ts"
+	code={{
+		collapse: "1-13",
+	}}
+/>
+
+### Python
+
+This example uses the [cloudflare-python](https://github.com/cloudflare/cloudflare-python) library.
+
+<GitHubCode
+	repo="cloudflare/cloudflare-python"
+	file="examples/workers/script-upload.py"
+	commit="8845a22af23075ae88496bc7187471485b944048"
+	lang="py"
+	code={{
+		collapse: "1-12",
+	}}
+/>
+
+## Cloudflare REST API
+
+Open a terminal or create a shell script to upload a Worker easily with curl. For this example, replace `<account_id>` and `<api_token>` with your own. What's notable about interacting with the Workers Script Upload API directly is that it uses [multipart/form-data](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Methods/POST) for uploading metadata, multiple JavaScript modules, source maps, and more. This is abstracted away in Terraform and the API libraries.
+
+```bash
+curl https://api.cloudflare.com/client/v4/accounts/<account_id>/workers/scripts/my-hello-world-script \
+  -X PUT \
+  -H 'Authorization: Bearer <api_token>' \
+  -F 'metadata={
+        "main_module": "my-hello-world-script.mjs",
+        "bindings": [
+          {
+            "type": "plain_text",
+            "name": "MESSAGE",
+            "text": "Hello World!"
+          }
+        ],
+        "compatibility_date": "2025-03-11"
+      };type=application/json' \
+  -F 'my-hello-world-script.mjs=@-;filename=my-hello-world-script.mjs;type=application/javascript+module' <<EOF
+export default {
+  async fetch(request, env, ctx) {
+    return new Response(env.MESSAGE, { status: 200 });
+  }
+};
+EOF
+```
+
+:::note
+
+Change `my-hello-world-script.mjs=@-;` to `my-hello-world-script.mjs=@./my-hello-world-script.mjs;` and remove everything after and including `<<EOF` to upload a local file named `my-hello-world-script.mjs` instead.
+:::