We are bringing the best of Tectonic to Red Hat OpenShift to build the most secure, hybrid Kubernetes application platform.
Tectonic v1.6.4 does not include an Installer binary for Windows. Windows users can install Tectonic by running an Installer container with Docker Community Edition (CE). This document describes how to use Docker CE on Windows to run Tectonic Installer to create Tectonic clusters on supported cloud providers or physical hardware.
This document does not describe deploying Tectonic clusters on Windows hosts.
Tectonic Installer requires the License and Pull Secret provided with a CoreOS account. To obtain this information and up to 10 free nodes, create a CoreOS account.
Go to https://account.coreos.com/login, and click Sign Up.
Check your inbox for a confirmation email. Click through to accept the terms of the license, activate your account, and be redirected to the Account Overview page.
Click "Free for use up to 10 nodes" under Tectonic. Enter your contact information, and click Get License for 10 nodes.
Once the update has processed, the Overview window will refresh to include links to download the License and Pull Secret.
Install the Docker Community Edition for Windows. Docker for Windows transparently uses a Hyper-V Linux virtual machine to run the Docker engine. Windows 10 Professional is required.
Type cmd
in the Windows menu search box and press the Enter key. A new Windows command prompt opens.
Issue the following command to fetch and run the Tectonic Installer container image from the Quay registry:
docker run --rm -p 4444:4444 -it quay.io/coreos/tectonic-installer:1.6.4-tectonic.1 /go/src/github.com/coreos/tectonic-installer/installer/bin/linux/installer -open-browser=false -address 0.0.0.0:4444
The status of the image download in progressively printed in the command window. Once Tectonic Installer is downloaded and running, Starting Tectonic Installer on 0.0.0.0:4444
will be reported.
Direct a web browser on the Windows host to the URL http://127.0.0.1:4444
. The Tectonic Installer GUI is shown. Proceed through the installation according to the instructions for the target provider, such as AWS or Bare Metal.
Installation requires the CoreOS License and Pull Secret described in Create a CoreOS account above. Be certain to create an account and enable the 10 free nodes before launching Tectonic Installer.
Once the cluster is installed, Installer will display a success message and a large green button labeled Download assets. Click this button to download the cluster's assets, which include configuration and authentication files, used for subsequent cluster infrastructure administration – for example, to destroy clusters to free their resources.
At the last Installer step, follow the link to Tectonic Console to use the new cluster. Check out the Tectonic Tutorials to learn how to run, replicate, and scale a simple application on the new cluster, and advance from there to more complex applications and concepts.
Deleting a cluster is referred to as "destroying" it, from the destroy
subcommand. To destroy a cluster when using a Windows/Docker CE host, the Tectonic Installer container will again be used, but directly on the command line with Terraform commands, rather than a browser-based GUI. Most of the commands below are invoked within the executing container.
Ensure the cluster's assets.zip
file downloaded from Tectonic Installer is present in the Windows host's Downloads directory, from where the docker run
command below expects to connect it to the Installer container.
Type cmd
into the Windows menu search box and press the Enter key. A new command prompt window opens.
At the Windows command prompt, issue the command:
docker run --rm -it -v %USERPROFILE%/Downloads:/Downloads quay.io/coreos/tectonic-installer:1.6.4-tectonic.1 bash
The Installer container executes and presents a bash
shell prompt within the container.
Replace the values in angle brackets <...>
with the appropriate AWS credentials.
$ export AWS_ACCESS_KEY_ID=<ACCESSKEYID>
$ export AWS_SECRET_ACCESS_KEY=<SECRETACCESSKEY>`
The environment variable PROJECT_DIR
is already set in the container shell for convenience.
$ unzip -o /Downloads/assets.zip -d $PROJECT_DIR/installer/bin/linux/clusters/
$ cd $PROJECT_DIR/installer/bin/linux/clusters/*
$ TERRAFORM_CONFIG=$(pwd)/.terraformrc terraform get
$ TERRAFORM_CONFIG=$(pwd)/.terraformrc terraform destroy --force