Content Comparison

Mandate container

To install PSKnowhow Knowhow using Kubernetes, it is essential to have three mandatory containers: i) UI, ii) CustomAPI, and iii) MongoDB. These containers are required to ensure the core functionality of the system.

In addition to the mandatory containers, there are above, Knowhow supports several optional containers that you can bring up based on your specific requirements:

...

jira-processor: Acts as a collector to gather data from Jira. If you need KPIs from Jira, you should include this container.

...

processor containers, such as DevOps Processor, Jira Processor, azure- board etc. However, to ensure the application operates correctly

🔶 At least one processor container is required to be deployed along with the mandatory components.

You can choose the processor(s) based on your integration needs. These processors are pluggable updated independently.

Optional Processor Container

• jira-processor: Acts as a collector to gather data from Jira. If you need KPIs from Jira, you should include this container.

• devops-processor: Includes collectors for various DevOps tools such as Jenkins, GitHub, GitLab, Bamboo, Bitbucket, Zephyr, Sonar, and TeamCity. Use this container if you need to collect data from any of these tools.

• azure-board-processor: Collects data from Azure Board. Include this container if you need KPIs from Azure Board.

• azure-pipeline-repo: Collects data from Azure Pipeline and Azure Repo. Use this container if you require data from these Azure services.

Optional Auth Container

Additionally, there are three optional containers used together for single sign-on (SSO) which allows users to authenticate once and gain access to multiple services or applications using SAML. If you choose to install these containers, you must install all three of them. Otherwise, you can use Knowhow's built-in standard authentication mechanism.

• AuthNAuth Backend: This container handles the backend services for authentication and authorization, integrating with your company's SAML for secure user verification.

• AuthNAuth UI: This container provides the user interface for authentication and authorization, allowing users to interact with the login and access control features seamlessly.

• Postgres: This container is for the PostgreSQL database, which stores user credentials, permissions, and other related authentication data securely.

NOTE: Based on specific requirements, you can bring up these respective containers as needed.

Prerequisite:

1. MongoDB instanceHelm and kubectl installed in local

2. MongoDB instance: It is recommended to use cloud-provided services for MongoDB like MongoDB Atlas, Azure Cosmos DB to ensure reliability, scalability, and ease of management. However, for testing or non-production environments, you can also deploy MongoDB as a Kubernetes pod.

3. DNS or IP Address for UI Access: To access the UI from a browser, you need a DNS name or an IP address. This can be either a LoadBalancer IP or a Gateway IP. Ensure that this IP address or DNS name is properly configured and accessible from your network.

Installation Steps

There are two ways to install Knowhow on a Kubernetes cluster:

1. Using Helm (Preferred Method)

Helm simplifies deployment and allows easy configuration management.

Steps:

1. Connect with support team for the Helm charts
   

2. Open values.yaml and make the following updates:

   • Update Image Tag

     Code Block
     knowhowtag: <latest-version>

     Replace <latest-version> with the latest available tag.

   • Set CORS Filter for UI

     Code Block
     env: - name: corsFilterValidOrigin value: "localhost" ui: env: - name: DNS_SSL value: "sapient.com"

     Replace <your-dns> with your actual application DNS.

   • Enable or Disable Applications
     You can choose which features to enable:

     Code Block
     JiraApp: enabled: true DevOpsApp: enabled: false AzurepiPelinerepoApp: enabled: false

   • Configure Ingress
     Set your custom DNS in the Ingress section if enabling ingress :

     Code Block
     ingress: enabled: true className: "" # Provide your ingress class name annotations: hosts: - host: example.com # Pass your knowhow host name here

3. Install using Helm:

   Code Block
   helm install knowhow ./knowhow-helm-chart -n <namespace>

2. Using Kubernetes Manifests (Manual Method)

Please ensure you follow the sequence outlined below to complete the process successfully.

Step 1: Create Configmap For pods

Download the Configmap file and add required details

...

Make sure to pass all the environmental key values and configuration details needed for your pods to function correctly.

NOTE: Refer Environmental variable document for in detail explanation /wiki/spaces/PSKNOWHOW/pages/34528904

...

kubectl apply -f knowhow-configmap.yml

Step 2: Deploy MongoDB Pod

When installing Knohow in a Kubernetes (K8s) environment, it is recommended to use cloud-provided services for MongoDB like MongoDB Atlas, Azure Cosmos DB to ensure reliability, scalability, and ease of management. However, for testing or non-production environments, you can also deploy MongoDB as a Kubernetes pod.

...

To create the MongoDB pod, Download the attached YAML file

AWS with EFS

• This is the YAML file for MongoDB designed specifically for deployment on AWS EKS with an EFS file system for persistent storage. It utilizes static provisioning through Amazon EFS.
  

...

Reference: AWS Docs for EKS with EFS

Azure with Disk

• This is the YAML file for MongoDB designed specifically for deployment on AZURE AKS with an Azure Disk file system for persistent storage.

...

Reference: AZ Docs for PV

MongoDB as HostPath(Testing only)

• Here is a sample YAML file for a MongoDB manifest file that utilizes host path as a volume, although it is recommended for Testing only.

...

kubectl apply -f mongodb.yaml

Step 3: Deploy customapi Pod

Download the customapi-deploy.yaml manifest file

...

The YAML file specifies the name of the Deployment, the container image to use, the container port 8080 to expose, and the Environmental variable for MongoDB host to connect to.

Note: Please provide the latest image tag version in the image place holders . Latest image version number can be found here : Docker hub repo

...

kubectl apply -f customapi-deploy.yaml

Step 4: Deploy the UI Containers

Deploy the UI containers in the same way as the customapi and MongoDB containers. Here is an YAML file for the ui container:

...

Note: Please provide the latest image tag version in the image place holders . Latest image version number can be found here docker hub Repo

...

kubectl apply -f ui.yaml

Step 5: Deploy the Processor Containers

Attaching the list of all the processor you may run

Jira-Processor

Note: Please provide the latest image tag version in the image place holders . Latest image version number can be found here Dockerhub repo

...

kubectl apply -f jira-processor.yaml

Devops-processor

Note: Please provide the latest image tag version in the image place holders . Latest image version number can be found here Dockerhub repo

kubectl apply -f devops-processor.yaml

Azure-board-processor

Note: Please provide the latest image tag version in the image place holders . Latest image version number can be found here Dockerhub repo

kubectl apply -f azure-board-processor.yaml

Azure-pipeline-repo-Processor

Note: Please provide the latest image tag version in the image place holders . Latest image version number can be found here Dockerhub repo

kubectl apply -f azure-pipeline-repo.yaml

...

Step 6 : Installing Authentication and Authorization App

NOTE: If you want to authenticate and authorize users of Knowhow with your company's SAML, install the bellow central login containers. Otherwise, you can skip this step, and your installation is complete.

AuthNAuth Backend

The Bellow manifest is for Deployment and service of AuthNauth backend API service

AuhNAuth UI

The Bellow manifest is for Deployment and service of AuthNauth UI service

AuthNAuth PostgresDB

When installing Knohow AuthNauth in a Kubernetes (K8s) environment, it is recommended to use cloud-provided services for Postgres like Azure Cosmos DB for Postgres or Azure Flex server to ensure reliability, scalability, and ease of management. However, for testing or non-production environments, you can also deploy as a Kubernetes pod.

Step 7: Install repo tool

View file
name debbie-knowhow.yml

View file
name repotool-django.yml

View file
name debbie-rabbitmq.yml

Verify the Deployment

You can verify that the containers are running run the following command:

...

By following these steps, you can persist the MongoDB data in your preferred cloud provider's storage solution.

...

Upgrade Steps:

1. If you are upgrading PSknowhow from 7.0.0 to 7.x.x please execute the bellow step else execute step 2

   Code Block
   kubectl exec -it <Mongodb Pod name> sh mongo admin --username="${MONGODB_ADMIN_USER}" --password="${MONGODB_ADMIN_PASS}" --eval "db.shutdownServer()"

2. Edit the deployment in following order
   customapi
   ui
   jira-processor
   devops-processor
   azure-pipeline-repo
   azure-board-processor
   by

   Code Block
   kubectl edit deploy <Deploy name> -o yaml

3. Replace the tag version with the latest version in image section

4. Check for environmental variable section and add if any new variables are required in current manifest file /wiki/spaces/PSKNOWHOW/pages/34528904 . And save it.

Base Image

1. customapi with amazoncorretto:17 as base image which handles api request, which runs on 8080 port.

2. ui with nginx:1.22.1-alpine-slim base image, which proxy-pass to customapi and ui components, which runs on port 80 & 443.

3. mongodb with mongo:5.0.18 as base image, which stores data and runs on port 27017.

4. Jira-processor with amazoncorretto:17 base image which is a jira collector.

5. devops-processor with amazoncorretto:17 base image which collects jenkins, github, gitlab, bamboo, bitbucket, zephyr, sonar, teamcity.

6. azure-board-processorwith amazoncorretto:17 base image and which collects azure board.

7. azure-pipeline-repo with amazoncorretto:17 as base image which collects azure pipeline and azure repo.

8. scm-processor-api Its python:3.8 application to calculate KPI metrics of different SCM tools like github, gitlab & Bitbucket.

9. scm-processor-core Its a python:3.8 application which collects raw data from SCM tools like github, gitlab & Bitbucket and saves it.

10. scm-processor-postgres: Version 11.1 is used to store repotool related data(Only required when repotool is installed)

11. scm-processor-rabbitmq Version 3.8-management is a job scheduler user by repotool-knowhow application (Only required when repotool is installed)

Architecture diagram Of AWS EKS KnowHOW Kubernetes Cluster

...

Architecture diagram Of Azure AKS KnowHOW Kubernetes Cluster