Operator

Use this guide to upgrade the Speedscale operator in your cluster to the latest version.

Update speedctl

You will need to get the latest speedctl client to perform the upgrade:

speedctl update

Perform Upgrade

Your process for upgrading depends on how you manage your Kubernetes environments.

Helm

Upgrading the Speedscale via helm is as easy as:

helm repo update
helm -n speedscale upgrade speedscale-operator speedscale/speedscale-operator

For additional details please refer to the helm chart repository for details and follow the README instructions for upgrading.

ArgoCD

Go to your ArgoCD manifest and update targetRevision to the specific version you want to upgrade to from the Helm repository.

project: default
source:
  repoURL: 'https://speedscale.github.io/operator-helm/'
  targetRevision: <YOUR-VERSION>
  helm:
    parameters:
      - name: apiKeySecret
        value: speedscale-apikey
    values: |-
      apiKeySecret: speedscale-apikey
      clusterName: <YOUR-CLUSTER-NAME>
  chart: speedscale-operator
destination:
  namespace: speedscale
  name: in-cluster
syncPolicy:
  automated: {}
  syncOptions:
    - CreateNamespace=true

GitOps

If you are using a GitOps engine to manage your Kubernetes resources, you will need to update your git repository with the new manifests.

First generate a new template:

helm template speedscale-operator speedscale/speedscale-operator \
    -n speedscale \
    --create-namespace \
    --set apiKey=<YOUR-SPEEDSCALE-API-KEY> \
    --set clusterName=<YOUR-CLUSTER-NAME> > ./speedscale-operator.yaml

Then merge this speedscale-operator.yaml with the one you already have in git.

Validate

Once your deployment has been upgraded, run the following to ensure the Speedscale control plane is healthy:

speedctl check operator

Restart Sidecars

After an upgrade the next step is to restart your services to get the latest version of the Speedscale goproxy sidecar. The easiest way to do this is to run a rolling deploy, allowing the Speedscale operator to inject the latest version of the proxy as they come up.

kubectl -n <namespace> rollout restart deploy

Add Speedscale to Workloads

You can now install Speedscale on new workloads. You may use the speedctl install wizard, or a GitOps tool.

Frequency of Upgrades

Speedscale typically releases new customer-side components weekly or more. By default, the Speedscale helm chart uses a pinned patch version that will not automatically upgrade. However, if you would like to always use the latest version you can instead pin to the minor version and set your image pull policy to pull more frequently. This will ensure you have the latest non-breaking version installed.

If you plan to manually upgrade, we recommend doing so at least monthly.