Upgrade

Follow the version-specific steps shown below for your upgrade path. For paths not listed below, follow the general upgrade steps.

General upgrade steps

  1. Point your local kubectl to your K8s cluster and namespace.

  2. If available, retrieve the values.yaml file for your Robust Intelligence Model Testing Agent.

    1. Alternatively, you can save the current Helm values to a file like so:

      helm get values rime-agent | awk '!/USER-SUPPLIED VALUES/' > values.yaml

  3. Edit the values.yaml file by changing the image tag in the fields rimeAgent.images.agentImage.name and rimeAgent.images.modelTestJobImage.name to match the new Robust Intelligence version.

    1. The version number can be found by navigating to the Organization Settings page and clicking on the Manage Agent Setup tab.

      Use this version number (without the v prefix) for the image updates.

      # values.yaml
# (from "Manage Agent Setup" page in UI) "Control Plane: v2.2.1"
rimeAgent:
   images:
      agentImage:
         # name: "robustintelligencehq/rime-agent:2.1.8" # OLD
         name: "robustintelligencehq/rime-agent:2.2.1" # NEW
      modelTestJobImage:
         # name: "robustintelligencehq/rime-testing-engine-dev:2.1.8" # OLD
         name: "robustintelligencehq/rime-testing-engine-dev:2.2.1" # NEW

  4. Install the updated Helm release.

    helm repo update
helm upgrade rime-agent robustintelligence/rime-agent --version $RI_VERSION --values ./values.yaml

Upgrading from v2.0 to v2.1

  1. Navigate to Organization Settings page and click on the Manage Agent Setup tab. Deactivate and then delete the agent.

  2. Uninstall the agent in your environment:

    helm uninstall rime-agent

  3. Expand the agent’s data access strategy to include a second K8s service account, rime-agent-rime-cross-plane-server (specific steps outlined below).

  4. Create the new agent using the Create Agent button on the Manage Agent Setup page. Select the original agent type and repeat the setup steps. If permission related inputs are needed, you can find the same inputs you used in v2.0 in the values.yaml file under the rimeAgent.operator.modelTestJob section.

Upgrading from v2.2 to v2.3

  1. Point your local kubectl to your K8s cluster and namespace.

  2. Delete the rimejobs.rbst.io CRD.

kubectl delete crd rimejobs.rbst.io

  1. Uninstall the agent in your environment:

    helm uninstall rime-agent

  2. Follow steps 2 and 3 of the general upgrade process.

  3. Install the updated Helm release.

    helm repo update
helm install rime-agent robustintelligence/rime-agent --version $RI_VERSION --values ./values.yaml

Upgrading from v2.3 to v2.4

  1. Point your local kubectl to your K8s cluster and namespace.

  2. Delete the rimejobs.rbst.io CRD.

kubectl delete crd rimejobs.rbst.io

  1. Uninstall the agent in your environment:

    helm uninstall rime-agent

  2. Follow steps 2 and 3 of the general upgrade process.

  3. Install the updated Helm release.

    helm repo update
helm install rime-agent robustintelligence/rime-agent --version $RI_VERSION --values ./values.yaml

Verifying an Upgrade

  1. Verify that the rime-agent Helm chart version matches the new Robust Intelligence version:

    helm list

  2. Verify that the Docker image versions match the new Robust Intelligence version:

    kubectl describe deployment rime-agent-launcher | grep Image

  3. Verify that the CRDs crossplanerpcjobs.rbst.io and rimejobs.rbst.io are present:

    kubectl get crd | grep rbst

  4. Navigate to Organization Settings page and click on the Manage Agent Setup tab to confirm that the agent is posting an “Active” status.