Standup
Standup is an application deployment and infrastructure management tool for Rails and Amazon EC2.
Basic usage
gem install standup
cd path/to/your/rails/project
standup init
- Fill in actual settings in generated file
config/standup.yml
standup setup
standup status
Config file
It consists of 3 major parts:
Amazon Web Services credentials
aws:
account_id: 0123-4567-8910
access_key_id: GTFGV123P45DRDKOBBVP
secret_access_key: jKkjhkjbb1Bhjh+MBG0GBbmuhdGh/Kgbdhzbd9sd
keypair_name: aws
availability_zone: us-east-1c
Here, keypair_name is keypair filename, without .pem
extension.
By default, Standup searches actual file under ~/.ssh
directory.
You can override this behavior by specifying keypair_file
param.
Global script params
ec2:
image_id: ami-480df921 # Canonical Ubuntu 10.04, EBS boot
instance_type: m1.small
ssh_user: ubuntu
webapp:
name: superproject
github_user: supercoder
github_repo: superproject
Major part of script params can be set here.
In webapp
script name
param is used for database name and application path.
Nodes and their script params
nodes:
main:
ec2:
elastic_ip: 123.123.123.123
testing:
staging:
Here, under nodes
section, should go actual nodes (server instances) which you want to manage.
For each node, you can specify additional script params.
In this example, elastic_ip
param of ec2
script is set for node main
.
Script params are merged in node-specific || global || script-defaults
manner.
Tweaking bundled scripts
standup localize <script_name>
- Script file
config/standup/<script_name>.rb
will be copied from gem. - Script's own files, like configs etc. under
config/standup/<script_name>
, if any, will be copied from gem too. - You can edit them and standup will use them instead of default.
- You can delete local script file or its own files, then default ones will be used.
Creating new scripts
standup generate <script_name>
- Script file
config/standup/<script_name>.rb
will be created with empty script stub. - Edit it as you want, it's now available for Standup.
Setup script
Setup script automates common Rails application deployment workflow.
If you want to add your script into this workflow, just set it as script param, thus overwriting default.
For example, if you want to add rescue
to your configuration, you need to:
-
Write that
rescue
script -
Change standup.yml like the following:
nodes: main: ... setup: ec2 basics ruby postgresql passenger rescue webapp update
To do
- ? Script sequences: rework default script as script sequence
- change shell for www-data user
- change owner of /home/ubuntu/.irb-history
Copyright
Copyright (c) 2010 Ilia Ablamonov, Cloud Castle Inc. See LICENSE for details.