In order to access your S3 bucket, Poole needs to know your AWS keys and bucket information. This information is provided in the Poole configuration file: ~/.poole-config.json, which lives in your home directory. This file can contain several different AWS key/secret pairs as well as some options.

Here's a simple example of a Poole config file with AWS auth info:

{

"auth":{

"lostdecadegames":{

"key":"my-aws-key",

"secret":"my-aws-secret"

}

}

}

Here we have an AWS key/secret alias called "lostdecadegames". If you have more than one AWS account, you can add more entries here.

Make sure you DO NOT COMMIT this file into source control as it contains your secret AWS information!

Each project you wish to push to an S3 bucket must have a .poole.json file at its root. Here's an example of a simple Poole project configuration file:

{

"targets":{

"production":{

"auth":"lostdecadegames",

"bucket":"www.cryptrun.com",

"region":"us-west-2"

},

"stage":{

"auth":"lostdecadegames",

"bucket":"stage.www.cryptrun.com",

"region":"us-west-2"

}

},

"headers":{

"(jpg|jpeg|png|mp3)$":{

"Cache-control":"max-age=31536000"

},

"(html|htm)$":{

"Cache-control":"max-age=172800, must-revalidate"

}

}

}

The targets key lists the various S3 buckets where you will be deploying your site. In this example we have "production" and "stage" targets. The auth key corresponds to an entry in your ~/.poole-auth.json file, detailed above.

The headers key lists some regex rules and associated headers. Any files matching the rules will have the specified headers set in S3. In this example, .html and .htm files will have their max-age set to 2 days while images don't expire for a year.

Poole is Dr Jekyll's butler who, upon noticing the reclusiveness and changes of his master, goes to Mr Utterson with the fear that his master has been murdered and his murderer, Mr Hyde, is residing in the chambers. Poole serves Jekyll faithfully, and attempts to do a good job and be loyal to his master. Yet events finally drive him into joining forces with Utterson to discover the truth.