Skip to content

Commit

Permalink
change back to server_user and added some items on README
Browse files Browse the repository at this point in the history
  • Loading branch information
cocoy authored and cocoy committed May 19, 2010
1 parent a93a9d6 commit bb42195
Showing 1 changed file with 44 additions and 1 deletion.
45 changes: 44 additions & 1 deletion README.txt
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,22 @@ Examples are adding additional, pre-configured webservers to a cluster
deployments and creating backups - each with just one call from the
commandline. Aw(e)some, indeed, if we may say so...

** Requirements **
Python2.6

**Installation**

mr.awsome is best installed with easy_install, pip or with zc.recipe.egg in
a buildout. It installs two scripts, ``aws`` and ``assh``.

A simple directory structure for a project:
ec2-project/
etc/
aws.conf
fabfile.py
dbstartup.sh
webstartup.sh

**Configuration**

To authorize itself against AWS, mr.awsome uses the following two environment
Expand All @@ -28,6 +39,10 @@ You can also put them into files and point to them in the ``[aws]`` section
with the ``access-key-id`` and ``secret-access-key`` options. It's best to
put them in ``~/.aws/`` and make sure only your user can read them.

[aws]
access-key-id = /home/user/.aws/access-file
secret-access-key = /home/user/.aws/secret-file

All other information about server instances is located in ``aws.conf``, which
by default is looked up in ``etc/aws.conf``.

Expand Down Expand Up @@ -129,7 +144,35 @@ Directly after that follows the binary data of the gzipped startup script.

**Snapshots**

(Needs description of volumes in "Configuration")
** EBS Volumes **
To attach EBS volumes :

[instance:demo-server]
keypair = default
securitygroups = demo-server
region = eu-west-1
placement = eu-west-1a
# we use images from `http://alestic.com/`_
image = ami-a62a01d2
startup_script = startup-demo-server
fabfile = fabfile.py
volumes =
vol-xxxxx /dev/sdh
vol-yyyyy /dev/sdg

** Elastic IP ***
You have to allocate the new IP and use it to the instance. The tool will associate the Elastic IP to the instance.

[instance:demo-server]
keypair = default
securitygroups = demo-server
region = eu-west-1
placement = eu-west-1a
# we use images from `http://alestic.com/`_
# Ubuntu 9.10 Karmic server 32-bit Europe
image = ami-a62a01d2
ip = xxx.xxx.xxx.xxx


**SSH integration**

Expand Down

0 comments on commit bb42195

Please sign in to comment.