We’re integrating Tectonic with Red Hat OpenShift

We are bringing the best of Tectonic to Red Hat OpenShift to build the most secure, hybrid Kubernetes application platform.

Downloading and installing Tectonic on AWS

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

  • Creating your Tectonic account
  • Preparing your AWS account for installation
  • Installing Tectonic using AWS
  • Creating a new Kubernetes cluster

Creating your Tectonic account

To create your CoreOS Tectonic account:

  1. Go to https://coreos.com/tectonic.
  2. Click Get Tectonic for Kubernetes.
  3. Create an account using either your Google account or another email address.
  4. Enter your contact information, and click Get License for 10 nodes.
  5. Agree to the license terms.

You will see notice that your order is complete, with a link to your account Overview page.

The Overview page will list your license type, purchase date, and status, and provide links to the Tectonic documentation. It will also provide your Universal Software License, Docker Config (dockercfg) pull secret, and Kubernetes Secret.

Your Tectonic account has now been created!

Preparing your AWS account for installation

After activating your Tectonic account, review and complete Creating an AWS account before downloading the Tectonic Installer.

Installing Tectonic requires:

  • An Identity Access Management (IAM) account
  • An associated Access Key
  • A domain or subdomain with DNS name service at AWS Route 53
  • An AWS Route 53 EC2 SSH key pair

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.

Downloading and running the Tectonic Installer

Having completed the AWS installation requirements, you are now ready to download and run the Tectonic Installer.

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

  1. Download and run the Tectonic installer by opening a new terminal and running the following command:
    $ curl -O https://releases.tectonic.com/releases/tectonic-1.7.3-tectonic.2.tar.gz
    
  2. Verify the release has been signed by the CoreOS App Signing Key.
$ gpg2 --keyserver pgp.mit.edu --recv-key 18AD5014C99EF7E3BA5F6CE950BDD3E0FC8A365E
$ gpg2 --verify tectonic-1.7.3-tectonic.2-tar-gz.asc tectonic-1.7.3-tectonic.2-tar.gz
# gpg2: Good signature from "CoreOS Application Signing Key <security@coreos.com>"
  1. Double click the tarball to extract it, then navigate to the tectonic/tectonic-installer folder.
  2. Double click the folder for your operating system.
  3. Double click the installer to launch it.

A browser window will open the Tectonic Installer to walk you through the setup process and provision your cluster.

If you prefer to work within the terminal, extract and launch the Installer using:

tar xzvf tectonic-1.7.3-tectonic.2.tar.gz # to extract the tarball
$ cd tectonic/tectonic-installer # to change to the previously untarred directory
$ ./$PLATFORM/installer # to run the Tectonic Installer

Where $PLATFORM is linux or darwin.

Use the ./$PLATFORM/installer command to relaunch the Installer at any time. When launched, you will be given the option to Start Over, or to Continue where you left off.

Installer Pop-up

Setup should take about 10-15 minutes. If you encounter any errors, please see the AWS: Troubleshooting Installation guide.

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

Creating a new Kubernetes cluster

Step through the 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 installation will use Amazon Web Services as its Platform.)

Define Cluster

Define AWS credentials and configuration options for your cluster.

AWS Credentials

To allow Tectonic to communicate with your AWS account, provide your 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.

Cluster Info

Next, define the following attributes for your cluster:

  • Name: Name your cluster. This name will appear in the Tectonic Console.
  • Container Linux Update Channel: Select the channel for your update mechanism for Container Linux (Stable, Beta or Alpha).
  • Experimental Features: Check this box to enable operators to perform automatic updates.
  • CoreOS License and Pull Secret: Copy and paste your Universal Software License, and your dockercfg pull secret from your Tectonic account page. (https://account.tectonic.com)
  • Tags: Enter any key-value pairs you wish to add to the Cluster as tags.

Certificate Authority

Select the option to allow Tectonic to generate a Certificate Authority and key for you.

Provide a CA certificate and key in PEM format if you are managing your own PKI.

Submit Keys

Select your SSH Key from the pulldown list.

Be certain to select the SSH key you submitted while setting up your AWS EC2 Network and Security keys.

Define Nodes

Enter Node parameters specific to your cluster.

Networking

Define your networking parameters:

  • Select a Route 53 hosted zone domain for your cluster, and enter a subdomain.
  • Select your VPC type.
  • 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, 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 you 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.

NEXT: Deploying an application on Tectonic