This is documentation for the next version of Grafana k6 documentation. For the latest stable release, go to the latest version.

Documentation Grafana k6 Set up Set up distributed k6 Upgrade the k6 Operator

Upgrade the k6 Operator

This guide explains how to upgrade the k6 Operator, depending on your installation method. Before upgrading, make sure to read the release notes to know what changed and if any breaking changes happened.

k6 Operator installed with bundle

If you installed the k6 Operator with bundle, you can usually upgrade by re-running the kubectl apply command with the latest bundle file. However, this won’t remove resources that are no longer present in the new bundle. To avoid leaving outdated resources in your cluster, follow these steps:

1. Download the version of bundle.yaml you originally used and save it as old.bundle.yaml.

2. Delete the old installation:

   sh Copy

   kubectl -f old.bundle.yaml delete

3. Download the latest bundle and install it:

   sh Copy

   curl https://raw.githubusercontent.com/grafana/k6-operator/main/bundle.yaml > bundle.yaml
   kubectl apply -f bundle.yaml

4. Save the latest bundle as your new old.bundle.yaml for future upgrades:

   sh Copy

   cp bundle.yaml old.bundle.yaml

Split the bundle for long-term maintenance

Bundle installation is quick, but not always flexible for long-term maintenance. You can split the bundle into separate manifest files and manage them with Kustomize or a GitOps workflow. For inspiration, refer to the run-tests.sh script in the k6 Operator repository.

k6 Operator installed with Helm

If you installed the k6 Operator with Helm, upgrade with these commands:

sh Copy

helm repo update
helm upgrade k6-operator grafana/k6-operator

k6 Operator installed with Makefile

If you installed the k6 Operator with a Makefile, upgrade with these commands:

sh Copy

git clone https://github.com/grafana/k6-operator && cd k6-operator
git checkout <LATEST_RELEASE_TAG>

make deploy

Replace <LATEST_RELEASE_TAG> with the latest release tag from the k6 Operator releases.

This method is similar to the split bundle approach, but it’s closer to development mode and requires Golang and Kustomize to be installed.