Once your AWS account is activated, you can create your CoreOS Tectonic account, and prepare your AWS account for installation. This tutorial will cover:
To create your CoreOS Tectonic account:
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!
After activating your Tectonic account, review and complete Creating an AWS account before downloading the 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 the Google Chrome or Mozilla Firefox browser is set as the default on the workstation where the installer will run.
$ curl -O https://releases.tectonic.com/releases/tectonic_1.6.10-tectonic.1.tar.gz
$ gpg2 --keyserver pgp.mit.edu --recv-key 18AD5014C99EF7E3BA5F6CE950BDD3E0FC8A365E $ gpg2 --verify tectonic_1.6.10-tectonic.1-tar-gz.sig tectonic_1.6.10-tectonic.1-tar.gz # gpg2: Good signature from "CoreOS Application Signing Key <firstname.lastname@example.org>"
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
./$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 the Tectonic Console through a browser window.
Step through the 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 installation will use Amazon Web Services as its Platform.)
Define AWS credentials and configuration options for your cluster.
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.
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 your 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, 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 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.