|
| 1 | +--- |
| 2 | +layout: default |
| 3 | +title: Controlling EC2 from the Console |
| 4 | +--- |
| 5 | + |
| 6 | +# Controlling EC2 from the Console |
| 7 | + |
| 8 | +[Amazon Web Services'](http://aws.amazon.com/) [Elastic Compute Cloud](http://aws.amazon.com/ec2/) is a web service that provides resizable compute capacity in the cloud. It is designed to make web-scale computing easier for developers. |
| 9 | + |
| 10 | +You can control your EC2 instances through the [AWS Management Console](https://console.aws.amazon.com/ec2/), but clicking around can be a chore. This tutorial will help you setup your machine so you can spawn new instances, query existing instances, and do general maintainence without leaving the comfort of a terminal. |
| 11 | + |
| 12 | +<div |
| 13 | +markdown="1" |
| 14 | +class="tutorial" |
| 15 | +data-author-github="Whitespace" |
| 16 | +data-license="http://creativecommons.org/licenses/by/3.0/" |
| 17 | +data-facets='{"Operating System": "OS X", "Package Management": "Homebrew", "Shell": "bash"}'> |
| 18 | + |
| 19 | +## Assumptions |
| 20 | +We assume you've [signed up for EC2](https://aws-portal.amazon.com/gp/aws/developer/registration). We also assume your machine has a public key setup (commonly `~/.ssh/id_rsa` and `~/id_rsa.pub`). |
| 21 | + |
| 22 | +## Download Credential Files |
| 23 | +First, you need to download some credential files to your machine. Go to the [AWS Security Credentials](https://portal.aws.amazon.com/gp/aws/securityCredentials) page, click "X.509 Certificates", create a new certificate if you need to, download the files when prompted, and then put them into your `~/.ec2` directory: |
| 24 | + |
| 25 | +{% highlight sh %} |
| 26 | +mkdir ~/.ec2 |
| 27 | +cp ~/Downloads/{cert,pk}-*.pem ~/.ec2 |
| 28 | +{% endhighlight %} |
| 29 | + |
| 30 | +## Install the EC2 Command Line Tools |
| 31 | +Now let's install the two packages we need: |
| 32 | + |
| 33 | +{% highlight sh %} |
| 34 | +brew install ec2-{api,ami}-tools |
| 35 | +{% endhighlight %} |
| 36 | + |
| 37 | +Copy the following to your `~/.bash_profile`: |
| 38 | + |
| 39 | +{% highlight sh %} |
| 40 | +export JAVA_HOME="$(/usr/libexec/java_home)" |
| 41 | +export EC2_PRIVATE_KEY="$(/bin/ls "$HOME"/.ec2/pk-*.pem | /usr/bin/head -1)" |
| 42 | +export EC2_CERT="$(/bin/ls "$HOME"/.ec2/cert-*.pem | /usr/bin/head -1)" |
| 43 | +export EC2_HOME="/usr/local/Library/LinkedKegs/ec2-api-tools/jars" |
| 44 | +export AWS_ACCESS_KEY_ID="..." |
| 45 | +export AWS_SECRET_ACCESS_KEY"=..." |
| 46 | +{% endhighlight %} |
| 47 | + |
| 48 | +Where `AWS_ACCESS_KEY_ID` and `AWS_SECRET_ACCESS_KEY` are available from the "Access Keys" tab on the [https://portal.aws.amazon.com/gp/aws/securityCredentials](Amazon Security Credentials page). |
| 49 | + |
| 50 | +Don't forget to reload your `.bash_profile`: |
| 51 | + |
| 52 | +{% highlight sh %} |
| 53 | +source ~/.bash_profile |
| 54 | +{% endhighlight %} |
| 55 | + |
| 56 | +## Uploading your Access Keys |
| 57 | +Some people use the public/private keys that Amazon gives them, but I find it easier to use the same public key on my laptop that I already use for things like Github and servers at work. To upload, you can use [this helpful script from Eric Hammond](http://alestic.com/2010/10/ec2-ssh-keys) (slightly modified): |
| 58 | + |
| 59 | +{% highlight sh %} |
| 60 | +keypair=macbook # Choose something that makes sense, like your computer name |
| 61 | +publickeyfile=$HOME/.ssh/id_rsa.pub # Point this to the public key you want to use |
| 62 | +regions=$(ec2-describe-regions | cut -f2) |
| 63 | + |
| 64 | +for region in $regions; do |
| 65 | + echo $region |
| 66 | + ec2-import-keypair --region $region --public-key-file $publickeyfile $keypair |
| 67 | +done |
| 68 | +{% endhighlight %} |
| 69 | + |
| 70 | +If you get an error like this, you have to wait a little while until Amazon processes your account: |
| 71 | + |
| 72 | + Client.OptInRequired: You are not subscribed to this service. Please go to http://aws.amazon.com to subscribe. |
| 73 | + |
| 74 | +## Test it All Works |
| 75 | +Once we've done all that, we can test it by doing: |
| 76 | + |
| 77 | +{% highlight sh %} |
| 78 | +ec2-describe-instances |
| 79 | +{% endhighlight %} |
| 80 | + |
| 81 | +If you don't see an error, you're all set! |
| 82 | + |
| 83 | +## References |
| 84 | +These links were helpful in getting my machine setup and writing this tutorial: |
| 85 | + |
| 86 | +* [Starting Amazon EC2 with Mac OS X](http://www.robertsosinski.com/2008/01/26/starting-amazon-ec2-with-mac-os-x/) |
| 87 | +* [Uploading Personal ssh Keys to Amazon EC2](http://alestic.com/2010/10/ec2-ssh-keys) |
| 88 | +</div> |
0 commit comments