SEJeff / tectonic-installer

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

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)

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

Getting Started

To use a tested release on an supported platform, follow the links below.

To hack or modify the templates or add a new platform, use the scripts in this repo to boot and tear down clusters.

Official releases

See the official Tectonic documentation:

• AWS using a GUI [stable]
• AWS using Terraform CLI [stable]
• Bare metal using a GUI [stable]
• Bare metal using Terraform CLI [stable]

Hacking

In order to successfully build this project, you must first of all place it according to the Go workspace convention, i.e. at $GOPATH/src/github.com/coreos/tectonic-installer. If you don't set $GOPATH, it should by default be at $HOME/go.

Requirements

To build Tectonic Installer, you will need to install the following requirements:

Terraform

Tectonic Installer includes and requires a specific version of Terraform. This is included in the Tectonic Installer tarball. See the Tectonic Installer release notes for information about which Terraform versions are compatible.

Download and install the included Terraform binary for your OS or use your favorite package manager.

Yarn

You need the Yarn JavaScript package manager. If you're on OS X, you can install it via Homebrew: brew install yarn.

Common Usage

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

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.

• PLATFORM=azure Azure via Terraform [alpha]
• PLATFORM=openstack OpenStack via Terraform [alpha]

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. Examples for each platform can be found in the examples 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

Tests

Tests are run for all approved pull requests via Jenkins. See the Jenkinsfile for details.

Tests can be run locally by:

AWS

export PLATFORM="aws"
export AWS_REGION="us-east-1"
export TF_VAR_tectonic_cluster_name=my-smoke-test
export TF_VAR_tectonic_license_path=/path/to/license.txt
export TF_VAR_tectonic_pull_secret_path=/path/to/pull-secret.json

make localconfig
ln -sf ../../test/aws.tfvars build/${TF_VAR_tectonic_cluster_name}/terraform.tfvars
make plan
make apply
make destroy