docs/content/master/guides/upgrade-crossplane.md

1.3 KiB

title weight description
Upgrade Crossplane 400 Upgrade Crossplane to newer versions

The recommended upgrade method for an existing Crossplane install is to use Helm.

Prerequisites

  • Helm version v3.2.0 or later

Add the Crossplane Helm repository

Verify Helm has the Crossplane repository.

helm repo add crossplane-stable https://charts.crossplane.io/stable

Update the Helm repository

Update the local Crossplane Helm chart with helm repo update.

helm repo update

{{<hint "important" >}} Upgrading Crossplane without updating the Helm chart installs the last version available in the locally cached Helm chart. {{< /hint >}}

Upgrade Crossplane

Upgrade Crossplane with helm upgrade, providing the Crossplane namespace. By default, Crossplane installs into the crossplane-system namespace.

helm upgrade crossplane --namespace crossplane-system crossplane-stable/crossplane

Helm preserves any arguments or flags originally used when installing Crossplane.

Crossplane uses any new default behaviors unless they're changed in the helm upgrade command.

Override new defaults by [customizing the Helm chart]({{<ref "../get-started/install#customize-the-crossplane-helm-chart" >}}) with the upgrade command.