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
These instructions can be used for the official stable platforms listed above, and for the following alpha/beta platforms:
Go and Source
Install Go if not already installed.
Then get the Tectonic Installer source code:
go get github.com/coreos/tectonic-installer
cd $(go env GOPATH)/src/github.com/coreos/tectonic-installer
Terraform
The Tectonic Installer releases include a build of Terraform. See the Tectonic Installer release notes for information about which Terraform versions are compatible.
The latest Terraform binary may not always work as Tectonic Installer, which sometimes relies on bug fixes or features not yet available in the official Terraform release.
Yarn (optional)
The Yarn JavaScript package manager is required for building the frontend code. On OS X, install via Homebrew: brew install yarn
.
Common Usage
Choose your platform
First, set the PLATFORM=
environment variable. This example will use PLATFORM=azure
.
PLATFORM=azure
Azure via Terraform [alpha]PLATFORM=openstack
OpenStack via Terraform [alpha]PLATFORM=vmware
VMware via Terraform [alpha]
Initiate the Cluster Configuration
Using make create a new directory build/<cluster-name>
to hold all module references, Terraform state files, and custom variable files.
PLATFORM=azure CLUSTER=my-cluster make localconfig
Configure Cluster
Set variables in the build/<cluster-name>/terraform.tfvars
file as needed. Available variables are found in the platforms/<PLATFORM>/config.tf
and platforms/<PLATFORM>/variables.tf
files.
Examples for each platform can be found in the examples directory.
Terraform Lifecycle
Plan, apply, and destroy are provided as make
targets to ease the build directory and custom binary complexity.
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,CLUSTER}=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