AWS: Installation

Preparation

Check the requirements doc to see what's needed. The short version:

a CoreOS account

an IAM account

an associated SSH key

a domain or subdomain with DNS name service at AWS Route53.

Tectonic will create a new AWS Virtual Private Cloud (VPC), or you can select an existing VPC. To use an existing VPC, see the existing VPC requirements.

Create a CoreOS account

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.

Download and run Tectonic Installer

Make sure a current version of either Google Chrome or Mozilla Firefox is set as the default browser on the workstation where Installer will run.

Download the Tectonic installer.

wget https://releases.tectonic.com/releases/tectonic_1.9.6-tectonic.1.zip unzip tectonic_1.9.6-tectonic.1.zip cd tectonic_1.9.6-tectonic.1

Run the Tectonic Installer for your platform.

For macOS users:

$ ./tectonic-installer/darwin/installer

For Linux users:

$ ./tectonic-installer/linux/installer

For Windows users, see Running Tectonic Installer in a Docker container on Windows.

A browser window will open to begin the GUI installation process.

Selecting a platform in Tectonic Installer

Install Tectonic

Be sure to read the installation requirements, which include a section on privileges for your AWS credentials, as well as the known issues section in the Troubleshooting guide before you install.

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.

Follow the on-screen instructions to provision your cluster. This process should take about 10-15 minutes.

When prompted, click Download assets to save all assets generated during the Tectonic Installer process. These assets include configuration files that will allow you to repeat your cluster set up manually, and the terraform.tfstate file, which is required to delete your cluster, when desired.

Once complete click Go to my Tectonic Console to launch the Console, and begin interacting with your cluster.

If you encounter any errors check the troubleshooting documentation.

Use Tectonic Console

Viewing deployment pods in Tectonic Console

Now you are ready to access Tectonic Console, configure kubectl , and deploy your first application to the cluster. A kubeconfig with the appropriate configuration for kubectl is available for download in the Tectonic Console.

For those new to Tectonic and Kubernetes, the Tectonic Tutorials provide walk through instructions on getting started.