/tectonic-installer

Install a Kubernetes cluster the CoreOS Tectonic Way: HA, self-hosted, RBAC, etcd Operator, and more

Primary LanguageHCLApache License 2.0Apache-2.0

Tectonic Installer

Tectonic is built on pure-upstream Kubernetes but has an opinion on the best way to install and run a Kubernetes cluster. This project helps you install a Kubernetes cluster the "Tectonic Way". It provides good defaults, enables install automation, and is customizable to meet your infrastructure needs.

Goals of the project:

  • Installation of Self-Hosted Kubernetes Cluster
  • Secure by default (use TLS, RBAC by default, OIDC AuthN, etcd)
  • Automatable install process for scripts and CI/CD
  • Deploy Tectonic on any infrastructure (Amazon, Azure, OpenStack, GCP, etc)
  • Runs Tectonic on any OS (Container Linux, RHEL, CentOS, etc)
  • Customizable and modular (change DNS providers, security settings, etc)
  • HA by default (deploy all Kubernetes components HA, use etcd Operator)

Note: This repo does not yet have all Tectonic Installer features imported. This will happen over the coming weeks as we are able to make some of the surrounding infrastructure public as well. This notice will be removed once the AWS and Baremetal graphical installer code has been fully integrated.

Checkout the ROADMAP for details on where the project is headed.

Getting Started

To use the installer you can either use an official release (starting March 29, 2017), or hack on the scripts in this repo.

Official releases

See the official Tectonic documentation:

Hacking

Common Usage

At a high level, using the installer follows the workflow below. See each platform guide for specifics.

Download Terraform

This repo a build of Terraform which includes required plugins and is pinned to a specific version. First, download the Terraform binaries:

$ make terraform-download

Choose your platform

The example below will use PLATFORM=azure but you can set the value to something different. Also, as you configure the cluster refer to the linked documentation to find the configuration parameters.

Initiate the Cluster Configuration

This will create a new directory build/<cluster-name> which holds all module references, Terraform state files, and custom variable files.

PLATFORM=azure CLUSTER=my-cluster make localconfig

Configure Cluster

Set variables in the terraform.tfvars file as needed, or you will be prompted. Available variables can be found in the config.tf and variables.tf files present in the platforms/<PLATFORM> directory.

Terraform Lifecycle

Plan, apply, and destroy are provided as Make targets to make working with the build directory and custom binary easier.

PLATFORM=azure CLUSTER=my-cluster make plan
PLATFORM=azure CLUSTER=my-cluster make apply
PLATFORM=azure CLUSTER=my-cluster make destroy