From 1e216d4d8b4610891bda9b55a83d08619837c6b6 Mon Sep 17 00:00:00 2001 From: Thomas Wiest Date: Tue, 28 Oct 2014 11:03:14 -0400 Subject: doc update --- README_AWS.md | 40 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 README_AWS.md (limited to 'README_AWS.md') diff --git a/README_AWS.md b/README_AWS.md new file mode 100644 index 000000000..2602f9883 --- /dev/null +++ b/README_AWS.md @@ -0,0 +1,40 @@ + +AWS Setup Instructions +====================== + +Get AWS API credentials +----------------------- +1. [AWS credentials documentation](http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSGettingStartedGuide/AWSCredentials.html) + + +Create a credentials file +------------------------- +1. Create a credentials file (eg ~/.aws_creds) that looks something like this (variables must have have these exact names). +``` + export AWS_ACCESS_KEY_ID='AKIASTUFF' + export AWS_SECRET_ACCESS_KEY='STUFF' +``` + +1. source this file +``` + source ~/.aws_creds +``` + +1. Note: You must source this file in each shell that you want to run cloud.rb + + +Install Dependencies +-------------------- +1. Ansible requires python-boto for aws operations: +``` + yum install -y ansible python-boto +``` + + +Test The Setup +-------------- +1. cd openshift-online-ansible +1. Try to list all instances: +``` + ./cloud.rb aws list +``` -- cgit v1.2.1