4.1 KiB
layout | page_title | sidebar_current | description |
---|---|---|---|
fastly | Fastly: aws_vpc | docs-fastly-resource-service-v1 | Provides an Fastly Service |
fastly_service_v1
Provides a Fastly Service, representing the configuration for a website, app, api, or anything else to be served through Fastly. A Service encompasses Domains and Backends.
The Service resource requires a domain name that is correctly set up to direct traffic to the Fastly service. See Fastly's guide on Adding CNAME Records on their documentation site for guidance.
Example Usage
Basic usage:
resource "fastly_service_v1" "demo" {
name = "demofastly"
domain {
name = "demo.notexample.com"
comment = "demo"
}
backend {
address = "127.0.0.1"
name = "localhost"
port = 80
}
force_destroy = true
}
Basic usage with an Amazon S3 Website:
resource "fastly_service_v1" "demo" {
name = "demofastly"
domain {
name = "demo.notexample.com"
comment = "demo"
}
backend {
address = "demo.notexample.com.s3-website-us-west-2.amazonaws.com"
name = "AWS S3 hosting"
port = 80
}
default_host = "${aws_s3_bucket.website.name}.s3-website-us-west-2.amazonaws.com"
force_destroy = true
}
resource "aws_s3_bucket" "website" {
bucket = "demo.notexample.com"
acl = "public-read"
website {
index_document = "index.html"
error_document = "error.html"
}
}
Note: For an AWS S3 Bucket, the Backend address is
<domain>.s3-website-<region>.amazonaws.com
. The default_host
attribute
should be set to <bucket_name>.s3-website-<region>.amazonaws.com
. See the
Fastly documentation on Amazon S3
Argument Reference
The following arguments are supported:
name
- (Required) The unique name for the Service to createdomain
- (Required) A set of Domain names to serve as entry points for your Service. Defined below.backend
- (Required) A set of Backends to service requests from your Domains. Defined below.default_host
- (Optional) The default hostnamedefault_ttl
- (Optional) The default Time-to-live (TTL) for requestsforce_destroy
- (Optional) Services that are active cannot be destroyed. In order to destroy the Service, setforce_destroy
totrue
. Defaultfalse
.
The domain
block supports:
name
- (Required) The domain that this Service will respond tocomment
- (Optional) An optional comment about the Domain
The backend
block supports:
name
- (Required, string) Name for this Backend. Must be unique to this Serviceaddress
- (Required, string) An IPv4, hostname, or IPv6 address for the Backendauto_loadbalance
- (Optional, boolean) Denote if this Backend should be included in the pool of backends that requests are load balanced against. Defaulttrue
between_bytes_timeout
- (Optional) How long to wait between bytes in milliseconds. Default10000
connect_timeout
- (Optional) How long to wait for a timeout in milliseconds. Default1000
error_threshold
- (Optional) Number of errors to allow before the Backend is marked as down. Default0
first_byte_timeout
- (Optional) How long to wait for the first bytes in milliseconds. Default15000
max_conn
- (Optional) Maximum number of connections for this Backend. Default200
port
- (Optional) The port number Backend responds on. Default80
ssl_check_cert
- (Optional) Be strict on checking SSL certs. Defaulttrue
weight
- (Optional) How long to wait for the first bytes in milliseconds. Default100
Attributes Reference
The following attributes are exported:
id
- The ID of the Servicename
– Name of this serviceactive_version
- The currently active version of your Fastly Servicedomain
– Set of Domains. See above for detailsbackend
– Set of Backends. See above for detailsdefault_host
– Default host specifieddefault_ttl
- Default TTLforce_destroy
- Force the destruction of the Service on delete