| | 1 | = Amazon EC2 = |
| | 2 | |
| | 3 | Amazon's Cloud provides a flexible platform to deploy Eden scalably |
| | 4 | |
| | 5 | == Regions & Zones == |
| | 6 | Amazon supports multiple Regions in order to provide a service closest to your users. |
| | 7 | * Namespaces of Instances, Volumnes & Snapshots are unique only within a Region. |
| | 8 | * Within each Region, there are a couple of Availability Zones to allow spreading the risk across different facilities. |
| | 9 | * Volumes are located within an Availability Zone |
| | 10 | * Bandwidth transfers are free within an Availability Zone |
| | 11 | |
| | 12 | == Instance Size == |
| | 13 | * The free starter 'micro' instance is flexible as it can run both 32-bit & 64-bit Operating Systems. |
| | 14 | * The normal production 'small' instance can only run 32-bit. |
| | 15 | * Larger production instances can only run 64-bit, so can't have the exact same image used. |
| | 16 | * The community Debian Squeeze AMI seems a fine base & attached scripts turn this into an Eden instance |
| | 17 | |
| | 18 | == Instance Persistence == |
| | 19 | * EBS-backed instances have persistent storage even whilst powered down, which is very useful. |
| | 20 | * Each time you start an instance up, it will be assigned a new IP ('Public DNS') |
| | 21 | |
| | 22 | == Authentication == |
| | 23 | This can provide an early stumbling block. |
| | 24 | * Each instance created needs to start with a unique SSH keypair |
| | 25 | * When setting up an instance, be sure to safely download the private key. |
| | 26 | * In order to get the public key (needed by SecureCRT for instance) then you need to login using CLI & retireve it: |
| | 27 | {{{ |
| | 28 | ssh -l root -i private.pem <hostname> |
| | 29 | cat ~/.ssh/authorized_keys |
| | 30 | }}} |
| | 31 | SecureCRT needs the private key storing as <filename> & the public as <filename.pub> (all on one line) |
| | 32 | |
| | 33 | == CLI Management == |
| | 34 | There are extensive CLI tools available to manipulate your instances. |
| | 35 | * Java CLI for Windows/Linux |
| | 36 | * http://aws.amazon.com/developertools/351 |
| | 37 | * http://serktools.com/2009/05/19/setting-up-ec2-command-line-tools-on-windows/ |
| | 38 | * http://docs.amazonwebservices.com/AWSEC2/latest/CommandLineReference/ |
| | 39 | * Python: http://libcloud.apache.org |
| | 40 | |
| | 41 | == Growing Storage == |
| | 42 | 1Gb EBS is too small for Eden - need to grow to 3Gb |
| | 43 | {{{ |
| | 44 | # --region ap-southeast-1 |
| | 45 | set EC2_URL=https://ec2.ap-southeast-1.amazonaws.com |
| | 46 | # Stop Host |
| | 47 | ec2stop i-c75af292 |
| | 48 | # Create a snapshot |
| | 49 | ec2-create-snapshot vol-e189e88c |
| | 50 | # Create new volume from snapshot |
| | 51 | ec2-create-volume -z ap-southeast-1b --size 3 --snapshot snap-63f89d08 |
| | 52 | # Attach new volume as secondary |
| | 53 | ec2-attach-volume -i i-c75af292 vol-a9c2a3c4 -d /dev/sdb1 |
| | 54 | # Start Host |
| | 55 | ec2start i-c75af292 |
| | 56 | ec2-describe-instances |
| | 57 | # Login (Remember different IP!) |
| | 58 | mkdir /mnt/data |
| | 59 | echo '/dev/xvdb1 /mnt/data ext3 defaults,noatime 0 0' >> /etc/fstab |
| | 60 | mount /mnt/data |
| | 61 | resize2fs /dev/xvdb1 |
| | 62 | umount /mnt/data |
| | 63 | # Stop Host |
| | 64 | ec2stop i-c75af292 |
| | 65 | # Unattach volumes |
| | 66 | ec2-detach-volume -i i-c75af292 vol-e189e88c |
| | 67 | ec2-detach-volume -i i-c75af292 vol-a9c2a3c4 |
| | 68 | # Attach volume as boot |
| | 69 | ec2-attach-volume -i i-c75af292 vol-a9c2a3c4 -d /dev/sda1 |
| | 70 | # Start Host |
| | 71 | ec2start i-c75af292 |
| | 72 | ec2-describe-instances |
| | 73 | # Login (Remember different IP!) |
| | 74 | df -h |
| | 75 | }}} |
