Upgrade

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

Note

The general upgrade steps were revised in v2.7 to include direct upgrades of CRDs. When you upgrade to v2.7 or later, be sure to include the CRD upgrade step.

General upgrade steps

Point your local kubectl to your K8s cluster and namespace.
If available, retrieve the values.yaml file for your Robust Intelligence Model Testing Agent.

Alternatively, you can save the current Helm values to a file like so:
```
helm get values rime-agent | awk '!/USER-SUPPLIED VALUES/' > values.yaml
```
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 Robust Intelligence version you want to upgrade to (for example, 2.7.6).

You can find your current version number in the Organization Settings page by clicking on the Manage Agent Setup tab. Your customer success contact can provide the latest patch release number for your desired product version.

Specify version numbers without a v prefix. Replace the example value used here (2.7.6) with your desired version.
```
# values.yaml
# (from "Manage Agent Setup" page in UI) "Control Plane: v2.7.6"
rimeAgent:
   images:
      agentImage:
         # name: "robustintelligencehq/rime-agent:2.6.0" # OLD
         name: "robustintelligencehq/rime-agent:2.7.6" # NEW
      modelTestJobImage:
         # name: "robustintelligencehq/rime-testing-engine-dev:2.6.0" # OLD
         name: "robustintelligencehq/rime-testing-engine-dev:2.7.6" # NEW
```

Upgrade the CRD resources. Replace the example value used here (2.7.6) with your desired version.

kubectl apply -f https://raw.githubusercontent.com/RobustIntelligence/helm/2.7.6/rime-agent/crds/rime-agent.crds.yaml
kubectl apply -f https://raw.githubusercontent.com/RobustIntelligence/helm/2.7.6/rime-agent/crds/rime-agent-deployment.crds.yaml

Install the updated Helm release.

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

Upgrading from v2.3 to v2.4

Point your local kubectl to your K8s cluster and namespace.
Delete the rimejobs.rbst.io CRD.

kubectl delete crd rimejobs.rbst.io

Uninstall the agent in your environment:
```
helm uninstall rime-agent
```
Follow steps 2 through 4 of the general upgrade process.

Install the updated Helm release.

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

Upgrading from v2.2 to v2.3

Point your local kubectl to your K8s cluster and namespace.
Delete the rimejobs.rbst.io CRD.

kubectl delete crd rimejobs.rbst.io

Uninstall the agent in your environment:
```
helm uninstall rime-agent
```
Follow steps 2 through 4 of the general upgrade process.

Install the updated Helm release.

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

Upgrading from v2.0 to v2.1

Navigate to Organization Settings page and click on the Manage Agent Setup tab. Deactivate and then delete the agent.
Uninstall the agent in your environment:
```
helm uninstall rime-agent
```
Expand the agent’s data access strategy to include a second K8s service account, rime-agent-rime-cross-plane-server (specific steps outlined below).
- Data Access Permissions
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.

Verifying an Upgrade

Verify that the rime-agent Helm chart version matches the new Robust Intelligence version:
```
helm list
```
Verify that the Docker image versions match the new Robust Intelligence version:
```
kubectl describe deployment rime-agent-launcher | grep Image
```
Verify that the CRDs crossplanerpcjobs.rbst.io and rimejobs.rbst.io are present:
```
kubectl get crd | grep rbst
```
Navigate to Organization Settings page and click on the Manage Agent Setup tab to confirm that the agent shows an “Active” status.