nrgi/dcos-bootstrap

Install Mesosphere DCOS on AWS using a single command

Install Mesosphere DCOS on AWS using a single command

Read this blog post to learn more about DCOS and dcos-bootstrap!

The project's goal is to get you started with the Mesosphere DCOS Community Edition on AWS with as few steps as possible. Rather than following the official AWS setup guide, you can use the provided tooling to launch a DCOS cluster with a single command -- and delete it just as easily.

Note: Nothing here is meant to be used in production; that's what the DCOS Enterprise Edition is for.

Disclaimer: If you use this project, you are agreeing to stick to the rules of the Mesosphere DCOS Community Edition EULA.

Installation

Clone this repository and run one of the Make targets as documented below:

git clone https://github.com/mlafeldt/dcos-bootstrap
cd dcos-bootstrap/
make ...

Besides Make, you will also need Python and virtualenv.

Usage

AWS configuration

In order to bootstrap or destroy a DCOS cluster, you need to export these environment variables first:

• AWS_REGION
• AWS_ACCESS_KEY_ID
• AWS_SECRET_ACCESS_KEY

Bootstrap DCOS cluster

This will set up a working Mesosphere DCOS cluster on AWS using Ansible and CloudFormation:

make bootstrap

There are a couple of settings you might want to change:

• DCOS_CLUSTER_NAME - Name of DCOS cluster (and CloudFormation stack)
• DCOS_ADMIN_KEY - Path to public SSH key to be added to cluster instances
• DCOS_ADMIN_LOCATION - IP range to whitelist for admin access
• DCOS_WORKER_NODES - Number of worker nodes to launch
• DCOS_PUBLIC_WORKER_NODES - Number of public worker nodes to launch
• DCOS_CHANNEL - Launch stable or EarlyAccess release of DCOS
• DCOS_MASTER_SETUP - Launch DCOS in single-master or multi-master HA setup

Here's how to specify different settings:

make bootstrap DCOS_CLUSTER_NAME=dcos-test DCOS_CHANNEL=EarlyAccess DCOS_WORKER_NODES=10

Open DCOS web interface

After running make bootstrap, you can open the fancy DCOS web interface in your browser:

make dashboard

Use DCOS CLI

After bootstrapping DCOS, you can also use the ./dcos script to remotely manage your cluster. The script is a convenience wrapper around the dcos tool provided by Mesosphere. Run ./dcos without parameters to get a list of all available commands.

Install Kubernetes

This will deploy Kubernetes on top of DCOS:

make kubernetes

Afterwards, run the kubectl subcommand to control the Kubernetes cluster manager. For example:

./dcos kubectl run nginx --image=nginx

Destroy DCOS cluster

When you no longer need your cluster, you can delete it this way:

make destroy

In case you changed the default cluster name:

make destroy DCOS_CLUSTER_NAME=...

Sync CloudFormation templates

This will download the current CloudFormation templates provided by Mesosphere from S3 to cloudformation/. Useful for inspection and for keeping track of infrastructure changes.

make sync