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.
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
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
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.
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.