AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

cloudflare-deploy

Deploy applications and infrastructure to Cloudflare using Workers, Pages, and related platform services. Use when the user asks to deploy, host, publish, or set up a project on Cloudflare.

Original source
openai
License
Apache-2.0
Pinned revision
49f948faa9258a0c61caceaf225e179651397431

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read openai--cloudflare-deploy at revision 49f948faa9258a0c61caceaf225e179651397431, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 309

references/terraform/README.md

Cloudflare Terraform Provider

Expert guidance for Cloudflare Terraform Provider - infrastructure as code for Cloudflare resources.

Core Principles

  • Provider-first: Use Terraform provider for ALL infrastructure - never mix with wrangler.jsonc for the same resources
  • State management: Always use remote state (S3, Terraform Cloud, etc.) for team environments
  • Modular architecture: Create reusable modules for common patterns (zones, workers, pages)
  • Version pinning: Always pin provider version with ~> for predictable upgrades
  • Secret management: Use variables + environment vars for sensitive data - never hardcode API tokens

Provider Version

| Version | Status | Notes | |---------|--------|-------| | 5.x | Current | Auto-generated from OpenAPI, breaking changes from v4 | | 4.x | Legacy | Manual maintenance, deprecated |

Critical: v5 renamed many resources (cloudflare_record → cloudflare_dns_record, cloudflare_worker_* → cloudflare_workers_*). See gotchas.md for migration details.

Provider Setup

Basic Configuration

terraform {
  required_version = ">= 1.0"
  
  required_providers {
    cloudflare = {
      source  = "cloudflare/cloudflare"
      version = "~> 5.15.0"
    }
  }
}

provider "cloudflare" {
  api_token = var.cloudflare_api_token  # or CLOUDFLARE_API_TOKEN env var
}

Authentication Methods (priority order)

  1. API Token (RECOMMENDED): api_token or CLOUDFLARE_API_TOKEN

    • Create: Dashboard → My Profile → API Tokens
    • Scope to specific accounts/zones for security
  2. Global API Key (LEGACY): api_key + api_email or CLOUDFLARE_API_KEY + CLOUDFLARE_EMAIL

    • Less secure, use tokens instead
  3. User Service Key: user_service_key for Origin CA certificates

Quick Reference: Common Commands

terraform init          # Initialize provider
terraform plan          # Plan changes
terraform apply         # Apply changes
terraform destroy       # Destroy resources
terraform import cloudflare_zone.example <zone-id>  # Import existing
terraform state list    # List resources in state
terraform output        # Show outputs
terraform fmt -recursive  # Format code
terraform validate      # Validate configuration

Import Existing Resources

Use cf-terraforming to generate configs from existing Cloudflare resources:

# Install
brew install cloudflare/cloudflare/cf-terraforming

# Generate HCL from existing resources
cf-terraforming generate --resource-type cloudflare_dns_record --zone <zone-id>

# Import into Terraform state
cf-terraforming import --resource-type cloudflare_dns_record --zone <zone-id>

Reading Order

  1. Start with README.md for provider setup and authentication
  2. Review configuration.md for resource configurations
  3. Check api.md for data sources and existing resource queries
  4. See patterns.md for multi-environment and CI/CD patterns
  5. Read gotchas.md for state drift, v5 breaking changes, and troubleshooting

In This Reference

  • configuration.md - Resources for zones, DNS, workers, KV, R2, D1, Pages, rulesets
  • api.md - Data sources for existing resources
  • patterns.md - Architecture patterns, multi-env setup, CI/CD integration
  • gotchas.md - Common issues, security, best practices

See Also

  • pulumi - Alternative IaC tool for Cloudflare
  • wrangler - CLI deployment alternative
  • workers - Worker runtime documentation