melozo/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:

• Install Kubernetes clusters
• Secure by default (uses TLS, RBAC by default, OIDC AuthN, etcd)
• Automatable install process for scripts and CI/CD
• Deploy on any infrastructure: Amazon AWS, Microsoft Azure, OpenStack, Google Cloud, bare metal
• Run on any OS: Container Linux (the default), RHEL, Ubuntu, and others
• Customizable and modular: Change DNS providers, security settings, authentication providers
• Highly Available by default: Deploy all Kubernetes components HA, use etcd Operator

Note: the project has recently undergone some rearchitecting to support our goal of providing automatic operations, most notably automatic updates, to Kubernetes clusters. The master branch of the project reflects this new design approach and currently provides support only for AWS. In order to deploy Tectonic to other platforms, e.g. Azure, bare metal, OpenStack, etc, please checkout the track-1 branch of this project, which maintains support for the previous architecture and more platforms.

Getting Started

To use a tested release on a 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]
• Azure using Terraform [stable]
• Bare metal using a GUI [stable]
• Bare metal using Terraform CLI [stable]

Hacking

These instructions can be used for AWS:

1. Build the project

   bazel build tarball

   Note: the project can optionally be built without installing Bazel, provided Docker is installed:

   docker run --rm -v $PWD:$PWD -w $PWD quay.io/coreos/tectonic-builder:bazel-v0.3 bazel --output_base=.cache build tarball

2. Extract the tarball

   cd bazel-bin
   tar -zxf tectonic.tar.gz
   cd tectonic

3. Add binaries to $PATH

   export PATH=$(pwd)/tectonic-installer/linux/:$PATH

4. Edit Tectonic configuration file including the $CLUSTER_NAME

   $EDITOR examples/tectonic.aws.yaml

5. Init Tectonic CLI

   tectonic init --config=examples/tectonic.aws.yaml

6. Install Tectonic cluster

   tectonic install --dir=$CLUSTER_NAME

7. Teardown Tectonic cluster

   tectonic destroy --dir=$CLUSTER_NAME

Tests

See tests/README.md.