Create a Kublr platform in Azure

Prerequisites

Installed Kublr Demo/Installer. Please refer to Installation Guide for Kublr Demo/Installer.

To deploy a cluster in your Azure account with Kublr, you’ll need to create an Azure API credentials. Please refer to Creating Azure API credentials.

Overview

This document describes the necessary steps needed to deploy the Kublr Platform in a Microsoft Azure infrastructure. It contains the following main steps:

  1. Deploying the Kublr Platform to Microsoft Azure infrastructure
  2. Opening deployed Kublr Platform
  3. (Optional) Setting up a custom DNS name for the Kublr Platform

Connecting Microsoft Azure and Kublr

Procedure is the same as for creating an Azure k8s cluster.

Deploying Kublr Platform to Azure Infrastructure

Fully functional Kublr Platform includes all Kublr features (IAM, RBAC, centralized Logging/Monitoring and etc). Suitable for building you own Kubernetes cluster management platform.

See some platform parameters description here.

To add a new platform:

  1. On the left menu, click Clusters.
  2. Click Add Cluster. Add New Cluster The Select Installation Type dialog is displayed.
  3. In the Select Installation Type dialog, click Platform.
  4. Click Continue Setup. Installation Type - Platform The DEPLOY FULL KUBLR PLATFORM dialog is displayed.
  5. In the dialog, in the upper (Planning) section, set general parameters of your platform as described below.
  6. Set Provider to “Microsoft Azure”.
  7. From the Credentials list, select previously created Azure credentials.

    If credentials were not created previously, use Add New Credentials.

  8. Specify Cluster Name.

  9. Set:

    • Region
    • Kubernetes Version AWS-Add Platform-General Settings
  10. If necessary, expand the Advanced Options and set them.

  11. Scroll to the Master Configuration section.

  12. Specify the parameters of the master node(s) of your platform as described below.

  13. Select Instance Type from the list.

  14. From the Masters list, select the number of master or management nodes in correspondence with the selected Instance Type.

  15. From the Operating System list, select the host OS for virtual machines in the platform. AWS-Add Platform-Master Configuration

  16. Optionally, select Public SSH Key from the list.

  17. If necessary, expand the Advanced Options and set them.

  18. Scroll to the Instance Group section (default name group1).

  19. Specify the parameters of the work node(s) in your group as described below.

  20. Select Instance Type from the list.

  21. In the Nodes field, set the number of work nodes.

  22. From the Operating System list, select the host OS for virtual machines in the cluster.

  23. If necessary, set your own name for the instance group.

    Note You can also clone or delete the current instance group, or add another one. Instance Group-Operations

  24. If necessary, expand the Advanced Options and set them.

  25. Scroll to the Features section.

  26. In the Control Plane sub-section:

  27. Specify password for accessing the platform.

  28. In the Centralized Logging sub-section:

  29. In Master Nodes, specify the number of master nodes for ElasticSearch cluster.

  30. Set:

    • Number of Data nodes
    • Number of Client nodes
  31. If necessary, select or clear the Persistence enabled option.

    If selected, optionally set Data node disk size.

  32. In the Centralized Monitoring sub-section:

  33. For Prometheus, select or clear the Persistence enabled option. If selected, set Disk size.

  34. For Grafana, select or clear the Persistence enabled option. If selected, set Disk size.

  35. In the Ingress Controller sub-section:

  36. Enable or disable NGINX Ingress Controller.

  37. If necessary, select Use Let’s Encrypt.

    If selected, set Email and ACME API Endpoint. Azure-Add Platform-Features Configuration

  38. At the bottom of the DEPLOY FULL KUBLR PLATFORM dialog, click Confirm and Install.

    A notification is displayed “Your cluster is being created. It might take a few minutes.”.

  39. In the notification window, click OK.

    Your new platform page is displayed on the Events tab showing the platform creation progress.

Opening Deployed Kublr Platform

The Kublr Platform creation process typically takes about 30 minutes to complete.

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

Setting Up Custom DNS Name for Kublr Platform

This optional step is needed if you want to replace the IP address for the Kublr Platform, which looks something like “https://13.92.169.135/” with something more user-friendly, like https://kublr.example.com/.

In order to do this, please create a new DNS A record for kublr.example.com pointing to Kublr Platform IP.

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