How to Deploy Hossted Kubernetes App on AWS

This tutorial details how to deploy Hossted’s fully supported K8s apps from the AWS Marketplace and connect them to the Hossted Platform, so that it is ready for use:

1. Deploying the K8s App on AWS

Navigate to the app’s page on AWS Marketplace.
Choose the “View Purchase Options” button. 
Click the “Continue to Configuration” button. 
Choose the fulfillment option “Helm Chart” > Helm chart delivery option > Software option. After that, click on the “Continue to Launch” button.
Follow one of the flows below, depending on whether you already have a cluster or need to create a new one:

If you have already created a cluster, choose “Launch on an Existing Cluster” 
Follow the instructions given under this option. Both steps are mandatory.
Step 1: Create an AWS IAM role and Kubernetes service account
Step 2: Launch the software

If you do not have a cluster, choose “Launch on a New EKS Cluster with QuickLaunch” > click on the “QuickLaunch with Cloudformation” button and create your own cluster. 

Minimum recommended values for the cluster:
Instance type: t3.medium
Number of nodes: 2
The average time to create a cluster is 20-30 minutes.

2. Connecting the Cluster Locally

To connect the cluster with the Hossted Platform you need to first access the cluster locally. If you have local access to your cluster, skip this step and go to the “Access your application” step.

To connect your cluster locally you have to:

Upload or update AWS CLI. How to install/update AWS CLI.

Run the command in the CLI

CLUSTER_NAME – the name of your AWS cluster (EKS cluster name)
YOUR REGION – the name of your AWS region

aws eks update-kubeconfig --name CLUSTER_NAME --region YOUR REGION

Example:

aws eks update-kubeconfig --name Keycloak_cluster --region us-east-1

If you see in the CLI “Unable to locate credentials. You can configure credentials by running aws configure”, It means you need to authorise through AWS Identity and Access Management (IAM). Ones you authorice through IAM get back to this guideline. How to authorise through AWS Identity and Access Management (IAM).

If you do not see it you can move further to Access your application.

3. Access your application

To access your deployed application and get the application credentials, connect it with the Hossted Platform.

Follow this link to sign up or sign in to the Hossted Platform.
Click on “Clusters” > “Add the first cluster”.
Open your CLI and run the first command. Wait for the command to execute and run the second command.
At your CLI, choose the “Cluster” you have installed locally > “Organization” > choose “yes” in the four following questions.
Get back to the platform and wait within 30-40 minutes until the installation process finishes and all the monitoring data will be collected in the platform.
To access the application in the “Clusters” section > choose “cluster” > choose “your app” > click the “Access info” > copy the link and insert it in the search line > use the credentials below and sign in your application.