Amazon EC2 CLI Installation: Difference between revisions

From NovaOrdis Knowledge Base
Jump to navigation Jump to search
No edit summary
Line 75: Line 75:


Note: For some reason, the console always shows by default "Oregon", which corresponds to <tt>https://ec2.us-west-2.amazonaws.com</tt>.
Note: For some reason, the console always shows by default "Oregon", which corresponds to <tt>https://ec2.us-west-2.amazonaws.com</tt>.
!!!Commands
|[ec2-describe-regions]
|[ec2-describe-instances]
|[ec2-start-instances]
|[ec2-import-instance]
|[ec2-run-instances]
|[ec2-create-tags]

Revision as of 17:57, 11 February 2016

External

Internal

Download

wget http://s3.amazonaws.com/ec2-downloads/ec2-api-tools.zip

Unzip

cd /opt
unzip .../ec2-api-tools.zip
ln -s ./ec2-api-tools-1.7.5.1 ec2-api-tools

Adjust the command to reflect the actual EC2 API tools version.

Post-Install

Set JAVA_HOME

Set JAVA_HOME for all accounts that are going to use ec2 tools.

Set Environment

For all users that are going to use it, configure the following environment variables in their .bashrc (or equivalent):

export EC2_HOME=/opt/ec2-api-tools
export PATH=${PATH}:${EC2_HOME}/bin

Set the Access Keys

Provision the API access keys for the Amazon IAM user that will use the API. More details about access keys here: Amazon AWS Security API Access Keys.

Access keys can be specified on command line every time an ec2 command is issued, with:

-aws-access-key or -O
--aws-secret-key or -W 

or by setting the following environment variables:

export AWS_ACCESS_KEY=your-aws-access-key-id 
export AWS_SECRET_KEY=your-aws-secret-key

Test Installation

ec2-describe-regions

Set the Region

export EC2_URL=https://<service_endpoint>  

Example:

export EC2_URL=https://ec2.us-west-2.amazonaws.com

Note: For some reason, the console always shows by default "Oregon", which corresponds to https://ec2.us-west-2.amazonaws.com.