Kublr Platform on Amazon Web Services

Prerequisites

Install Kublr-in-a-Box. Please refer to Installation Guide for Kublr-in-a-Box.

To deploy a cluster in your AWS account with Kublr, you’ll need to create an AWS policy and an AWS API Access Key. Please refer to Register AWS Policy, create User and Create API Credentials.

Overview

This document describes the steps necessary to deploy the Kublr Platform in an Amazon Web Services infrastructure. It contains the following steps:

  1. Deploy Kublr Platform to AWS infrastructure.
  2. Open deployed Kublr Platform.
  3. (Optional) Setup custom DNS name for Kublr Platform.

Connect AWS and Kublr

  1. Log into Kublr using your credentials.
  2. Click on the Credentials menu in the left navigation menu bar. Credentials
  3. Click Add Credentials Add Credentials
  4. Under credential type, select AWS Credentials.
  5. Enter Credentials Name (e.g. Test).
  6. Enter Access Key from AWS Management Console / IAM (see above).
  7. Enter Secret Key from AWS Management Console / IAM (see above).
  8. Click Save Credentials.
  9. “Credentials have been successfully created” popup appears.
  10. Click to verify if credentials are valid and ready to be used. Verify Credentials Verify Credentials Success

Deploying Kublr Platform to AWS infrastructure

  1. Click on Cluster Menu in the left navigation menu bar. Cluster Menu
  2. Click on Add Kublr Platform or Deploy Full Kublr Platform. Add New Cluster
  3. You may see short Kublr Platform description. Add New Cluster
  4. Enter Kublr Platform name.
  5. Select Provider: Amazon Web Services and region. AWS Provider
  6. Select credentials created and/or saved on previous step. Credentials
  7. Select operating system to be used for Kublr cluster instances. Select OS
  8. Select number of master nodes and instance type. Select Instance Type
  9. Select number of worker nodes and instance type. Select Word Nodes
  10. Select credentials for accessing newly deployed Kublr platform. Credentials
  11. Click Confirm and Install. A “congratulations” box will appear “Your cluster is being created. It might take a few minutes.”.

Opening deployed Kublr Platform

The Kublr Platform creation may take up to 30 minutes to complete.

  1. Once it’s done, on the Clusters page you will see: Kublr Platform
  2. Click on “Open Kublr Platform” button to open Kublr platform.
  3. Please allow it to use self-signed SSL certificate. SSL Certificate error
  4. Sign In to the Kublr Platform using the admin Username and Password provided while creating Kublr Platform above.

Now you can use Kublr Platform!

(Optional) Setting up custom DNS name for Kublr Platform

This optional step is for if you want a user-friendly DNS name such as https://kublr.example.com/ instead of the default loadbalancer address, which looks like “https://a3730363410f511e8bfd502a4587192e-67484441.us-east-1.elb.amazonaws.com/".

In order to do this, please create a new DNS A record with type Alias for kublr.example.com pointing to LoadBalancer DNS Name.

Instructions on how to setup SSL certificate for this domain are provided in the article: Ingress TLS/SSL Setup.


Questions? Suggestions? Need help? Contact us.