Skip to content

Latest commit

 

History

History
93 lines (49 loc) · 3.85 KB

README.md

File metadata and controls

93 lines (49 loc) · 3.85 KB
Raw

Consul Labs

This repository contains some environments I created while getting acquainted with Consul (https://www.consul.io/).

Try it yourself

The only two requirements to try the labs are

You can install them following the instructions provided on their respective websites.

Once the requirements are installed in your system you can try one of the labs by using the following commands:

git clone https://github.com/danielehc/consul_labs
cd consul_labs/consul_dev_clusterXYZ
vagrant up

What are the labs doing

  • Consul Dev Cluster 1 - Basic Cluster

    Spins up a simple Consul cluster with 3 servers and 2 agents

  • Consul Dev Cluster 2 - Services and HealthChecks

    Spins up a Consul cluster with 3 servers and 3 agents. The 3 agents do the following:

    • Agent 1: Redis (https://redis.io/) server instance to be used by the other agents. Service and healthcheck are registered to Consul.
    • Agent 2: Simple bash application incrementing a value in Redis
    • Agent 3: Simple Go (https://golang.org/) application incrementing a value in Redis

  • Consul Dev Cluster 3 - GO Webapp + Reverse Proxy

    Spins up a Consul cluster with 3 servers and 2 agents. The agents do the following:

    • Agent 1: Redis server instance to be used by the other agents. Service and healthcheck are registered to Consul.
    • Agent 2:
      • Go web application (listening on port 8080) incrementing a value in Redis everytime a page is visited. The application is registered in Consul as a service and an healthcheck is present.
      • NGINX (https://www.nginx.com/) acts as a reverse proxy for the Go web application. The web server is registered in Consul as a service and an healthcheck is present.

  • Consul Dev Cluster 4 - Consul Template

    Spins up a Consul cluster with 3 servers and 4 agents. The agents do the following:

    • Agent 1: Redis server instance to be used by the other agents. Service and healthcheck are registered to Consul.
    • Agent 2 and 3:
      • Two instances of the Go web application (listening on random port picked at startup) incrementing a value in Redis everytime a page is visited. The applications are registered in Consul as a service and an healthcheck is present.
    • Agent 4: NGINX acts as a reverse proxy and load balancer for the Go web application. The web server is registered in Consul as a service and an healthcheck is present. The LB configuration is changed automatically based on the apps random ports and is achieved using Consul Template (https://github.com/hashicorp/consul-template)

  • Consul Dev Cluster 5 - ACL

    Same configuration as Consul Dev Cluster 4 but with ACL enabled.

    In this case only Agent 1 (Redis server instance) is deployed.

  • Consul Dev Cluster 6 ACL + Encryption

    Same configuration as Consul Dev Cluster 4 but with ACL and Encryption enabled.

    In this case only Agent 1 (Redis server instance) is deployed.

    ℹ️ Check README for Consul Dev Cluster 6 to get prerequisite steps to have it running.

  • Consul Dev Cluster 7 - Multiple DC

    Same configuration as Consul Dev Cluster 4 but with Multiple DC enabled.

    In this case only Agent 1 (Redis server instance) is deployed in both data centers.

  • Terraform

    The folder contains some other projects made to replicate the Vagrant labs using Terraform (https://www.terraform.io/) to define the infrastructure.

    At the moment there is no parity between the labs and the Terraform configurations nor there is any intention to make such parity happen.

FAQ

Q: I found something wrong in your code. Why you did such a thing?

A: I am learning, most of the things here are/were completely new to me. Please be patient and open a PR in case you want to help me learn.