summaryrefslogtreecommitdiffstats
path: root/README_AWS.md
diff options
context:
space:
mode:
Diffstat (limited to 'README_AWS.md')
-rw-r--r--README_AWS.md40
1 files changed, 40 insertions, 0 deletions
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
+```