terraform/website/source/docs/providers/fastly/r/service_v1.html.markdown

layout	page_title	sidebar_current	description
fastly	Fastly: aws_vpc	docs-fastly-resource-service-v1	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 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 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