Skip to content

Commit

Permalink
Wrote the first part of the User's Guide.
Browse files Browse the repository at this point in the history
Detailing instructions on how to start the etcd-appliance within your AWS VPC.
  • Loading branch information
feikesteenbergen committed May 6, 2015
1 parent 231cc74 commit 3eca2b7
Showing 1 changed file with 47 additions and 0 deletions.
47 changes: 47 additions & 0 deletions docs/User's Guide/Deployment
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
Prerequisites
=============

AWS
---
You will need a VPC and be allowed to create new infrastructure.

Stups
-------------
To deploy spilo to AWS you will need the tooling from [stups](http://stups.readthedocs.org/en/latest).
The gist of it is to:

* have an AWS account with enough rights for deployment
* install Python 3.4
* install `stups-mai`
* install `stups-senza`

Before going any further ensure you can login to your VPC using the `stups` tooling.

Deploying etcd using senza
==========================

Deploying etcd should be a once in a VPC-lifetime thing. We can use `senza` to deploy the etcd appliance.

Prerequisites
--------
* `stups-senza`
* A [Senza Definition](http://stups.readthedocs.org/en/latest/components/senza.html#senza-definition), use the provided `etcd-appliance` as an example.
* The Security Group defined in the Senza Definition needs to be created

Create and execute
---------
To deploy the etcd-appliance, use the following:

senza create [OPTIONS] DEFINITION VERSION HostedZone DockerImage

Example:

Argument | Value
----------------|-------
HostedZone | acid.example.com
Version | 1
DockerImage | etcd-appliance
DockerRevision | 0.1
Definition | etcd-appliance.yaml

senza create etcd-cluster.yaml 1 acid.example.com etcd-appliance:0.1

0 comments on commit 3eca2b7

Please sign in to comment.