Terraform and Cloudflare Provider Version

Oct 13, 2025 by wbrum.org 11 views

Introduction

Cloudflare Workers is a powerful platform for building serverless applications. However, when trying to import a Cloudflare Workers deployment using Terraform, users may encounter an error indicating that the script_name parameter is missing. This article will delve into the issue, provide a step-by-step guide to reproduce the problem, and offer potential solutions to resolve the issue.

Confirmation

This is a bug with an existing resource and is not a feature request or enhancement. Feature requests should be submitted with Cloudflare Support or your account team.

Terraform and Cloudflare Provider Version

The Terraform and Cloudflare provider versions used to reproduce the issue are:

Terraform: 5.1.0
Cloudflare provider: 5.1.0

Affected Resource(s)

The affected resource is cloudflare_workers_deployment.

Terraform Configuration Files

The Terraform configuration file used to reproduce the issue is:

resource "cloudflare_workers_deployment" "example_workers_deployment" {
  account_id = "abc123"
  script_name = "example-script"
  strategy = "percentage"
  versions = [{
    percentage = 100
    version_id = "def-456"
  }]
}

Link to Debug Output

The link to the debug output is: https://gist.github.com/nancy-cai/cf83813a14940e847b7139f701ba1a55

Panic Output

No response.

Expected Output

The expected output is that the resource should be imported successfully by running terraform import cloudflare_workers_deployment.example_workers_deployment 'abc123/example-script'.

Actual Output

The actual output is:

cloudflare_workers_deployment.example_workers_deployment: Import prepared!
  Prepared cloudflare_workers_deployment for import
cloudflare_workers_deployment.example_workers_deployment: Refreshing state...

│ Error: failed to make http request
│ 
│ missing required script_name parameter

Steps to Reproduce

To reproduce the issue, follow these steps:

Create the below resource file:

resource "cloudflare_workers_deployment" "example_workers_deployment" {
  account_id = <your_account_id>
  script_name = "example-script"
  strategy = "percentage"
  versions = [{
    percentage = 100
    version_id = "def-456"
  }]
}

Run terraform import cloudflare_workers_deployment.example_workers_deployment '<your_account_id>/example-script'

Additional Factoids

No additional factoids.

References

No references.

Potential Solutions

Based on the issue, potential solutions include:

Verify the script_name parameter: Ensure that the script_name parameter is correctly set in the Terraform configuration file.
Check the account ID: Verify that the account ID is correct and matches the one used in the Cloudflare Workers deployment.
Update the Terraform and Cloudflare provider versions: Try updating the Terraform and Cloudflare provider versions to the latest available versions.
Contact Cloudflare Support: Reach out to Cloudflare Support for further assistance and guidance.

Introduction

In our previous article, we explored the issue of importing a Cloudflare Workers deployment using Terraform, where the script_name parameter is missing. We provided a step-by-step guide to reproduce the problem and offered potential solutions to resolve the issue. In this article, we will answer some frequently asked questions (FAQs) related to this issue.

Q: What is the cause of the missing required script_name parameter error?

A: The cause of the missing required script_name parameter error is due to a mismatch between the Terraform configuration file and the actual Cloudflare Workers deployment. This can occur when the script_name parameter is not correctly set in the Terraform configuration file or when the account ID used in the Terraform configuration file does not match the one used in the Cloudflare Workers deployment.

Q: How can I verify the script_name parameter in my Terraform configuration file?

A: To verify the script_name parameter in your Terraform configuration file, follow these steps:

Open your Terraform configuration file.
Locate the cloudflare_workers_deployment resource.
Check if the script_name parameter is correctly set.
Ensure that the script_name parameter matches the one used in the Cloudflare Workers deployment.

Q: What should I do if I'm still experiencing issues after verifying the script_name parameter?

A: If you're still experiencing issues after verifying the script_name parameter, try the following:

Check the account ID used in the Terraform configuration file and ensure it matches the one used in the Cloudflare Workers deployment.
Update the Terraform and Cloudflare provider versions to the latest available versions.
Reach out to Cloudflare Support for further assistance and guidance.

Q: Can I use a different method to import the Cloudflare Workers deployment?

A: Yes, you can use a different method to import the Cloudflare Workers deployment. Instead of using the terraform import command, you can try using the Cloudflare API to import the deployment. However, this method requires programming knowledge and may be more complex than using the terraform import command.

Q: How can I prevent this issue from occurring in the future?

A: To prevent this issue from occurring in the future, follow these best practices:

Always verify the script_name parameter in your Terraform configuration file.
Ensure that the account ID used in the Terraform configuration file matches the one used in the Cloudflare Workers deployment.
Keep your Terraform and Cloudflare provider versions up to date.
Regularly review your Terraform configuration files for any errors or inconsistencies.

Q: Can I get help from Cloudflare Support if I'm experiencing issues with importing my Cloudflare Workers deployment?

A: Yes, you can get help from Cloudflare Support if you're experiencing issues with importing your Cloudflare Workers deployment. Reach out to Cloudflare Support via their support portal or by contacting their support team directly.

By following these FAQs and best practices, you should be able to resolve the issue of importing a Cloudflare Workers deployment using Terraform and avoid similar issues in the future.