Once your AWS account is activated, create a CoreOS Tectonic account, and prepare your AWS account for installation. This tutorial will cover:
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.
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.
After activating your Tectonic account, review and complete Creating an AWS account before downloading Tectonic Installer.
Installing Tectonic requires:
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.
Having completed the AWS installation requirements, you are now ready to download and run the Tectonic Installer.
Make sure a current version of either Google Chrome or Mozilla Firefox is set as the default browser on the workstation where the installer will run.
$ curl -O https://releases.tectonic.com/releases/tectonic_1.7.9-tectonic.1.tar.gz $ curl -O https://releases.tectonic.com/releases/tectonic_1.7.9-tectonic.1.tar.gz.sig
$ gpg2 --keyserver pgp.mit.edu --recv-key 18AD5014C99EF7E3BA5F6CE950BDD3E0FC8A365E $ gpg2 --verify tectonic_1.7.9-tectonic.1.tar.gz.sig tectonic_1.7.9-tectonic.1.tar.gz # gpg2: Good signature from "CoreOS Application Signing Key <firstname.lastname@example.org>"
A browser window will open Tectonic Installer to walk you through the setup process and provision your cluster.
When prompted, log in to your CoreOS account to obtain the License and Pull Secret, as described in Create a CoreOS account above.
If you prefer to work within the terminal, extract and launch the Installer using:
tar xzvf tectonic_1.7.9-tectonic.1.tar.gz # to extract the tarball $ cd tectonic_1.7.9-tectonic.1/tectonic-installer # to change to the previously untarred directory $ ./$PLATFORM/installer # to run Tectonic Installer
./$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.
Setup should take about 10-15 minutes. If you encounter any errors, please see the AWS: Troubleshooting Installation guide.
Once installation is complete, access Tectonic Console through a browser window.
Step through Tectonic Installer to deploy the Tectonic Kubernetes distribution on a new cluster.
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 AWS credentials and configuration options for the cluster.
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.
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.
Next, define the following attributes for the cluster:
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.
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.
Enter Node parameters specific to your cluster.
Define your networking parameters:
Enter the email address and password that will be used to log in to Tectonic Console.
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.
The final step in creating your Kubernetes cluster is to boot your cluster.
The Start Installation screen displays cluster creation in process.
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.
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.