Tectonic and Kubernetes

Download and install Tectonic on AWS

Once your AWS account is activated, create a CoreOS Tectonic account, and prepare your AWS account for installation. This tutorial will cover:

Creating your CoreOS account

Preparing your AWS account for installation

Installing Tectonic using AWS

Creating a new Kubernetes cluster

Create a CoreOS account

First, sign up for a CoreOS account, which provides up to 10 free nodes of production quality Tectonic. Once completed, log in to the account to obtain the License and Pull Secret required for installation.

Click Sign Up and create an account using either your Google account or another email address.

Enter your contact information, and click Get License for 10 nodes.

Agree to the license terms.

Check your inbox for a confirmation email. Once confirmed, log in to display the account's Overview page. Click "Free for use for up to 10 nodes" under Tectonic, and add your contact information. Once the update has processed, the Overview window will refresh to display the License and Pull Secret required for installation.

Once installation is complete, access Tectonic Console through a browser window.

Create a new Kubernetes cluster

Step through Tectonic Installer to deploy the Tectonic Kubernetes distribution on a new cluster.

Choose Cluster Type

Platform

Use the pulldown menu to select the platform on which the cluster will be installed.

(This example uses use Amazon Web Services as its Platform.)

Define Cluster

Define AWS credentials and configuration options for the cluster.

AWS Credentials

To allow Tectonic to communicate with an AWS account, provide the AWS credentials.

Select Use a normal access key, or Use a temporary session token.

Use a normal access key: Copy and paste the Access Key ID and Secret Access Keys created earlier in the AWS setup process.

Use a temporary session token: CoreOS recommends that you use a temporary session token to generate temporary credentials, and protect the integrity of your main AWS credentials. Enter the Access Key Id and Secret Access Keys created during the AWS setup process.

Region: Enter the EC2 region selected during your AWS setup.

Your Access Key ID is available from the AWS console. Your Secret Access Key is available from the CSV file downloaded when creating the Access Key. See Creating an AWS account for more information.

Click Show Advanced Settings if you wish to check or change your CIDR ranges.

Console Login

Enter the email address and password that will be used to log in to Tectonic Console.

Submit

Click Submit to submit your assets and create your Kubernetes cluster. (Cluster creation may take up to 20 minutes.)

Click Advanced mode: Manually boot to validate configuration and generate assets, but not create the cluster.

If you hit permissions errors during the creation process it is likely that your IAM account does not have sufficient privileges. Review the privileges section of our AWS: Installation Requirements to get your IAM account configured correctly.

Boot Cluster

The final step in creating your Kubernetes cluster is to boot your cluster.

Start Installation

The Start Installation screen displays cluster creation in process.

Terraform apply

Resolving subdomain DNS

Starting Tectonic console

When Terraform apply and Resolving subdomain DNS are complete, click Download Assets to save your cluster assets locally. (These assets will be required if you wish to destroy your cluster in the future.)

Click Show or Save log to view or save the log generated during Terraform apply.

When Starting Tectonic Console is complete, click Next Step to continue.

Installation Complete

Click Go to my Tectonic Console to open the console and begin using Tectonic. Use the email address and password used to create your Tectonic account to log in to the Console.

Click Configure kubectl or Deploy Application to open CoreOS tutorials for these subjects.