Upgrade

If applicable, follow the version-specific steps below for your upgrade.

Otherwise, the general upgrade process is described below.

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

  2. If available, retrieve the values.yaml file for your 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 RIME 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 rimejobs.rbst.io CRD.

kubectl delete crd rimejobs.rbst.io

  1. Uninstall the agent in your environment:

    helm uninstall rime-agent

  2. Follow step 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 RIME version:

    helm list

  2. Verify that the Docker image versions match the new RIME 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.