Page Comparison

Rancher is an an open-source multi-cluster orchestration platform that makes it easy for you to deploy and manage an application on Kubernetes cluster.

Adeptia packages Rancher and Rancher Kubernetes Engine (RKE2) along with Adeptia Connect application and other components in Ansible Playbook. You need to download, extract,and run this package that deploys Playbook to deploy the followings in the same order.

• RKE2 – Rancher Kubernetes Engine to set up Kubernetes environment.

• Rancher UI – UI to centrally manage a multi-cluster Kubernetes environment.

• Longhorn – To implement distributed block storage for Kubernetes.

• Prometheus including Grafana – To centrally monitor the system and its execution environment holistically, for example, CPU usage.

• Elasticsearch, Fluentd, and Kibana (EFK) – For centralized loggingTo view the logs for each microservice.

• Kubernetes Event Driven Autoscaler (KEDA) – For pods Framework that can be used for horizontal pod autoscaling.

• Adeptia Connect application

This page discusses the followings:

Anchor
Prerequisites Prerequisites

Prerequisites and configurations for Playbook execution

Before you begin to run Ansible Playbook, ensure that you have,

• At least three Linux VMs (to be used as master nodes) with internet access, each with the following minimum configuration:

  • RAM – 32 GB

  • Processor cores – 8

  • Hard disk – 250 GB

• One Jumpbox with internet access and SSH connectivity with the above 3 Linux VM machinesLinux nodes to download, extract, and run the Playbook.

• Ansible 2.12 (or higher) installed on Jumpbox.
  You can install Ansible on Ubuntu OS by running the following commandset of commands in the same order:

  Code Block
  language powershell
  $ sudo apt-add-repository ppa:ansible/ansible $ sudo apt install ansible 2.12.10

Where,

The first command adds the Ansible repository and the second one installs Ansible 2.12.10.

• Load Balancer on the top of 3 Linux VM nodes.

• Administrative privileges on Jumpbox and each Linux VM node.

• SSH Private private key in PEM (Privacy Enhanced Mail) format for communication between the VMs.

...

• The following inbound ports opened on the Load Balancer and 3 Linux VMthe nodes:

  • 9345 - required for RKE2 nodes clustering

  • 6443 - required for Kubernetes API

• DNS domain for accessing Rancher UI.

• DNS domain for accessing Adeptia Connect portal.

Once you have met the prerequisites, update the following files containing the details of VMs, DNS, SSH connectivity, and other configuration details required for Adeptia Connect installation. These files are available in Ansible Playbook package that you have downloaded and extracted on the Jumpbox.

• inventory file – Defines the hosts (or group of hosts) on which the Playbook runs.

• general-config.yaml - Contains the configuration variables to run the Playbook for Adeptia Connect installation.

• vault-config.yaml - Contains sensitive information, such as passwords, required to validate and run the Playbook.

Steps to update inventory file

1. Open the inventory file.

2. Add the domain name or IP address of the three VMs server nodes and RKE2 agent (if you have any) under the [servers] group ] and [agents] groups respectively as shown in the example code snippet below.

...

# rke2 cluster master/server nodes #
[servers]
xxx.xx.xx.xx
xxx.xx.xx.xx
xxx.xx.xx.xx

# rke2 cluster worker/agent nodes #
[agents]
xxx.xx.xx.xx

[k8s:children]
servers
agents

[servers:vars]
rke2_type=“server”

[agents:vars]
rke2_type=“agent”

[all:vars]
ansible_user={{ ssh_user }}
ansible_ssh_private_key_file={{ ssh_key_path }}

You can also add the domain name or IP address of an RKE2 agent under the [agents] group if you have one.

Steps to update general-config.yaml

...

Steps to update vault-config.yaml

...

...

You can encrypt the sensitive information specified in the vault-config.yaml file by using Ansible Vault.

To encrypt the file, navigate to the /vars folder, and then run the following command:

$ ansible-vault encrypt vault-config.yaml

You will be prompted to provide and confirm a password for the file. Once you have confirmed the password, a message “Encryption successful” confirming the encryption will be displayed.

To decrypt the file, navigate to the /vars folder, and then run the following command:

...

Executing the Ansible Playbook

After you have met all the prerequisites and configured the inventory, general-config.yaml, and vault-config.yaml files, you are ready to You can run the Ansible Playbook by executing the adeptia-connect.sh shell file (with appropriate arguments) after you have fulfilled all the prerequisites. Here are the steps to run the adeptia-connect.sh file in default mode by following which all the components including RKE2, Rancher, Longhorn, Prometheus, EFK, KEDA, and Adeptia Connect get installed.

...

You can use the tag argument while running the command to execute the shell file to install for installing different components as per your requirement. For example, if you want to install all the components except for the Adeptia Connect application, run the following command:

$ sudo ./adeptia-connect.sh --tag=install-basic

Following table contains the the list describing of some tags that you can useand their description:

...

Here are the steps to uninstall all the components including RKE2, Rancher, Longhorn, Prometheus, EFK, KEDA, and Adeptia Connect.

1. Log in to the Jumpbox.

2. Run the following command to set Read/Write permission on the SSH private key file (PEM):

   Code Block
   $ chmod 0600 <pem file>

3. Run the following command to set executable permission on the adeptia-connect.sh shell file:

   Code Block
   $ chmod +x adeptia-connect.sh

4. Run the following command to execute the shell file, adeptia-connect.sh, available in the Ansible Playbook:

   Code Block
   $ sudo ./adeptia-connect.sh --tag=uninstall-all

...

$ ./adeptia-connect.sh --tag=uninstall-ac

...