README
¶
Fastly Terraform Provider - Beta
This repository contains the source code for the fastly-beta
Terraform provider, a new implementation of the existing fastly
Terraform provider. The provider is built on the HashiCorp Terraform
plugin framework unlike the previous provider which is built on the
Terraform Plugin SDK v2.
Fastly expects to deliver the first release of this new provider in September of 2026, and expects to deliver the first non-beta release before the end of 2026.
Design overview
This provider offers a dual-model design with two separate resource families:
- an automatic compatibility resource family for users who want current-provider-style nested resources with automatic clone and activation behavior
- an explicit/default resource family for users who want first-class versioned resources and explicit version lifecycle operations
The user chooses the model through the resource type.
The explicit/default resource family uses the clean resource names. The automatic
compatibility resource family uses the _auto suffix.
Resource families
Automatic compatibility family
resource "fastly_service_cdn_auto" "example" {
domain {
name = "www.example.com"
}
backend {
name = "origin"
address = "origin.example.com"
port = 443
}
}
The automatic compatibility family owns nested configuration and performs automatic version lifecycle handling.
Compatibility service resources:
fastly_service_cdn_autofastly_service_compute_auto
Explicit/default resources still under development
All explicit/default resources are still under active development and are not ready for
use. Use the automatic compatibility family (fastly_service_cdn_auto /
fastly_service_compute_auto) instead until these reach parity:
fastly_service_cdnfastly_service_computefastly_service_domainfastly_service_backendfastly_service_vclfastly_service_vcl_snippetfastly_service_dynamic_vcl_snippetfastly_service_dynamic_snippet_contentfastly_service_conditionfastly_service_cdn_aclfastly_service_cdn_acl_entriesfastly_service_resource_linkfastly_service_dictionary_itemsfastly_service_logging_bigqueryfastly_service_logging_blobstoragefastly_service_logging_datadogfastly_service_logging_gcsfastly_service_logging_httpsfastly_service_logging_newrelicfastly_service_logging_newrelicotlpfastly_service_logging_s3fastly_service_logging_splunkfastly_service_logging_sumologicfastly_service_logging_syslog
Explicit/default family
resource "fastly_service_cdn" "example" {
name = "example"
}
resource "fastly_service_domain" "example" {
service_id = fastly_service_cdn.example.id
version = var.service_version
name = "www.example.com"
}
The explicit/default family uses first-class resources. Version cloning, activation, and staging are handled explicitly by the caller or workflow automation.
Explicit/default service resources:
fastly_service_cdnfastly_service_compute
Shared versioned resources include:
fastly_service_domainfastly_service_backend
Design documents
For the full design, see:
Examples
The examples compare the two resource families by managing the same basic Fastly service configuration:
examples/orchestration-cdn-autoexamples/orchestration-explicit-actionsexamples/orchestration-explicit-cliexamples/orchestration-explicit-latest-cliexamples/compute-explicit-packageexamples/terraform-query-import
Important design rule
A Fastly service should be managed through one resource family only.
Do not manage the same Fastly service with both:
- an automatic compatibility service resource such as
fastly_service_cdn_autoorfastly_service_compute_auto - explicit/default resources such as
fastly_service_cdn,fastly_service_compute,fastly_service_domain, orfastly_service_backend
Documentation
¶
There is no documentation for this package.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
internal
|
|
|
acceptance_tests
Package acceptancetests provides infrastructure for writing acceptance tests.
|
Package acceptancetests provides infrastructure for writing acceptance tests. |
|
constants
Package constants holds shared literal values, notably the default log formats used as Computed schema defaults by the logging resources.
|
Package constants holds shared literal values, notably the default log formats used as Computed schema defaults by the logging resources. |
|
datasources/idhash
Package idhash derives stable IDs for list-style data sources from the set of resource IDs they return, so the data source's own ID changes whenever the underlying set of resources changes.
|
Package idhash derives stable IDs for list-style data sources from the set of resource IDs they return, so the data source's own ID changes whenever the underlying set of resources changes. |
|
datasources/ngwafaccountrules
Package ngwafaccountrules implements the fastly_ngwaf_rules data source.
|
Package ngwafaccountrules implements the fastly_ngwaf_rules data source. |
|
datasources/ngwafsignals
Package ngwafsignals implements the fastly_ngwaf_signals data source.
|
Package ngwafsignals implements the fastly_ngwaf_signals data source. |
|
listidentity
Package listidentity builds list results for resources that intentionally do not implement resource.ResourceWithIdentity.
|
Package listidentity builds list results for resources that intentionally do not implement resource.ResourceWithIdentity. |
|
planmodifiers
Package planmodifiers holds plan modifiers shared across resource packages.
|
Package planmodifiers holds plan modifiers shared across resource packages. |
|
resources/ngwafrequestrule
Package ngwafrequestrule implements the fastly_ngwaf_request_rule resource.
|
Package ngwafrequestrule implements the fastly_ngwaf_request_rule resource. |
|
resources/ngwafrule
Package ngwafrule holds the condition / group_condition / multival_condition builders shared by Next-Gen WAF rule resources.
|
Package ngwafrule holds the condition / group_condition / multival_condition builders shared by Next-Gen WAF rule resources. |
|
resources/ngwafsignal
Package ngwafsignal implements the fastly_ngwaf_signal resource.
|
Package ngwafsignal implements the fastly_ngwaf_signal resource. |
|
resources/ngwafsignalrule
Package ngwafsignalrule implements the fastly_ngwaf_signal_rule resource.
|
Package ngwafsignalrule implements the fastly_ngwaf_signal_rule resource. |
|
resources/ngwafworkspaceratelimitrule
Package ngwafworkspaceratelimitrule implements the fastly_ngwaf_workspace_rate_limit_rule resource.
|
Package ngwafworkspaceratelimitrule implements the fastly_ngwaf_workspace_rate_limit_rule resource. |
|
resources/ngwafworkspacerequestrule
Package ngwafworkspacerequestrule implements the fastly_ngwaf_workspace_request_rule resource.
|
Package ngwafworkspacerequestrule implements the fastly_ngwaf_workspace_request_rule resource. |
|
resources/ngwafworkspacesignalrule
Package ngwafworkspacesignalrule implements the fastly_ngwaf_workspace_signal_rule resource.
|
Package ngwafworkspacesignalrule implements the fastly_ngwaf_workspace_signal_rule resource. |
|
resources/ngwafworkspacetemplatedsignalrule
Package ngwafworkspacetemplatedsignalrule implements the fastly_ngwaf_workspace_templated_signal_rule resource.
|
Package ngwafworkspacetemplatedsignalrule implements the fastly_ngwaf_workspace_templated_signal_rule resource. |
|
scripts
|
|
|
cleanup-test-services
command
Command cleanup-test-services deletes any Fastly service whose name matches a prefix (default "tf-test-"), deactivating its active version first if one exists.
|
Command cleanup-test-services deletes any Fastly service whose name matches a prefix (default "tf-test-"), deactivating its active version first if one exists. |