Skip to content

Latest commit

 

History

History
85 lines (62 loc) · 2.48 KB

aws_kubernetes.md

File metadata and controls

85 lines (62 loc) · 2.48 KB
Raw

Installing Romana on AWS EC2 with Kubernetes

The setup described below has been tested on Ubuntu 14.04 LTS, but should work similarly on other Linux or Mac OS X environments. You may need to install additional development tools.

If you do not wish to install additional tools in your host, you can create a VM and execute the installation steps from there.

Prepare

To run this installation, you will need

  • an AWS account. You can create one at http://aws.amazon.com
  • credentials for an AWS IAM User/Role that permits creating EC2 instances
  • ansible v2.1 or higher, and supporting python tools / libraries

Set up Ansible

# Ubuntu
sudo apt-get install git python-pip python-dev
sudo pip install ansible boto awscli netaddr

# OS X
sudo easy_install pip
sudo pip install ansible boto awscli netaddr

Set up AWS tools

aws configure

This will prompt you for your AWS Access Key ID, AWS Secret Key ID and Region.

AWS Access Key ID [None]: A*******************
AWS Secret Access Key [None]: ****************************************
Default region name [None]: us-west-1
Default output format [None]:

(Optional) Set up EC2 Key Pair

If the servers will be accessed by people using an EC2 Key Pair, apply the additional configuration step.

# Configure 'shared-key-1' as the EC2 Key Pair used by the installer
echo "shared-key-1" > ~/.aws/ec2_keypair

Install

Check out the Romana repository and run the installer

git clone https://github.com/romana/romana
cd romana/romana-install
./romana-setup -p aws -s kubernetes install

See the romana-setup page for details about the command-line options.

The EC2 installation takes 20-25 mins to complete, and creates a Kubernetes cluster with two nodes. When installation is complete, information about the cluster should be provided.

Kubernetes Summary
==================

Master
------
IP: 52.xx.yy.zz
ssh -i /.../romana/romana-install/romana_id_rsa ubuntu@52.xx.yy.zz

Minions
-------
ssh -i /.../romana/romana-install/romana_id_rsa ubuntu@54.zz.yy.xx

You can now proceed to Using Romana on Kubernetes.

Uninstall

From the same directory, you can perform an uninstall

./romana-setup -p aws -s kubernetes install

This will destroy the Kubernetes cluster.