Skip to content

Latest commit

 

History

History
85 lines (59 loc) · 4.92 KB

quick.rst

File metadata and controls

85 lines (59 loc) · 4.92 KB

Digital Rebar Quick Start

This TL;DR only! See Full Install page for more options.

For this quick start, we assume you'll ssh to the install server. The goal is a temporary playground, not a long term install. It is possible to install different operating systems and work by remote or fully automated, but we are keeping it very simple in this guide.

Once you have the server, it should take about 20 minutes in AWS or Packet.net to complete all steps.

Base Installation (10 mins)

  1. AWS Path:

    1. Create AWS m4.large (or larger) Ubuntu instance with your SSH key.
    2. The "default" Security Group needs Port 22 (ssh), 443 & 3000 (rebar), 2375 & 2475 (docker), 4646 (chef), 8300 & 8301 (consul) and ICMP! This our recommended base, depending on your application, you'll need additional ports open or may be able to omit Docker, Chef and Consul.
    3. Connect to the server: ssh ubuntu@[ip address]

  2. Packet or B-Y-O-Server Path:

    1. Create Packet Type 1 Ubuntu Server with your SSH key
    2. Make sure your policy gives access to ports 22, 443, 3000, 2375, 2475, 4646, 8300, 8301 and ICMP.
    3. Connect to the server: ssh root@[ip address]

  3. Save your system EXTERNAL IP address: export IPA=[CIDR] (CIDR is the IP address with the /## subnet included)

  4. Install Prereqs: sudo apt-get update && sudo apt-get install git -y

  5. Get the deployment code and test for pre-reqs

    cd ~
mkdir digitalrebar
git clone https://github.com/rackn/digitalrebar-deploy digitalrebar/deploy
ln -s ~/digitalrebar/ digitalrebar/deploy/compose/digitalrebar
cd digitalrebar/deploy
echo "Checking prerequisites"
./run-in-system.sh --help
echo "let's setup Digital Rebar!"

  6. Install to local system: ./run-in-system.sh --deploy-admin=local --access=HOST --wl-docker-swarm --admin-ip=$IPA

Add --wl-kubernetes or other --wl-[workload] (see list from --help) if you'd like to play with other choices later. This script ends with the Digital Rebar admin node fully operational but without any nodes. You need to login to the Digital Rebar UI (default user/pass is rebar/rebar1) for the next step.

Troubleshooting Tip: You can see exactly what's going on using "Monitor...Annealer." If there is an error, that view provides a Retry button that often resolves simple timing issues.

Let's Add Nodes!

To keep it simple, we're using cloud servers, not local vms or physical servers. These are supported in a more complex setup.

  1. From your client, you can log on to the system using https://[external ip address]:3000. Reminders:

    1. Use External IP (same as the SSH address) with port 3000
    2. It's HTTPS, so you must accept the self-signed SSL certificate.

  2. Add a AWS Provider from the "Nodes...Providers" menu:

    1. Add a provider using your AWS Credentials. You should choose the same region as your admin is using.

  3. Add 2+ nodes from the "Nodes" menu:

    1. Add nodes from form at the top of the Nodes page. The API has additional options.

    #. Recommended: For Swarm in AWS, the "default_os" should be sufficient. It loads Ubuntu 14.014 and is mapped in many AWS regions. # In Google, you can use the single specific Centos7 with projects/centos-cloud/global/images/centos-7-v20151104. #. If you are trying other clouds or images, you need can override default_os based on provider o/s map For example: Centos 7 AMI UUID for us-west-2 is ami-d440a6e7. #. Detailed Instructions here.

  4. Allow the system to complete annealing (progress in top right corner)

Remember to delete your nodes from the Nodes page before you take the system down! There is no automatic cleanup.

Build a Docker Swarm Cluster

We are using a very basic Docker Swarm as a reference app for this quick install.

  1. Select 2+ nodes for Docker Swarm using the "Deployments...Docker Swarm Wizard":
    1. Select one node as docker-swarm-manager using the checkboxes. This node is your manager for step 4 below.
    2. Select different node(s) as docker-swarm-member using the checkboxes
    3. "Create" the proposal for the cluster from the Wizard
  2. "Commit" the porposal created by the Docker Swarm Wizard (Deployments...Docker Swarm page)
  3. Watch Digital Rebar build your cluster!
  4. Test using docker -H tcp://[ip of manager]:2475 info when it's done:
    1. Get the IP of the manager from Nodes...Nodes and looking for the address of the node you assigned as the docker-swarm-manager in step 1i.
    2. Advanced users may try docker -H tcp://[ip of manager]:2475 run -it ubuntu:latest bash to start a container