Managed Cluster Support

The Cloud Provider Cluster Support features enable users to create a new Google Kubernetes Cluster (GKE), Elastic Kubernetes Cluster (EKS), or Azure Kubernetes Cluster (AKS) in Nirmata.

NOTE: The Kubernetes version associated with a cluster cannot be downgraded.

Feature Overview

The Cloud Provider Cluster Support features enable users to create, upgrade, resize, and delete a Google Kubernetes Cluster (GKE) from within Nirmata.

How to Manage a GKE Cluster in Nirmata

To manage a GKE Cluster in Nirmata, add Google as a Cloud Provider in Nirmata. A valid Google Cloud Provider account and credentials is required.

See GCE Cloud Provider for full documentation on adding Google as a Cloud Provider.

Create a GKE Cluster

To add a GKE Cluster in Nirmata, select Clusters from the sidebar menu and then click the +Add Cluster button.

image

Select Create GKE Cluster and click Complete Setup.

image

Enter the Configure Cluster Details and click Next.

image

Complete the Configure Cluster Details and click Create Cluster.

image

The Cluster will begin building.

image

In 10 to 15 minutes, the new Cluster is visible in Nirmata and in the Google Cloud Provider dashboard.

image

image

Upgrade a GKE Cluster

NOTE: The Kubernetes version associated with a cluster cannot be downgraded. To upgrade the Kubernetes version of a GKE Cluster, navigate to the cluster from the Cluster menu.

image

Select Upgrade Cluster from the Settings menu.

image

Select the new Kubernetes version from the drop-down menu and click Save.

image

The upgrade is reflected in Google Cloud Platform and Nirmata.

image

image

Resize a GKE Cluster

To change the number of nodes in a GKE Cluster, navigate to the cluster from the Cluster menu.

image

Open the Settings menu and select Resize Cluster.

image

Enter the new node count and click Save.

image

The new nodes are reflected on the Nirmata Cluster dashboard.

image

Delete a GKE Cluster

NOTE: All Applications and Environments running inside the cluster must be stopped and deleted before deleting the cluster.

To delete a GKE Cluster, navigate to the cluster from the Cluster menu.

image

From the Settings menu, select Delete Cluster.

image

Enter the Cluster name and click Delete.

image

The cluster is deleted in Nirmata and Google Cloud Platform.

image image

Feature Overview

The Cloud Provider Cluster Support features enable users to create and delete a new Amazon Elastic Kubernetes Service (EKS) cluster in Nirmata.

How to Manage an EKS Cluster in Nirmata

To manage an EKS Cluster in Nirmata, add Amazon as a Cloud Provider in Nirmata. A valid Amazon Web Services account and credentials is required.

See AWS Cloud Provider for full documentation on adding Amazon as a Cloud Provider.

IMPORTANT: When adding Amazon as a Cloud Provider be sure to note the Account ID provided by Nirmata. The Account ID is required when creating an EKS Cluster.

In addition to adding AWS as a Cloud Provider in Nirmata, the following must be installed on the local machine:

If using Ubuntu 16.04 AM or any other Linux images enable the following configurations:

sudo iptables -P INPUT ACCEPT
sudo iptables -P FORWARD ACCEPT
sudo iptables -P OUTPUT ACCEPT

Then ensure that the Security Group allows all ports between the hosts and their respective subnet. If enabling TCP Elastic Load Balancing (ELB), the connection must listen for requests port 443 and target the group for 6443.

Create a EKS Cluster

To add an EKS Cluster in Nirmata, select Clusters from the sidebar menu and then click the +Add Cluster button.

image

Select Create EKS Cluster and click Complete Setup.

image

In addition to adding AWS as a Cloud Provider, managing an EKS Cluster in Nirmata requires a second role in AWS.

To create the second role required for EKS Cluster management in Nirmata, login to the AWS Management Console and select IAM Services.

Select Roles and then click on the button to Create Role.

image

Select Another AWS Account.

image

Enter the Account ID provided by Nirmata during the AWS Cloud Provider setup.

image

Apply the following policies to the role:

Locate each permission by entering the Permission Name into the Search box. Place a checkmark next to each required permission. After adding all permissions, click the Create Policy button.

image

Complete the role creation process. Be sure to note the Access Keys (Access Key IDs and Secret Access Keys).

Copy the Role ARN from the Role Summary screen in AWS.

image

In Nirmata, complete the first page of Cluster Configuration Details. Paste the Role ARN from AWS into the Cluster Role ARN field. Click Next.

image

On the second Cluster Configuration Details page, enter the remaining information. Choose a customized Image ID created in AWS or use one of Amazon’s EKS-Optmized AMI image IDs. After completing all of the fields, click Create Cluster.

image

In 20 to 25 minutes, the new Cluster is visible in Nirmata and in the AWS dashboard.

image

image

When the cluster is visible in Nirmata, the following three (3) YAML files will be available for download and installation. * nirmata-aws-config.yaml * nirmata-aws-auth.yaml * nirmata-kubernetes-controller.yaml

Download and install each YAML to place nodes in ready-state and connect the cluster to Nirmata.

image

Delete a EKS Cluster

NOTE: All Applications and Environments running inside the cluster must be stopped and deleted before deleting the cluster.

To delete an EKS Cluster, navigate to the cluster from the Cluster menu.

image

From the Settings menu, select Delete Cluster.

image

Enter the Cluster name and click Delete.

image

The cluster is deleted in Nirmata and AWS.

Feature Overview

The Cloud Provider Cluster Support features enable users to create, upgrade, resize, and delete a new Microsoft Azure (AKS) cluster in Nirmata.

NOTE: The Kubernetes version associated with a cluster cannot be downgraded.

How to Manage an AKS Cluster in Nirmata

To manage an AKS Cluster in Nirmata, add Azure as a Cloud Provider in Nirmata. A valid Microsoft Azure account and credentials is required.

See Microsoft Azure Cloud Provider for full documentation on adding Azure as a Cloud Provider.

Create an AKS Cluster

To add an AKS Cluster in Nirmata, select Clusters from the sidebar menu and then click the +Add Cluster button.

image

Select Create AKS Cluster and click Complete Setup.

image

Enter the Configure Cluster Details and click Next.

image

Select the VMSize Type and Node Count.

NOTE: Maximum node counts apply to each VMSize type.

image

image

View the new cluster in AKS by navigating from the AKS Home screen to Kubernetes Services. The new cluster is displayed.

image

Click on the cluster name to view the cluster details in AKS. In 15 to 20 minutes, the cluster will complete the Creating process and will be available for configuration in AKS and Nirmata.

image

Upgrade an AKS Cluster

NOTE: The Kubernetes version associated with a cluster cannot be downgraded. To upgrade the Kubernetes version of an AKS Cluster, navigate to the cluster from the Cluster menu.

image

Select Upgrade Cluster from the Settings menu.

image

Select the new Kubernetes version from the drop-down menu and click Save.

image

The upgrade is reflected in AKS and Nirmata.

image

image

Resize an AKS Cluster

To change the number of nodes in a AKS Cluster, navigate to the cluster from the Cluster menu.

image

Open the Settings menu and select Resize Cluster.

image

Enter the new node count and click Save.

image

The new nodes are reflected on the Nirmata Cluster dashboard.

image

Delete an AKS Cluster

NOTE: All Applications and Environments running inside the cluster must be stopped and deleted before deleting the cluster.

To delete an AKS Cluster, navigate to the cluster from the Cluster menu.

image

From the Settings menu, select Delete Cluster.

image

Enter the Cluster name and click Delete.

image

The cluster is deleted in Nirmata and AKS.

image

image