ansible-fastly
用于配置 Fastly 服务的 Ansible 模块
安装
$ ansible-galaxy install Jimdo.fastly
文档
模块选项
| 名称 |
必需 |
描述 |
默认值 |
| name |
是 |
要创建的服务的唯一名称 |
|
| fastly_api_key |
否 |
Fastly API 密钥。如果未设置，则使用 FASTLY_API_KEY 环境变量的值。 |
|
| activate_new_version |
否 |
配置是否自动激活新创建的版本 |
true |
| domains |
是 |
作为服务入口点的域名列表 |
|
| backends |
是 |
为您的域名服务请求的后端列表 |
|
| cache_settings |
否 |
缓存设置列表 |
|
| conditions |
否 |
条件列表 |
|
| directors |
否 |
导向器列表 |
|
| gzips |
否 |
gzip 配置列表 |
|
| headers |
否 |
每个请求要处理的头部列表 |
|
| healthchecks |
否 |
用于后端目的的健康检查列表 |
|
| request_settings |
否 |
请求设置列表 |
|
| response_objects |
否 |
响应对象列表 |
|
| settings |
否 |
设置对象 |
|
| s3s |
否 |
S3 日志记录器列表 |
|
| syslogs |
否 |
Syslog 日志记录器列表 |
|
| vcl_snippets |
否 |
VCL 片段列表 |
|
后端
Fastly 文档
| 字段 |
必需 |
类型 |
默认值 |
| name |
是 |
字符串 |
|
| port |
否 |
整数 |
80 |
| address |
是 |
字符串 |
|
| ssl_hostname |
否 |
字符串 |
|
| ssl_ca_cert |
否 |
字符串 |
|
| ssl_cert_hostname |
否 |
字符串 |
|
| shield |
否 |
字符串 |
|
| healthcheck |
否 |
字符串 |
|
| weight |
否 |
整数 |
100 |
| connect_timeout |
否 |
整数 |
1000 |
| first_byte_timeout |
否 |
整数 |
15000 |
| between_bytes_timeout |
否 |
整数 |
10000 |
| error_threshold |
否 |
整数 |
0 |
| max_conn |
否 |
整数 |
200 |
缓存设置
Fastly 文档
| 字段 |
必需 |
类型 |
默认值 |
| name |
是 |
字符串 |
|
| action |
否 |
枚举 ('cache', 'pass', 'restart') |
|
| cache_condition |
否 |
字符串 |
|
| stale_ttl |
否 |
整数 |
0 |
条件
Fastly 文档
| 字段 |
必需 |
类型 |
默认值 |
| name |
是 |
字符串 |
|
| comment |
否 |
字符串 |
|
| priority |
否 |
整数 |
0 |
| statement |
是 |
字符串 |
|
| type |
是 |
枚举 ('REQUEST', 'PREFETCH', 'CACHE', 'RESPONSE') |
|
导向器
Fastly 文档
| 字段 |
必需 |
类型 |
默认值 |
| name |
是 |
字符串 |
|
| backends |
否 |
字符串数组 |
|
| capacity |
否 |
整数 |
100 |
| comment |
否 |
字符串 |
'' |
| quorum |
否 |
整数 |
75 |
| shield |
否 |
字符串 |
|
| type |
否 |
整数 (1, 2, 3, 4中的一个) |
1 |
| retries |
否 |
整数 |
5 |
头部
Fastly 文档
| 字段 |
必需 |
类型 |
默认值 |
| name |
是 |
字符串 |
|
| action |
否 |
枚举 ('set', 'append', 'delete', 'regex', 'regex_repeat') |
set |
| dst |
是 |
字符串 |
|
| ignore_if_set |
否 |
整数 (0, 1中的一个) |
0 |
| priority |
否 |
整数 |
100 |
| regex |
否 |
字符串 |
|
| request_condition |
否 |
字符串 |
|
| response_condition |
否 |
字符串 |
|
| cache_condition |
否 |
字符串 |
|
| src |
是 |
字符串 |
|
| substitution |
否 |
字符串 |
|
| type |
是 |
枚举 ('request', 'fetch', 'cache', 'response') |
|
健康检查
Fastly 文档
| 字段 |
必需 |
类型 |
默认值 |
| name |
是 |
字符串 |
|
| check_interval |
否 |
整数 |
|
| comment |
否 |
字符串 |
'' |
| expected_response |
否 |
整数 |
200 |
| host |
是 |
字符串 |
|
| http_version |
否 |
字符串 |
1.1 |
| initial |
否 |
整数 |
|
| method |
否 |
字符串 |
HEAD |
| path |
否 |
字符串 |
'/' |
| threshold |
否 |
整数 |
|
| timeout |
否 |
整数 |
|
| window |
否 |
整数 |
|
请求设置
Fastly 文档
| 字段 |
必需 |
类型 |
默认值 |
| name |
是 |
字符串 |
|
| request_condition |
否 |
字符串 |
|
| action |
否 |
枚举 ('lookup', 'pass') |
|
| xff |
否 |
枚举 ('clear', 'leave', 'append', 'append_all', 'overwrite') |
|
| hash_keys |
否 |
字符串 |
|
| default_host |
否 |
字符串 |
|
| max_stale_age |
否 |
整数 |
0 |
| force_miss |
否 |
整数 |
0 |
| force_ssl |
否 |
整数 |
0 |
| timer_support |
否 |
整数 |
0 |
| geo_headers |
否 |
整数 |
0 |
| bypass_busy_wait |
否 |
整数 |
0 |
响应对象
Fastly 文档
| 字段 |
必需 |
类型 |
默认值 |
| name |
是 |
字符串 |
|
| request_condition |
否 |
字符串 |
|
| response |
否 |
字符串 |
Ok |
| status |
否 |
整数 |
200 |
| content |
否 |
字符串 |
|
| content_type |
否 |
字符串 |
|
VCL 片段
Fastly 文档
| 字段 |
必需 |
类型 |
默认值 |
| name |
是 |
字符串 |
|
| dynamic |
否 |
整数 |
0 |
| type |
否 |
字符串 |
"init" |
| content |
是 |
字符串 |
|
| priority |
否 |
整数 |
100 |
S3 日志记录
Fastly 文档
| 字段 |
必需 |
类型 |
默认值 |
| name |
是 |
字符串 |
|
| access_key |
否 |
字符串 |
|
| bucket_name |
否 |
字符串 |
|
| domain |
否 |
字符串 |
|
| format |
否 |
字符串 |
%{%Y-%m-%dT%H:%M:%S}t %h "%r" %>s %b |
| format_version |
否 |
整数 |
2 |
| gzip_level |
否 |
整数 |
0 |
| message_type |
否 |
枚举 ('classic', 'loggly', 'logplex', 'blank') |
classic |
| path |
否 |
字符串 |
/ |
| period |
否 |
整数 |
3600 |
| placement |
否 |
字符串 |
|
| redundancy |
否 |
字符串 |
|
| response_condition |
否 |
字符串 |
'' |
| secret_key |
否 |
字符串 |
|
| server_side_encryption_kms_key_id |
否 |
字符串 |
|
| server_side_encryption |
否 |
字符串 |
|
| timestamp_format |
否 |
字符串 |
%Y-%m-%dT%H |
Syslog 日志记录
Fastly 文档
| 字段 |
必需 |
类型 |
默认值 |
| name |
是 |
字符串 |
|
| address |
是 |
字符串 |
|
| format |
否 |
字符串 |
%{%Y-%m-%dT%H:%M:%S}t %h "%r" %>s %b |
| format_version |
否 |
整数 |
2 |
| hostname |
否 |
字符串 |
|
| ipv4 |
否 |
字符串 |
|
| message_type |
否 |
枚举 ('classic', 'loggly', 'logplex', 'blank') |
classic |
| placement |
否 |
字符串 |
|
| port |
是 |
整数 |
|
| response_condition |
否 |
字符串 |
'' |
| tls_ca_cert |
否 |
字符串 |
|
| tls_hostname |
否 |
字符串 |
|
| token |
否 |
字符串 |
|
| use_tls |
否 |
整数 |
0 |
设置
Fastly 文档
| 字段 |
必需 |
类型 |
默认值 |
| general.default_ttl |
否 |
整数 |
3600 |
示例
在 Playbook 中使用 fastly_service 模块
---
- hosts: localhost
connection: local
gather_facts: False
roles:
- Jimdo.fastly
tasks:
- fastly_service:
name: Redirect service
domains:
- name: test1.example.net
comment: redirect domain
backends:
- name: localhost
port: 80
address: 127.0.0.1
headers:
- name: Set Location header
dst: http.Location
type: response
action: set
src: http://test3.example.net req.url.path
ignore_if_set: 0
priority: 10
response_objects:
- name: Set 301 status code
status: 301
$ ansible-playbook -i localhost, fastly.yml
开发
运行测试
FASTLY_API_KEY=some_secret python -m unittest discover tests
更新 VCR 磁带
VCR.py 用于测试中模拟 HTTP 请求。
要更新磁带，只需删除 tests/fixtures/cassettes 目录，然后照常运行测试。您必须使用有效的 Fastly API 密钥才能录制工作。
