terraform/website/source/docs/providers/fastly/index.html.markdown

89 lines
1.8 KiB
Markdown
Raw Normal View History

---
layout: "fastly"
page_title: "Provider: Fastly"
sidebar_current: "docs-fastly-index"
description: |-
Fastly
---
# Fastly Provider
The Fastly provider is used to interact with the content delivery network (CDN)
provided by Fastly.
In order to use this Provider, you must have an active account with Fastly.
Pricing and signup information can be found at https://www.fastly.com/signup
Use the navigation to the left to read about the available resources.
## Example Usage
2017-04-10 18:23:21 +02:00
```hcl
# Configure the Fastly Provider
provider "fastly" {
api_key = "test"
}
# Create a Service
resource "fastly_service_v1" "myservice" {
name = "myawesometestservice"
# ...
}
```
## Authentication
The Fastly provider offers an API key based method of providing credentials for
authentication. The following methods are supported, in this order, and
explained below:
- Static API key
- Environment variables
### Static API Key ###
Static credentials can be provided by adding a `api_key` in-line in the
2016-03-24 15:53:25 +01:00
Fastly provider block:
Usage:
2017-04-10 18:23:21 +02:00
```hcl
provider "fastly" {
api_key = "test"
}
2016-03-24 15:53:25 +01:00
resource "fastly_service_v1" "myservice" {
# ...
2016-03-24 15:53:25 +01:00
}
```
The API key for an account can be found on the Account page: https://app.fastly.com/#account
###Environment variables
You can provide your API key via `FASTLY_API_KEY` environment variable,
2016-03-24 15:53:25 +01:00
representing your Fastly API key. When using this method, you may omit the
Fastly `provider` block entirely:
2017-04-10 18:23:21 +02:00
```hcl
2016-03-24 15:53:25 +01:00
resource "fastly_service_v1" "myservice" {
# ...
2016-03-24 15:53:25 +01:00
}
```
Usage:
```
$ export FASTLY_API_KEY="afastlyapikey"
$ terraform plan
```
## Argument Reference
The following arguments are supported in the `provider` block:
* `api_key` - (Optional) This is the API key. It must be provided, but
it can also be sourced from the `FASTLY_API_KEY` environment variable