Skip to main content

Deployment

For the deployment of Cognazie Platform we use the following technologies

Step 1: Kubernetes Deployment​

  1. Set up a Kubernetes cluster using your preferred method (e.g., local setup, cloud provider's Kubernetes service).

  2. Create Kubernetes deployment manifests (deployment.yaml) for your application:

    • Define the deployment object specifying the container image, resource limits, and environment variables.
    • Set up any necessary volume mounts for persistent data storage.

  3. Apply the deployment manifest using the kubectl apply -f deployment.yaml command.

  4. Verify that the deployment is running successfully using kubectl get pods and ensure all pods are in the "Running" state.

Step 2: PostgreSQL Setup​

  1. Install and configure PostgreSQL on your preferred environment:
    • Set up a PostgreSQL server, either within the Kubernetes cluster or on a separate server.
    • Create a new database and necessary database user with appropriate privileges.
  2. Note down the PostgreSQL connection details, including the host, port, database name, username, and password.

Step 3: Nginx Ingress Configuration​

  1. Deploy the Nginx Ingress Controller in your Kubernetes cluster:
  • Follow the official Nginx Ingress documentation to install the controller using the preferred method (e.g., Helm, YAML manifests).
  1. Create an Ingress resource (ingress.yaml) to route traffic to your application:
    • Define the host, paths, and backend service for your application.
    • Apply the Ingress manifest using the kubectl apply -f ingress.yaml command.
  2. Verify that the Ingress resource is created successfully using kubectl get ingress and ensure it has the desired rules.

Step 4: Grafana Loki Logging Setup​

  1. Install and configure Grafana Loki in your Kubernetes cluster:
    • Follow the official Grafana Loki documentation to deploy Loki using the preferred method (e.g., Helm, YAML manifests).
    • Configure the storage backend for Loki, such as object storage or a persistent volume.
  2. Update your application's logging configuration to send logs to Loki:
    • Configure the logging library or framework to use the Loki endpoint and credentials.
    • Ensure that logs are properly formatted and tagged for easy querying and filtering.
  3. Verify that your application's logs are being collected and stored in Loki by querying the Loki API or using the Grafana UI.

Step 5: Cloud Provider Configuration (if applicable)​

  1. If you are deploying on a cloud provider, follow their documentation to create any necessary resources:
    • Set up load balancers, storage volumes, or DNS records as required.
    • Configure any networking settings or security groups.
  2. Update your Kubernetes deployment manifests and Ingress resource to utilize the cloud provider's resources and services.

Step 6: Deployment Verification​

  1. Access your application by navigating to the defined Ingress host or domain and ensure it is accessible.
  2. Perform thorough testing to verify that all functionality is working as expected.
  3. Test the connection to the PostgreSQL database from your application and ensure it can read and write data successfully.
  4. Monitor your application's logs and metrics using Grafana Loki and any other monitoring tools to ensure everything is functioning correctly.