Overview

This guide walks you through how to Install Rhize and its services in a Kubernetes environment. You can also use these docs to model automation workflows in your CI.

This procedure aims to be as generic and vendor-neutral as possible. Some configuration depends on where and how you run your IT infrastructure—what cloud provider you use, preferred auxiliary tools, and so on—so your team must adapt the process for its particular use cases.

Condensed instructions

This guide has three steps, each of which has its own page. The essential procedure is as follows:

1. Set up the Kubernetes environment.

   1. Within a Kubernetes cluster, create a new namespace.
   2. In this namespace, add the Rhize container images and Helm repositories.
   3. In the cluster, create passwords.
   4. Use Helm to install Keycloak.

2. Configure Keycloak.

   1. In Keycloak, create a realm and clients for each service.
   2. In the cluster, create secrets for the KeyCloak clients.

3. Install services.

   1. Use Helm to install libreBaas .
   2. In Keycloak, give libreBaas admin permissions.
   3. Use these admin permissions to POST the database schema.
   4. Return to Keycloak and add the newly created permissions to the libreBaas group.
   5. Use Helm to install all other services in this sequence:
      1. Install the service dependencies.
      2. Edit its YAML files to override defaults as needed.
      3. Install through Helm.