Virtual Event
Join us for the next HashiConf Digital October 12-15, 2020 Register for Free

Day 1: Deploy Your First Datacenter

Introduction

This collection along with the next one, Day 1: Security and Network Operations, are designed to help you deploy and secure your first datacenter. If you are deploying your first production ready datacenter, we recommend running through both collections sequentially as one "path". They will help you successfully set up and maintain a healthy datacenter, and will cover the following topics:

  • Infrastructure recommendations
  • Setting up a datacenter
  • Backing up the state of the datacenter
  • Securing the datacenter
  • Configuring Networking
  • Multiple datacenter configuration

Below you will find all of the tutorials that make up this learning path separated into their two collections Day 1: Deploy Your First Datacenter and Day 1: Security and Network Operations. If you have already deployed a production datacenter, you can skip ahead to any tutorial for reference as needed. Each tutorial has a description along with its objective to help you decide.

»Datacenter deploy

»Reference architecture

By the end of this tutorial, you will be ready to create a architecture diagram for your environment. You will be able to identify which ports should be open, select hardware sizes that meet your needs, and understand how to implement datacenter design best practices.

Reference Architecture

»Deployment guide

By the end of the tutorial, you will install and configure a single Consul datacenter. You will use the examples to create your own custom configuration files for both servers and clients. The custom configuration files will help you join agents, optimize Raft performance, enable the collection of metrics, and configure the web UI. Finally, the tutorial will detail how to configure Systemd.

Deployment Guide

»Consul as a Windows service

By the end of this tutorial, you will be able to deploy Consul as a service on Windows.

Windows

»Datacenter backups

By the end of this tutorial, you will have a backup process outlined. You will also be able to list the server data that is saved. Finally, you will understand the process for restoring from a backup.

Datacenter Backups

»Security and networking

»Gossip encryption

By the end of this tutorial, you will be able to configure gossip encryption on your Consul datacenter. Gossip communication between all agents in the datacenter can be secured with a symmetric key.

Gossip Encryption

»Securing agent communication with TLS encryption

By the end of the this tutorial, you will know how to generate certificates for your datacenter. This tutorial will cover how to create a Certificate Authority(CA), and how to generate server certificates and client certificates. Encrypting both incoming and outgoing communication is crucial for securing the datacenter.

Securing Agent Communication with TLS Encryption

»Securing Consul with ACLs

By the end of this tutorial, you will have ACLs configured on the Consul agents, servers and clients. For each step, you will be able to recognize if the process is not properly executed. Optionally, you can also configure the anonymous token and token for the UI.

Securing Consul with ACLs

»Managing ACL policies

By the end of this tutorial, you will be able to discover the minimum privileges required for any datacenter operation.

Managing ACL Policies

»DNS caching

By the end of this tutorial, you will be able to update the parameters for tuning stale reads, negative response caching, and TTL in the agent's configuration file.

DNS Caching

»Forwarding DNS

By the end of this tutorial, you will be able to setup DNS forwarding from BIND, dnsmasq, Unbound, systemd-resolved, iptables, or macOS. You will also be able to test and troubleshoot the DNS service after the initial setup.

Forwarding DNS

»Multiple datacenters: basic federation with WAN gossip

By the end of this tutorial, you will connect two datacenters using WAN gossip. This tutorial includes two methods for connecting the Consul servers, on the command line or in the agent's configuration file.

Multiple Datacenters

»Get Started

We are including a production readiness checklist in the appendix that can be used for deploying Consul. Note, this checklist is not an exhaustive list and you may need to add additional items depending on your environment.

Now that we have reviewed the tutorials in the Day 1 learning path and have a production readiness checklist, get started by either hitting the next button at the bottom of the page or select the tutorial that you are interested in.

If you encounter any technical difficulties while working through the tutorials or have any feedback please send an email to the Consul mailing list.