Tectonic v1.6.4 (and later) 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.
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.9.6-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.
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.9.6-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