How to Install Supergiant on AWS EC2

The goal of this walkthrough is to help you provision Supergiant on an Amazon Web Services EC2 test server. By the end of this tutorial, you will be ready to deploy your first App on Supergiant. Supergiant is the easiest open-source container orchestration system to install and use. AWS hardware usage rates apply.

You won’t need to download any source code or binaries. We’ve packaged everything into an Amazon machine image for AWS; however, if you want to take a look at the source, it’s all on GitHub.

Supergiant Github

Prepare for Launch

Sign into your AWS console and prepare to launch a new EC2 instance through a series of wizarding steps.

Step 1

From the EC2 console, push the Launch Instance button, choose Community AMIs, and search for “supergiant“. You should be able to find the latest stable Supergiant AMI release quickly.

Note: when we release new versions of Supergiant, the AMI ID will change and will be different for each region, but we will always release new AMIs under the name “Supergiant”.

Supergiant Amazon AMI

Search for the latest release of supergiant AMI, then press Select to choose your instance type.

Step 2

Supergiant creates a dashboard that helps you manage any number of Supergiant Kubernetes instances. We recommend a single m4.large instance to hold the latest version of Supergiant, but you can experiment with what works best for you. After you select your instance type, click Next: Configure Instance Details.

Supergiant-AWS: choose machine type

Select your instance  type, then click Next: Configure Instance Details.

Step 3

There’s nothing we need to change, here. You may select to change whatever you like, but the defaults are sensible enough. When you’ve made your changes (or not), click Review and Launch.

Supergiant at AWS: configure instance

Configuring these settings are out of the scope of this tutorial. To simply get started, we can leave everything here, as-is. Click Review and Launch.

Step, er… 7

The wizard skips a few steps, but hey, today that works for us. We only need to change one thing we skipped over. We need to take a step back to allow HTTP and HTTPS traffic. Click Edit security groups on this screen.

Supergiant-AWS: edit security groups

Click Edit security groups to add rules to allow HTTP and HTTPS traffic.

Add Security

The Dashboard will listen for HTTP traffic on port 9090 when it’s ready, so we need to click Add Rule to allow HTTP traffic to that port.

0.8.x UPDATE: The Dashboard now listens for HTTP traffic on port 80.

0.9.x UPDATE: For better security, Supergiant now creates a self-signed certificate and serves the dashboard over HTTPS on port 443.

Supergiant-AWS: add security group

Click Add Rule and make the Type HTTP and the Port Range 80. Click Add Rule one more time and make the Type HTTPS and the Port Range 443. I’ve changed the Source to My IP in this example. Click Review and Launch when done.

Review and Launch Supergiant

It’s time to launch. If you want to use tags to identify this EC2 server, now is the time to add them. When you’re emotionally prepared for all the excitement, click Launch, and you will be asked what key pair you wish to use. Select whatever option you prefer.

Supergiant-AWS: review and launch Supergiant

Review changes, add tags if you want them, and click Launch.

Access the Dashboard

To access the dashboard, we will need to access the server’s logs to get the randomly-generated dashboard password. From the Launch Status page, click on the server’s ID to go to the EC2 console with only your new instance visible in the list. With the instance selected, click Actions > Instance Settings > Get System Log and then find your Supergiant Login Info, close to the bottom of the log.

Supergiant-AWS: get logs

With the instance selected, click Actions > Instance Settings > Get System Log.

Supergiant-AWS: system log 2

Find your Supergiant Login UserName and Password near the bottom of the System Log.

Use your instance’s public DNS or IP address to access it with a web browser on port 80, then use the UserName and Password from the System Log to authenticate. You’re now ready to administrate Kube clusters using your Supergiant dashboard!

Access the Supergiant Community

Remember, if you have trouble, or if you want to talk to other users about how they’re making the most of Supergiant, our community hangs out on the Supergiant public Slack channel.

We would love any feedback you want to leave. We’re working hard to add features that our community wants most, so all your comments are helpful to us. Visit our Slack channel, and post your questions and comments.

Where-To Next?

This tutorial is first in a series to help you get started with Kubernetes using Supergiant. From here we recommend checking out the following tutorials:

Subscribe to our newsletter