ansible-fastly

Moduł Ansible do konfigurowania usług w Fastly

Instalacja

$ ansible-galaxy install Jimdo.fastly

Dokumentacja

Opcje modułu

Nazwa	Wymagane	Opis	Domyślnie
name	tak	Unikalna nazwa usługi do utworzenia
fastly_api_key	nie	Klucz API Fastly. Jeśli nie jest ustawiony, używana jest wartość zmiennej środowiskowej FASTLY_API_KEY.
activate_new_version	nie	Określa, czy nowo utworzone wersje powinny być aktywowane automatycznie	tak
domains	tak	Lista nazw domen, które mają służyć jako punkty wejścia dla Twojej usługi
backends	tak	Lista backendów do obsługi zapytań z Twoich domen
cache_settings	nie	Lista ustawień pamięci podręcznej
conditions	nie	Lista warunków
directors	nie	Lista dyrektorów
gzips	nie	Lista konfiguracji gzip
headers	nie	Lista nagłówków do manipulacji dla każdego żądania
healthchecks	nie	Lista kontroli zdrowia dla benötigowanych backendów
request_settings	nie	Lista ustawień żądania
response_objects	nie	Lista obiektów odpowiedzi
settings	nie	Obiekt ustawień
s3s	nie	Lista loggerów S3
syslogs	nie	Lista loggerów Syslog
vcl_snippets	nie	Lista fragmentów VCL

Backend

Dokumentacja Fastly

Pole	Wymagane	Typ	Domyślnie
name	tak	string
port	nie	integer	80
address	tak	string
ssl_hostname	nie	string
ssl_ca_cert	nie	string
ssl_cert_hostname	nie	string
shield	nie	string
healthcheck	nie	string
weight	nie	integer	100
connect_timeout	nie	integer	1000
first_byte_timeout	nie	integer	15000
between_bytes_timeout	nie	integer	10000
error_threshold	nie	integer	0
max_conn	nie	integer	200

Ustawienia pamięci podręcznej

Dokumentacja Fastly

Pole	Wymagane	Typ	Domyślnie
name	tak	string
action	nie	enum ('cache', 'pass', 'restart')
cache_condition	nie	string
stale_ttl	nie	integer	0

Warunek

Dokumentacja Fastly

Pole	Wymagane	Typ	Domyślnie
name	tak	string
comment	nie	string
priority	nie	integer	0
statement	tak	string
type	tak	enum ('REQUEST', 'PREFETCH', 'CACHE', 'RESPONSE')

Dyrektor

Dokumentacja Fastly

Pole	Wymagane	Typ	Domyślnie
name	tak	string
backends	nie	array of strings
capacity	nie	integer	100
comment	nie	string	''
quorum	nie	integer	75
shield	nie	string
type	nie	integer (jeden z [1,2,3,4])	1
retries	nie	integer	5

Nagłówek

Dokumentacja Fastly

Pole	Wymagane	Typ	Domyślnie
name	tak	string
action	nie	enum ('set', 'append', 'delete', 'regex', 'regex_repeat')	set
dst	tak	string
ignore_if_set	nie	integer (jeden z [0,1])	0
priority	nie	integer	100
regex	nie	string
request_condition	nie	string
response_condition	nie	string
cache_condition	nie	string
src	tak	string
substitution	nie	string
type	tak	enum ('request', 'fetch', 'cache', 'response')

Kontrola zdrowia

Dokumentacja Fastly

Pole	Wymagane	Typ	Domyślnie
name	tak	string
check_interval	nie	integer
comment	nie	string	''
expected_response	nie	integer	200
host	tak	string
http_version	nie	string	1.1
initial	nie	integer
method	nie	string	HEAD
path	nie	string	'/'
threshold	nie	integer
timeout	nie	integer
window	nie	integer

Ustawienia żądania

Dokumentacja Fastly

Pole	Wymagane	Typ	Domyślnie
name	tak	string
request_condition	nie	string
action	nie	enum ('lookup', 'pass')
xff	nie	enum ('clear', 'leave', 'append', 'append_all', 'overwrite')
hash_keys	nie	string
default_host	nie	string
max_stale_age	nie	integer	0
force_miss	nie	integer	0
force_ssl	nie	integer	0
timer_support	nie	integer	0
geo_headers	nie	integer	0
bypass_busy_wait	nie	integer	0

Obiekt odpowiedzi

Dokumentacja Fastly

Pole	Wymagane	Typ	Domyślnie
name	tak	string
request_condition	nie	string
response	nie	string	Ok
status	nie	integer	200
content	nie	string
content_type	nie	string

Fragmenty VCL

Dokumentacja Fastly

Pole	Wymagane	Typ	Domyślnie
name	tak	string
dynamic	nie	integer	0
type	nie	string	"init"
content	tak	string
priority	nie	integer	100

Logowanie S3

Dokumentacja Fastly

Pole	Wymagane	Typ	Domyślnie
name	tak	string
access_key	nie	string
bucket_name	nie	string
domain	nie	string
format	nie	string	%{%Y-%m-%dT%H:%M:%S}t %h "%r" %>s %b
format_version	nie	integer	2
gzip_level	nie	integer	0
message_type	nie	enum ('classic', 'loggly', 'logplex', 'blank')	classic
path	nie	string	/
period	nie	integer	3600
placement	nie	string
redundancy	nie	string
response_condition	nie	string	''
secret_key	nie	string
server_side_encryption_kms_key_id	nie	string
server_side_encryption	fałszywe	string
timestamp_format	nie	string	%Y-%m-%dT%H

Logowanie Syslog

Dokumentacja Fastly

Pole	Wymagane	Typ	Domyślnie
name	tak	string
address	tak	string
format	nie	string	%{%Y-%m-%dT%H:%M:%S}t %h "%r" %>s %b
format_version	nie	integer	2
hostname	nie	string
ipv4	nie	string
message_type	nie	enum ('classic', 'loggly', 'logplex', 'blank')	classic
placement	nie	string
port	tak	int
response_condition	nie	string	''
tls_ca_cert	nie	string
tls_hostname	nie	string
token	nie	string
use_tls	nie	int	0

Ustawienia

Dokumentacja Fastly

Pole	Wymagane	Typ	Domyślnie
general.default_ttl	nie	integer	3600

Przykłady

Użycie modułu fastly_service w Playbooku

---
- hosts: localhost
  connection: local
  gather_facts: False
  roles:
    - Jimdo.fastly
  tasks:
    - fastly_service:
        name: Usługa przekierowania
        domains:
          - name: test1.example.net
            comment: domena przekierowująca
        backends:
          - name: localhost
            port: 80
            address: 127.0.0.1
        headers:
          - name: Ustaw nagłówek lokalizacji
            dst: http.Location
            type: response
            action: set
            src: http://test3.example.net req.url.path
            ignore_if_set: 0
            priority: 10
        response_objects:
          - name: Ustaw kod stanu 301
            status: 301

$ ansible-playbook -i localhost, fastly.yml

Rozwój

Uruchamianie testów

FASTLY_API_KEY=some_secret python -m unittest discover tests

Aktualizacja kaset VCR

VCR.py jest używany w testach do mockowania żądań HTTP.

Aby zaktualizować kasety, po prostu usuń katalog tests/fixtures/cassettes i uruchom testy jak zwykle. Musisz użyć ważnego klucza API Fastly, aby nagrywanie działało.