Local Project

Project Setup Guide

1. Installation of Required Tools

To run the project correctly, install the following tools:

• Docker Desktop – A tool for working with containers.

  • Download and install: Docker Desktop

• Minikube – A local Kubernetes cluster.

  • Download and install: Minikube

• kubectl – A command-line tool for managing Kubernetes clusters.

  • Download and install: kubectl
  • Verify the installation using the command:

    kubectl version --client

2. Setting Up PostgreSQL

• Ensure that PostgreSQL is installed and running on port 5432.
• If PostgreSQL is not installed, download and install it from the official site.
• Verify that the server is running with:

  psql -U postgres -c "SELECT version();"

3. Cloning Repositories

1. Create a folder named licensepro in any convenient location.
2. Clone the next GitHub repositories:

   https://github.com/License-Managemen-Solutions/licensepro-web-app.git
   https://github.com/License-Managemen-Solutions/licensepro-stripe-subscription-service.git   
   https://github.com/License-Managemen-Solutions/licensepro-stripe-listener-service.git
   https://github.com/License-Managemen-Solutions/licensepro-cognito-authentication-service.git
   https://github.com/License-Managemen-Solutions/licensepro-user-service.git
   https://github.com/License-Managemen-Solutions/licensepro-account-service.git
   https://github.com/License-Managemen-Solutions/licensepro-jurisdiction-service.git
   https://github.com/License-Managemen-Solutions/licensepro-license-service.git
   https://github.com/License-Managemen-Solutions/licensepro-license-renewal-service.git
   https://github.com/License-Managemen-Solutions/licensepro-feature-service.git
   https://github.com/License-Managemen-Solutions/licensepro-audit-logs-service.git   
   https://github.com/License-Managemen-Solutions/licensepro-devops-migrations.git

4. Preparing Scripts

1. Copy the build-images.bat file into the root licensepro folder.
2. Navigate to the licensepro/licensepro-devops-migrations/tools folder.
3. Open the apply-changelogs.bat file, edit it if necessary.
4. Run this file either by double-clicking it or using the command line:

   apply-changelogs.bat

5. Starting Minikube

1. Open a terminal and execute:

   minikube start

2. For a more convenient way to configure Minikube parameters, use the minikube-menu.bat script.
3. Ensure that Docker Desktop and Minikube are running.
   • Check Minikube status:

     minikube status

   • Verify that Docker is running:

     docker version

6. Compiling Microservices and Uploading to Minikube

1. Navigate to the licensepro folder.
2. Run the build-images.bat script:

   build-images.bat

3. Wait for the compilation and Docker image upload process to complete.

7. Deploying Applications in Minikube

1. Ensure you are in the licensepro folder.
2. Apply the deployment manifest:

   kubectl apply -f deploy-app.yaml

3. Check running pods:

   kubectl get pods

After completing all steps, the system should be successfully deployed in the local Kubernetes Minikube cluster.