Version: Latest

Installation Guide (Helm)

Installation

Once you have all the requirements satisfied, follow the steps below to deploy the Studio Helm chart inside your Kubernetes cluster.

Step 1: Pull the official Studio helm chart

You can run the below-mentioned command to pull the latest version chart from Rasa's Google Artifact Registry.

helm pull oci://europe-west3-docker.pkg.dev/rasa-releases/helm-charts/studio

This will download the chart file (for example studio-1.0.3.tgz) to your machine. Extract this file to see the chart templates and values.yaml file.

Step 2: Create a value file:

A value file contains the configuration options and parameters for the Helm chart. You can customize these options based on your requirements. A sample values.yaml file is available in the Studio Helm Chart. The file can be seen if you extract the .tgz chart file you downloaded from the Google Artifact Registry. Follow these steps to create your value file:

  1. Make a copy of values.yaml file which can be found inside extracted chart directory. Let us call it my-values.yaml. This file will serve as your custom value file.
  2. Open my-values.yaml in a text editor and modify the configuration options according to your needs. Ensure that you review and update values related to the way your Kubernetes cluster is set up. The chart's readme file will provide you with all the keys that are available with their default values.
  3. Save and close the my-values.yaml file.
tip

For PostgreSQL database you must percentage-encode special characters in any part of your connection URL - including passwords. For example, p@$$w0rd becomes p%40%24%24w0rd.

Step 3: Creating Kubernetes secrets:

To store sensitive values mentioned in the above section it is recommended to create Kubernetes secrets. To create them

  1. Make a copy of the secrets.yaml file which can be found inside extracted chart directory. Let us call it my-secrets.yaml.
  2. Create base64 encoded values of the secrets and update the yaml file with them. You can run echo -n "my-secret-key" | base64 to quickly create base64 encoded values of your secrets.
  3. Once all the secrets are updated run kubectl apply -f my-secrets.yaml -n <namespace>. This creates the Kubernetes secret in the namespace where you plan to deploy Studio.
  4. These secrets are then referenced and passed onto the pods inside the cluster when Studio is deployed with my-values.yaml file created in the previous step.
SECRET KEYSECRET VALUE
DATABASE_URLDatabase URL of the Studio backend database. This should be of the format postgresql://${DB_USER}:${DB_PASS}@${DB_HOST}:${DB_PORT}/${DB_NAME}?schema=public
DATABASE_PASSWORDDatabase password for the Studio databases
KAFKA_SASL_PASSWORDKakfa password if you use the SASL mechanism
KEYCLOAK_ADMIN_PASSWORDPassword to the admin user interface of Keycloak (Studio’s user management system). You should use this credential to login to http://<external-ip-or-hostname>/auth
KEYCLOAK_API_PASSWORDPassword to access Keycloak API. Studio uses this internally to communicate with Keycloak
RASA_PRO_LICENSE_SECRET_KEYRasa Pro license key
OPENAI_API_KEY_SECRET_KEYOpenAI API key

Step 4: Deploy Rasa Studio using Helm:

With the Helm chart and value file prepared, you are ready to deploy Rasa Studio in your Kubernetes cluster. Run the following command:

helm upgrade <release-name> <path-to-chart-folder> -f <path-to-value-file> -n <namespace> --install
  • <release-name>: Choose a name for your Rasa Studio release, for example, rasa-studio.
  • <path-to-chart-folder>: Provide the path to the extracted folder of the tgz file you obtained by downloading the chart from the Google Artifactory registry.
  • <path-to-value-file>: Specify the path to your custom value file (my-values.yaml).
  • <namespace> Kubernetes namespace you want to deploy to.

Example command:

helm upgrade rasa-studio ./studio -f ./my-values.yaml -n studio --install

Helm will begin the deployment process, creating the necessary resources and configurations based on the provided values.

Step 5: Monitor deployment and access Rasa Studio:

Once the deployment is complete, you can monitor the deployment status by running:

kubectl get pods -n <namespace>

Ensure that all pods are running and ready before accessing Rasa Studio.

You can access Rasa Studio by visiting the URL https://<external-ip-or-hostname> in your web browser. You can now proceed to user management and license activation.

You can access Rasa Studio User Management UI (Keycloak) by visiting the URL https://<external-ip-or-hostname>/auth in your web browser. The login credentials for the Keycloak Administration Console is the value that you provided for the KEYCLOAK_ADMIN and KEYCLOAK_ADMIN_PASSWORD environment variables in the values file.

You can then select the KEYCLOAK_REALM (rasa-studio) and add users to Studio.

Please note that additional configurations and customizations can be made by modifying the value file (my-values.yaml) and upgrading the deployment using the helm upgrade command.

For further information on advanced configuration options and maintenance tasks, refer to the Rasa Studio Helm charts documentation (README.md in the downloaded Helm chart and inline comments in values.yaml file) and the official Helm documentation.