We are bringing the best of Tectonic to Red Hat OpenShift to build the most secure, hybrid Kubernetes application platform.
The Tectonic Installer can be used to easily create Terraform assets and configuration files used to provision a Tectonic cluster via the terminal.
This process may be used to create multiple clusters with similar configurations, to deploy a single cluster multiple times, or to quickly generate cluster templates for distribution to your team.
Assets generated by Tectonic Installer allow you to make changes to the underlying infrastructure for a cluster. They do not provide support for changes to Tectonic components run in the cluster (such as etcd or clair). Changes to the Kubernetes manifests will end your ability to auto-update.
These downloaded assets are also necessary to destroy existing clusters, once they have been deployed.
First, use Tectonic Installer to generate and download cluster assets.
Follow the instructions to initialize and configure Terraform.
In the tectonic
installer assets directory you configured in the previous step, unzip the assets.zip
archive and navigate to the folder created.
$ unzip assets.zip # creates `my-cluster_2017_05_15-13-31`
$ cd my-cluster_2017_05_15-13-31
$ ls
config.tf license.txt logs modules platforms pull_secret.json terraform.tfvars
Then, edit terraform.tfvars
to customize your deployment.
Once customized, use terraform plan
to test your deployment, then terraform apply
to deploy your cluster.
$ terraform plan -var-file=terraform.tfvars platforms/aws
$ terraform apply -var-file=terraform.tfvars platforms/aws
If you're having problems at this step, make sure you've configured Terraform correctly. If you continue to have problems, check out the Troubleshooting Tectonic Installer FAQ.
When complete, your Tectonic cluster will be ready for access.
If you wish to use downloaded assets to deploy multiple clusters, first make a copy of the directory for each planned instance. Then edit each directory's terraform.tfvars
, and deploy individually.
For example, to create two matching clusters in two different regions, first create two copies of the assets folder. Edit terraform.tfvars
in one directory to change one node's tectonic_aws_region
value to a different region, and edit the subnets to reflect the new region. Leave the second directory's terraform.tfvars
file in its default state.
Then, run terraform plan
and terraform apply
on each terraform.tfvars
file in turn to deploy your Tectonic clusters.
Tectonic Console will be running after the containers have downloaded. Access Console at the DNS name configured in your variables file.
Inside of the generated/
folder you should find any credentials, including the CA if generated, and a kubeconfig. You can use this to control the cluster with kubectl:
$ export KUBECONFIG=generated/auth/kubeconfig
$ kubectl cluster-info
assets.zip also includes terraform.tfstate
, which is necessary to destroy existing clusters. For more information on using Terraform to destroy existing clusters, see Uninstall Tectonic.