Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
92 changes: 92 additions & 0 deletions src/content/changelog/workers/2024-10-2-workflows-terraform.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,92 @@
---
title: You can now deploy and manage Workflows in Terraform
description: You can now deploy and manage Workflows in Terraform, using the [Cloudflare Terraform provider v5.11.0](https://registry.terraform.io/providers/cloudflare/cloudflare/latest/docs/resources/workflow).
products:
- workers
date: 2025-10-03
---

You can now create and manage [Workflows](/workflows/) using Terraform, now supported in the [Cloudflare Terraform provider v5.11.0](https://registry.terraform.io/providers/cloudflare/cloudflare/latest/docs/resources/workflow). Workflows allow you to build durable, multi-step applications -- without needing to worry about retrying failed tasks or managing infrastructure.

Now, you can deploy and manage Workflows through Terraform using the new [`cloudflare_workflow` resource](https://registry.terraform.io/providers/cloudflare/cloudflare/latest/docs/resources/workflow):

```hcl
resource "cloudflare_workflow" "my_workflow" {
account_id = var.account_id
workflow_name = "my-workflow"
class_name = "MyWorkflow"
script_name = "my-worker"
}
```

# Examples
Here are full examples of how to configure `cloudflare_workflow` in Terraform, using the existing [`cloudflare_workers_script` resource](https://registry.terraform.io/providers/cloudflare/cloudflare/latest/docs/resources/workers_script), and the beta [`cloudflare_worker_version` resource](https://registry.terraform.io/providers/cloudflare/cloudflare/latest/docs/resources/worker_version).


#### With `cloudflare_workflow` and `cloudflare_workers_script`

```hcl
resource "cloudflare_workers_script" "workflow_worker" {
account_id = var.cloudflare_account_id
script_name = "my-workflow-worker"

content_file = "${path.module}/../dist/worker/index.js"
content_sha256 = filesha256("${path.module}/../dist/worker/index.js")
main_module = "index.js"
}

resource "cloudflare_workflow" "workflow" {
account_id = var.cloudflare_account_id
workflow_name = "my-workflow"
class_name = "MyWorkflow"
script_name = cloudflare_workers_script.workflow_worker.script_name
}

```


#### With `cloudflare_workflow`, and the new beta resources
You can more granularly control the lifecycle of each Worker resource using the beta [`cloudflare_worker_version`](https://registry.terraform.io/providers/cloudflare/cloudflare/5.11.0/docs/resources/worker_version) resource, alongside the [`cloudflare_worker`](https://registry.terraform.io/providers/cloudflare/cloudflare/latest/docs/resources/worker) and [`cloudflare_workers_deployment`](https://registry.terraform.io/providers/cloudflare/cloudflare/5.11.0/docs/resources/workers_deployment) resources.


```hcl

resource "cloudflare_worker" "workflow_worker" {
account_id = var.cloudflare_account_id
name = "my-workflow-worker"
}

resource "cloudflare_worker_version" "workflow_worker_version" {
account_id = var.cloudflare_account_id
worker_id = cloudflare_worker.workflow_worker.id

main_module = "index.js"

modules = [{
name = "index.js"
content_file = "${path.module}/../dist/worker/index.js"
content_type = "application/javascript+module"
}]
}

resource "cloudflare_workers_deployment" "workflow_deployment" {
account_id = var.cloudflare_account_id
script_name = cloudflare_worker.workflow_worker.name

strategy = "percentage"
versions = [{
version_id = cloudflare_worker_version.workflow_worker_version.id
percentage = 100
}]
}

resource "cloudflare_workflow" "my_workflow" {
account_id = var.cloudflare_account_id
workflow_name = "my-workflow"
class_name = "MyWorkflow"
script_name = cloudflare_worker.workflow_worker.name
}
```

## Try it out
- Get started with [the Cloudflare Terraform provider (v5.11.0)](https://registry.terraform.io/providers/cloudflare/cloudflare/5.11.0/docs) and the new [`cloudflare_workflow` resource](https://registry.terraform.io/providers/cloudflare/cloudflare/latest/docs/resources/workflow).
91 changes: 91 additions & 0 deletions src/content/changelog/workers/2025-10-02-assets-terraform.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,91 @@
---
title: You can now deploy full-stack apps on Workers using Terraform
description: The Cloudflare Terraform provider v5.11.0 now lets you define a directory of static assets, and handles the heavy lifting of uploading them and detecting changes.
products:
- workers
date: 2025-10-03
---
import { Code } from 'astro-expressive-code/components';

You can now upload Workers with [static assets](/workers/static-assets/) (like HTML, CSS, JavaScript, images) with the [Cloudflare Terraform provider v5.11.0](https://registry.terraform.io/providers/cloudflare/cloudflare/5.11.0/docs), making it even easier to deploy and manage full-stack apps with IaC.

**Previously**, you couldn't use Terraform to upload static assets without writing custom scripts to handle generating an [asset manifest](/workers/static-assets/direct-upload/#upload-manifest), calling the [Cloudflare API to upload assets in chunks](/workers/static-assets/direct-upload/#upload-static-assets), and handling change detection.

**Now**, you simply define the directory where your assets are built, and we handle the rest. Check out the [examples](/changelog/#examples) for what this looks like in Terraform configuration.

You can get started today with [the Cloudflare Terraform provider (v5.11.0)](https://registry.terraform.io/providers/cloudflare/cloudflare/5.11.0/docs), using either the existing [`cloudflare_workers_script` resource](https://registry.terraform.io/providers/cloudflare/cloudflare/latest/docs/resources/workers_script), or the beta [`cloudflare_worker_version` resource](https://registry.terraform.io/providers/cloudflare/cloudflare/latest/docs/resources/worker_version).


## Examples

#### With `cloudflare_workers_script`

Here's how you can use the existing [`cloudflare_workers_script`](https://registry.terraform.io/providers/cloudflare/cloudflare/5.11.0/docs/resources/workers_script) resource to upload your Worker code and assets in one shot.


```hcl
resource "cloudflare_workers_script" "my_app" {
account_id = var.account_id
script_name = "my-app"

content_file = "./dist/worker/index.js"
content_sha256 = filesha256("./dist/worker/index.js")
main_module = "index.js"

# Just point to your assets directory - that's it!
assets = {
directory = "./dist"
}
}
```

#### With `cloudflare_worker`, `cloudflare_worker_version`, and `cloudflare_workers_deployment`

And here's an example using the beta [`cloudflare_worker_version`](https://registry.terraform.io/providers/cloudflare/cloudflare/5.11.0/docs/resources/worker_version) resource, alongside the [`cloudflare_worker`](https://registry.terraform.io/providers/cloudflare/cloudflare/latest/docs/resources/worker) and [`cloudflare_workers_deployment`](https://registry.terraform.io/providers/cloudflare/cloudflare/5.11.0/docs/resources/workers_deployment) resources:

```hcl

# This tracks the existence of your Worker, so that you
# can upload code and assets separately from tracking Worker state.

resource "cloudflare_worker" "my_app" {
account_id = var.account_id
name = "my-app"
}

resource "cloudflare_worker_version" "my_app_version" {
account_id = var.account_id
worker_id = cloudflare_worker.my_app.id

# Just point to your assets directory - that's it!
assets = {
directory = "./dist"
}

modules = [{
name = "index.js"
content_file = "./dist/worker/index.js"
content_type = "application/javascript+module"
}]
}

resource "cloudflare_workers_deployment" "my_app_deployment" {
account_id = var.account_id
script_name = cloudflare_worker.my_app.name

strategy = "percentage"
versions = [{
version_id = cloudflare_worker_version.my_app_version.id
percentage = 100
}]
}
```

## What's changed
Under the hood, the Cloudflare Terraform provider now handles the same logic that Wrangler uses for static asset uploads. This includes scanning your assets directory, computing hashes for each file, generating a manifest with file metadata, and calling the Cloudflare API to upload any missing files in chunks. We support large directories with parallel uploads and chunking, and when the asset manifest hash changes, we detect what's changed and trigger an upload for *only* those changed files.


## Try it out
- Get started with [the Cloudflare Terraform provider (v5.11.0)](https://registry.terraform.io/providers/cloudflare/cloudflare/5.11.0/docs)
- You can use either the existing [`cloudflare_workers_script` resource](https://registry.terraform.io/providers/cloudflare/cloudflare/latest/docs/resources/workers_script) to upload your Worker code and assets in one resource.
- Or you can use the new beta [`cloudflare_worker_version` resource](https://registry.terraform.io/providers/cloudflare/cloudflare/latest/docs/resources/worker_version) (along with the [`cloudflare_worker`](https://registry.terraform.io/providers/cloudflare/cloudflare/latest/docs/resources/worker) and [`cloudflare_workers_deployment`](https://registry.terraform.io/providers/cloudflare/cloudflare/5.11.0/docs/resources/workers_deployment)) resources to more granularly control the lifecycle of each Worker resource.