The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

fastly - a command line shell for interacting with the Fastly infrastructure

USAGE

    fastly [option[s]] 

CONFIGURATION

You can either have a config file in either ~/.fastly or /etc/fastly with

    user     = <login>
    password = <password>
    

NOTE: For the time being you must use username and password, not API key. This may change in the future.

Alternatively you can pass in any of those options on the command line

    fastly --user=<login> --password=<password>
    

PROXYING

There are three ways to proxy:

The first method is to put a proxy option in your .fastly file (or pass it in on)

    proxy = http://localhost:8080
    

The second is to pass it in on the command line

    fastly --user <login> --password <password> --proxy http://localhost:8080

Lastly, the third method is to set your https_proxy environment variable. So, in Bash

    % export https_proxy=http://localhost:8080

or in CSH or TCSH

    % setenv https_proxy=http://localhost:8080    

DESCRIPTION

COMMANDS

help

Display a help message with available commands.

show

Display various thing. The sub commands are

services

List all the services you have access to with their ids and names.

    fastly> show services

might show

    KXKPV9svJFuPapAMjzxgP       FooCorp
    6g2rQokiwAGSRdGYhCY76v      Example-Service
    Y9puwhPNS5Y1tAjUbxp7Z       Test

service

Display the information from one particular service including all backends, directors, domains and origins.

    fastly> show service <service name>
    

versions

Show the creation date of all the versions for a service.

    fastly> show versions <service name>

diff

Display the diff between two different versions

    fastly> show diff <service name> version <version number> to <version number>

stats

Display the stats for a service. Default last argument is minutely.

    fastly> show stats <service name> [all|minutely|hourly|daily]

create

Create a new object.

    fastly> create service <service name>
    fastly> create service <service name> version <version number> backend  <name> [options[s]]
    fastly> create service <service name> version <version number> director <name> [options[s]]
    fastly> create service <service name> version <version number> domain   <name> [options[s]]
    fastly> create service <service name> version <version number> origin   <name> [options[s]]

Options look like

    fastly> create service <service name> version <version number> backend  <name> ipv4 <ip address>

set

Update an object. A note - you cannot change the names of things.

 fastly> set service <service name> version <version number> backend  <name> [options[s]]
 fastly> set service <service name> version <version number> director <name> [options[s]]
 fastly> set service <service name> version <version number> domain   <name> [options[s]]
 fastly> set service <service name> version <version number> origin   <name> [options[s]]

Agagin, like create, options look like

    fastly> set service <service name> version <version number> director <name> retries <retries>

delete

Delete an object from a configuration.

    fastly> delete service <service name>
    fastly> delete service <service name> version <version number>
    fastly> delete service <service name> version <version number> backend  <backend name>
    fastly> delete service <service name> version <version number> director <director name>
    fastly> delete service <service name> version <version number> domain   <domain name>
    fastly> delete service <service name> version <version number> origin   <origin name>
    

clone

Clone a configuration so that the new version can be modified.

    fastly> clone service <service name> version <version number>

activate

Activate a version for use - this will lock it and prevent any further modification.

    fastly> activate service <service name> version <version number>
    

purge

Remove objects from the cache.

    fastly> purge service <service name>
    
    fastly> purge <url>

upload

Upload a custom VCL file

    fastly> upload service <service name> version <version number> from <file> [as <vcl name>]

validate

Check to see that the currently uploaded VCL is valid.

    fastly> validate service <service name> version <version number>

dump

Show the generated VCL for a given service.

fastly> dump service <service name> version <version number>

quit

Exit the Fastly shell.

COPYRIGHT

Copyright 2011 - Fastly Inc

Mail support at fastly dot com if you have problems.

DEVELOPERS

http://github.com/fastly/fastly-perl

http://www.fastly.com/documentation