137 lines
4.1 KiB
Markdown
137 lines
4.1 KiB
Markdown
|
---
|
|||
|
layout: "fastly"
|
|||
|
page_title: "Fastly: aws_vpc"
|
|||
|
sidebar_current: "docs-fastly-resource-service-v1"
|
|||
|
description: |-
|
|||
|
Provides an Fastly Service
|
|||
|
---
|
|||
|
|
|||
|
# fastly\_service\_v1
|
|||
|
|
|||
|
Provides an 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 setup to direct
|
|||
|
traffic to the Fastly service. See Fastly's guide on [Adding CNAME Records][2]
|
|||
|
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][1]
|
|||
|
|
|||
|
## Argument Reference
|
|||
|
|
|||
|
The following arguments are supported:
|
|||
|
|
|||
|
* `name` - (Required) The unique name for the Service to create
|
|||
|
* `domain` - (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 hostname
|
|||
|
* `default_ttl` - (Optional) The default Time-to-live (TTL) for requests
|
|||
|
* `force_destroy` - (Optional) Services that are active cannot be destroyed. In
|
|||
|
order to destroy the Service, set `force_destroy` to `true`. Default `false`.
|
|||
|
|
|||
|
|
|||
|
The `domain` block supports:
|
|||
|
|
|||
|
* `name` - (Required) The domain that this Service will respond to
|
|||
|
* `comment` - (Optional) An optional comment about the Domain
|
|||
|
|
|||
|
The `backend` block supports:
|
|||
|
|
|||
|
* `name` - (Required, string) Name for this Backend. Must be unique to this Service
|
|||
|
* `address` - (Required, string) An IPv4, hostname, or IPv6 address for the Backend
|
|||
|
* `auto_loadbalance` - (Optional, boolean) Denote if this Backend should be
|
|||
|
included in the pool of backends that requests are load balanced against.
|
|||
|
Default `true`
|
|||
|
* `between_bytes_timeout` - (Optional) How long to wait between bytes in milliseconds. Default `10000`
|
|||
|
* `connect_timeout` - (Optional) How long to wait for a timeout in milliseconds.
|
|||
|
Default `1000`
|
|||
|
* `error_threshold` - (Optional) Number of errors to allow before the Backend is marked as down. Default `0`
|
|||
|
* `first_byte_timeout` - (Optional) How long to wait for the first bytes in milliseconds. Default `15000`
|
|||
|
* `max_conn` - (Optional) Maximum number of connections for this Backend.
|
|||
|
Default `200`
|
|||
|
* `port` - (Optional) The port number Backend responds on. Default `80`
|
|||
|
* `ssl_check_cert` - (Optional) Be strict on checking SSL certs. Default `true`
|
|||
|
* `weight` - (Optional) How long to wait for the first bytes in milliseconds.
|
|||
|
Default `100`
|
|||
|
|
|||
|
## Attributes Reference
|
|||
|
|
|||
|
The following attributes are exported:
|
|||
|
|
|||
|
* `id` - The ID of the Service
|
|||
|
* `name` – Name of this service
|
|||
|
* `active_version` - The currently active version of your Fastly Service
|
|||
|
* `domain` – Set of Domains. See above for details
|
|||
|
* `backend` – Set of Backends. See above for details
|
|||
|
* `default_host` – Default host specified
|
|||
|
* `default_ttl` - Default TTL
|
|||
|
* `force_destroy` - Force the destruction of the Service on delete
|
|||
|
|
|||
|
|
|||
|
[1]: https://docs.fastly.com/guides/integrations/amazon-s3
|
|||
|
[2]: https://docs.fastly.com/guides/basic-setup/adding-cname-records
|
|||
|
|