Author: Lubos Rendek
This guide will provide all necessary steps on how to create, bundle, upload, run and connect Debian ETCH AMI on Amazon Elastic Compute Cloud (Amazon EC2). For this guide we have used a Ubuntu 9.04. However, any other Linux distribution can also be used as long as it contains java and ruby packages. For more information about Amazon EC2 read here.
This page is not in any way an affiliate to Amazon Web Services. !
apt-get install ssh debootstrap ruby
sun-java6-bin libopenssl-ruby curl
As you will see in the next sections of this guide many different files are required to successfully use Amazon's EC2 Web Services. For the sake of simplicity, we will create a directory "aws" in ~/ and store all necessary files there for a quick access. There will be three exceptions:
To begin, we need to create a disk image of size appropriate for our installation. In this case we create a disk image around 750MB big. To do that we use dd command.
dd if=/dev/zero of=debian-ami count=750 bs=1M
Output of this command we create a file called debian-ami and it will be stored in our ~/aws directory.
Before we mount this image we need to create a file system. To do this job we can use mkfs.ext3 command as follows:
mkfs.ext3 -F debian-ami
You terminal output should be similar to one below:
Now, we are almost ready to mount our new disk image. Before we do that, we need to decide where we would like to run chroot environment. In this guide we will use /chroot directory. Change to root ( super user ) and make directory with [[mkdir|mkdir]] command:
to mount the disk image from our ~/aws directory we use following command:
mount -o loop /home/linuxconfig/aws/debian-ami /chroot
To install Debian into /chroot we use debootstrap command which can be found on Debian as well as on Ubuntu. If you followed our prerequisites section the debootstrap command should be already available for you:
debootstrap --arch i386 etch /chroot/ http://ftp.debian.org
The output of this command will be quite long. The debootstrap will retrieve, validate, unpack and install all necessary packages.
At the end you should get a messagesimilar to one shown on the next terminal screen shot:
Now that we have successfully installed minimal Debian system packages, we need to chroot into this installation and do some changes. Enter chroot environment with chroot command.
This will create new password for a super user account:
NOTE:We are still in the chroot environment !
We need to edit network interfaces file to use DHCP on the boot. This command will do the trick:
echo -e 'auto lo\niface lo inet loopback\nauto eth0\niface eth0 inet dhcp' >> /etc/network/interfaces
We also need to define some mount points:
echo -e '/dev/sda1 / ext3 defaults 0 1\n/dev/sda2 swap swap defaults 0 0' > /etc/fstab
Once we would have our new AMI ready, uploaded and started we would connect to it via ssh. Therefore, we need to install ssh daemon. Use apt-get to install ssh package:
NOTE: We are still in chrooted environment
apt-get install ssh
Your chroot environment is sharing the same Internet connection with your host so everything should go smoothly. Do not worry about "Setting locale failed." warring messages.
All should be ready, so we can exit chroot environment:
and use unmount to unmount file image:
umount -l /chroot
Now it is time that we extract our account details and certificates from the amazon web site. Create ~/.ec2 directory and save there your certificates. The steps involved are described [http://developer.amazonwebservices.com/connect/kbcategory.jspa?categoryID=84 here]. Navigate to GET STARTED -> Setting up an Account. If you have private key and certificate saved, we can set environmental variable, so we do not have to refer to them with a full path when using ami and api tools:
EC2 AMI Tools and EC2 API Tools are based on java. Set environment variable for java and confirm that java is installed:
As a last thing we can also setup account number variable, access key and secret key:
NOTE: Access key, secret key and account number are randomly created for this guide to fit a real format. They are not valid! However, if you have plenty time you may try !
This part of this tutorial will explain how to setup and use EC2 AMI Tools in order to bundle and upload new AMI.
Download ami tools :
unzip ec2-ami-tools.zip to /opt:
NOTE: Use sudo or switch to root !
unzip -d /opt/ ec2-ami-tools.zip
Include ami tools to the PATH variable and EC2_HOME:
All is set up and we are ready to bundle our new Debian AMI. You will be asked "Please specify a value for arch [i386]", if left blank default is 10MB:
ec2-bundle-image -i debian-ami --cert $EC2_CERT --privatekey $EC2_PRIVATE_KEY -u $EC2_ACCNO
Previously, bundle image ami tool will create files in /tmp directory by default . This is also the place where your XML manifest for your new AMI is located. Now upload AMI:
NOTE:If bucket does not exist it will be created! Moreover, you MUST choose your own name for the bucket.
ec2-upload-bundle -b linux-debian-etch -m /tmp/debian-ami.manifest.xml -a $ACCESS_KEY -s $SECRET_KEY
This part of this tutorial will explain how to setup and use EC2 API Tools in order to register and use new AMI.
Download api tools :
unzip ec2-api-tools.zip to /opt:
NOTE: Use sudo or switch to root !
unzip -d /opt/ ec2-api-tools.zip
Include api tools to the PATH variable and EC2_HOME:
At this stage we are ready to register our new AMI. After registering, we will get AMI's id number.
NOTE:For an Amazon API tools, the path to your amazon EC2 certificate and private key are automatically extracted from the environment variables defined earlier.
Now that we have got a AMI's registered number, we can start it:
Well, AMi is running and we need to know some more information about it such as IP address or full domain name, use the instance number generated when starting AMI. ( see previous step !):
If this is not your fist AMI you probably already have your port 22 enabled. If not, run this command first before you attempt to connect to it:
ec2-authorize default -p 22
Once enabled, use shh command to connect to your new Debian ETCH AMI:
ssh root@IP-address or full-domain-name
NOTE:We retrieved the full domain name previously with ec2-describe-instances command.
To see what is happening with our instance, we can use ec2-get-console-output with combination of our instance ID:
To shut down the Amazon EC2 instance use:
To view the list of your registered Amazon Machine Images: