README.md in awstool-0.0.2 vs README.md in awstool-0.1.0

- old
+ new

@@ -1,26 +1,35 @@ -# Awstools +# Awstool Tool for launching and configuring AWS EC2 instances. ## Installation -Not properly gemmed up yet. You'll need to clone and set RUBYLIB environment variable to clonepath/awstools/lib. Requires the fog gem and ruby >=1.9.3. ```bash -export RUBYLIB=/home/user/repos/awstools/lib -sudo apt-get install ruby-dev # For ubuntu/debian -gem install fog +gem install awstool ``` ## Usage Copy example/awstools.yaml to ~/.awstools.yaml. Fill it out to your liking. ```bash -cd awstools/bin -./awstools hostname +awstool floop.example.com ``` -This will launch and instance and create an A record with route53. - +This will launch and instance and create an A record with route53. +You can split your settings files up and then merge them on the command line with the -o flag. +```bash +awstool -o ~/ubuntu-14.04.yaml,~/webserver.yaml floop.example.com +``` +This will allow for different levels of templating. Particularly useful for setting puppet +options and security groups. Launch a bunch of instances off of the same configs like so. +```bash +awstool -o ~/ubuntu-14.04.yaml,~/webserver.yaml floop1.example.com floop2.example.com jb.example.com +# or +awstool -o ~/ubuntu-14.04.yaml,~/webserver.yaml floop{1..5}.example.com +``` +When launching multiple instances the tool will choose a random subnet from the subnet-ids array unless +the -s flag or the 'subnet-id-index' option is set. It can also balance between the subnets with +'subnet_balance: true' in settings. ## Contributing Bug reports and pull requests are welcome on GitHub at https://github.com/nburg/awstools.