Installation & Usage
To install, run pip install s3domain.
To use, run s3domain. Additional arguments may be specified. Run s3domain --help for more information.
Authentication
Your AWS credentials can be set in a number of ways:
- In a ".boto" file in your home folder. See Boto's documentation for how to create this file.
- In a ".aws" file in the folder you're running
d3ployin. Follows the same format as ".boto". - In the environment variables "AWS_ACCESS_KEY_ID" and "AWS_SECRET_ACCESS_KEY".
- Passed in as arguments.
-aor--access-keyfor the Access Key ID and-sor--access-secretfor the Secret Access Key. - In the per-enviroment configuration outlined below.
Arguments
| Short Code | Long Code | Description | Default |
|---|---|---|---|
| -l | --location | which S3 region to set the bucket up in (USA or EU) | USA |
| -a | --access-key | Amazon Access Key | none |
| -s | --access-secret | Amazon Access Secret | none |
| -w | --www | make a second bucket with "www." prepended to the bucket name | false |
| -d | --dns | setup DNS records for the bucket(s) on Route53 | false |
| --dns-zone | the DNS zone file to add the records to | the bucket name | |
| -i | --index | the name of the index file for the webhosting rules | index.html |
| -e | --error | the name of the error file for the webhosting rules | 404.html |
| -r | --redirect | a URI or domain name to redirect all requests to | none |
The bucket's name is passed as the only positional argument: s3domain dryan.com.