Skip to main content

Kubernetes with Helm

Deploy on Kubernetes in a few simple steps

This document covers deployment process for GoRules BRMS on Kubernetes.

Requirements​

To begin, install Helm on your computer and connect to your cluster.

  • Helm 3 (>=3.8)
  • Kubernetes (1.2x+)
    • Nodes - linux OS and x86_64 architecture
    • Minimum 1GB RAM and 0.5 vCPU
  • Postgres DB
  • License Key obtained from https://portal.gorules.io

Configure​

  1. Download values.yaml https://artifacthub.io/packages/helm/gorules/gorules-brms?modal=values.
  2. Rename file to my-values.yaml.
  3. Replace variables such as appUrl and licenseKey with your values
  4. Fill in the Postgres connection details

Installation​

After configuring my-values.yaml file you can install GoRules BRMS by running:

helm install my-gorules-brms oci://registry-1.docker.io/gorulescharts/gorules-brms -f my-values.yaml
info

You can also install specific version by adding --version 1.6.0 before -f my-values.yaml

info

For operational environments we are suggesting setting up ingress

Test installation​

For testing purposes you can forward the port for testing:

kubectl port-forward services/my-gorules-brms 4200:80

BRMS will be available on http://localhost:4200. In the real environment, you should also set ingress on a proper URL.

Upgrade​

You can upgrade version by running:

helm upgrade my-gorules-brms oci://registry-1.docker.io/gorulescharts/gorules-brms --version x.x.x -f my-values.yaml
info

Replace --version x.x.x with actual number such as --version 1.6.0

FAQ​

Multi architecture node pools​

If you are running multi architecture node pools you can force Linux OS and x86_64 architecture by modifying nodeSelector inside my-values.yaml file to:

nodeSelector:
  kubernetes.io/arch: amd64
  kubernetes.io/os: linux

Next, perform helm upgrade....