Skip to main content

Installation

Installing RBG to a Kubernetes Cluster

Prerequisites

  • A Kubernetes cluster with version >= 1.22 is Required, or it will behave unexpectedly.
  • Kubernetes cluster has at least 1 node with 1+ CPUs and 1G of memory available for the RoleBasedGroup controller manager Deployment to run on.
  • The kubectl command-line tool has communication with your cluster.

Install by kubectl

kubectl apply --server-side -f ./deploy/kubectl/manifests.yaml

To wait for RoleBasedGroup controller to be fully available, run:

kubectl wait deploy/rbgs-controller-manager -n rbgs-system --for=condition=available --timeout=5m

Install by Helm

helm upgrade --install rbgs deploy/helm/rbgs \
--create-namespace \
--namespace rbgs-system \
--wait

Or use the Makefile shortcut:

make helm-deploy

CRD Upgrader Configuration

ParameterDescriptionDefault
crdUpgrade.enabledEnable CRD Upgrader Jobtrue
crdUpgrade.repositoryCRD Upgrader image repositoryrolebasedgroup/rbgs-upgrade-crd
crdUpgrade.tagCRD Upgrader image tagSame as image.tag
crdUpgrade.ttlSecondsAfterFinishedJob TTL after completion259200 (3 days)

Uninstall

To uninstall RoleBasedGroup installed via kubectl:

kubectl delete -f ./deploy/kubectl/manifests.yaml

To uninstall RoleBasedGroup installed via Helm:

helm uninstall rbgs --namespace rbgs-system