QuickInstanceEC2

Quick Instance EC2

Quick Instance qi.py lets you launch, deploy applications and terminate AWS ec2 instances using CloudFormation. This is useful when a disposable ec2 instance is needed to quickly test or deploy an application on a supported OS.

Examples:

Launch a vanilla Amazon Linux ec2 instance without bootstrapping it:

./qi.py amazon-linux

Launch Ubuntu ec2 instance with Apache Tomcat7 configured:

./qi.py ubuntu --bootstrap "wget https://raw.githubusercontent.com/awslabs/aws-support-tools/master/EC2/QuickInstanceEC2/DeployScripts/tomcat7_ubuntu14.04_install.sh -O /tmp/install.sh && chmod +x /tmp/install.sh && /tmp/install.sh"

Launch Amazon Linux with LAMP stack configured:

./qi.py amazon-linux --bootstrap "yum update -y && yum groupinstall -y 'Web Server' 'MySQL Database' 'PHP Support' && yum install -y php-mysql && service httpd start && chkconfig httpd on && groupadd www && usermod -a -G www ec2-user && chown -R root:www /var/www && chmod 2775 /var/www && find /var/www -type d -exec chmod 2775 {} + && find /var/www -type f -exec chmod 0664 {} + && echo '<?php phpinfo(); ?>' > /var/www/html/phpinfo.php"

Launch six difference ec2 instances simultaneously:

for os in amazon-linux nat-instance ubuntu redhat-linux windows-2008 windows-2012; do ./qi.py $os & done

Launch Ubuntu ec2 instance with a 100GB root volume size by overriding the default configuration:

./qi.py ubuntu --volume 100

To terminate, run the same command again:

./qi.py ubuntu
./qi.py amazon-linux

Installation:

Installation on Linux and Mac OSX:

curl -o qi.py https://raw.githubusercontent.com/awslabs/aws-support-tools/master/EC2/QuickInstanceEC2/qi.py
chmod +x qi.py

For installation on Windows, save this.

To install boto3 on Windows and launching an ec2 instance:

C:\Python27\python.exe -m pip install boto3
C:\Python27\python.exe qi.py amazon-linux

Configuration:

Run configure when running for the first time to configure quick instance.

./qi.py configure

Requirements:

• Python 2.7 or above.
• Boto3 python module.
• Python pip required to install boto3 module.
• AWS credentials in ~/.aws/credentials or ec2 instance role with appropriate IAM permissions. Follow this guide to set up AWS credentials.