Skip to content

Latest commit

 

History

History
102 lines (82 loc) · 4.09 KB

config-aws.rst

File metadata and controls

102 lines (82 loc) · 4.09 KB

Configuring for Amazon AWS

This process requires you to have an Amazon Web Services (AWS) account. If you have not signed up for one yet, it can obtained at http://aws.amazon.com.

You should start by generating a generic configuration file for Juju, using the command:

juju generate-config

This will generate a file, environments.yaml , which will live in your ~/.juju/ directory (and will create the directory if it doesn't already exist).

Note

If you have an existing configuration, you can use juju generate-config --show to output the new config file, then copy and paste relevant areas in a text editor etc.

The generic configuration sections generated for AWS will look something like this:

## https://juju.ubuntu.com/get-started/amazon/
amazon:
type: ec2
admin-secret: 772b97c4c31c6b5883475e396d9a6d32
# globally unique S3 bucket name
control-bucket: juju-a29403f89d8223343d3cab01f1ca5a4d
# override if your machine is on a different series than what you're deploying
# default-series: precise
# region defaults to us-east-1, override if required
# region: us-east-1
# Usually set via the env variable AWS_ACCESS_KEY_ID, but can be specified here
# access-key: secret
# Can be set via the env variable AWS_SECRET_ACCESS_KEY, or specified here
# secret-key: secret

This is a simple configuration intended to run on EC2 with S3 permanent storage. Values for the default setting can be changed simply by editing this file, uncommenting the relevant lines and adding your own settings. All you need to do to get this configuration to work is to either set the AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY via environment variables, or uncomment and add the values to the configuration file.

You can retrieve these values easily from your AWS Management Console at http://console.aws.amazon.com. Click on your name in the top- right and then the "Security Credentials" link from the drop down menu.

_img/getting_started-aws_security.png

Under the "Access Keys" heading click the "Create New Root Key" button. You will be prompted to "Download Key File" which by default is named rootkey.csv. Open this file to get the access-key and secret- key for the environments.yaml configuration file.

_img/getting_started-aws_keys.png

The region: value corresponds to the AWS regions.