mirror of https://github.com/crossplane/docs.git
47 lines
1.9 KiB
Markdown
47 lines
1.9 KiB
Markdown
---
|
|
title: Upgrading to v1.x
|
|
weight: 220
|
|
---
|
|
|
|
Crossplane versions post v1.0 do not introduce any breaking changes, but may
|
|
make some backward compatible changes to the core Crossplane CRDs. Helm [does
|
|
not currently touch CRDs](https://github.com/helm/helm/issues/6581) when a chart
|
|
is upgraded, so Crossplane has moved to [managing its own
|
|
CRDs](https://github.com/crossplane/crossplane/pull/2160) as of v1.2.0. However,
|
|
for versions prior to v1.2.0, you must manually apply the appropriate CRDs
|
|
before upgrading.
|
|
|
|
## Upgrading to v1.0.x or v1.1.x
|
|
|
|
To upgrade from the currently installed version, run:
|
|
|
|
```console
|
|
# Update to the latest CRDs.
|
|
kubectl apply -k https://github.com/crossplane/crossplane//cluster?ref=<release-branch>
|
|
|
|
# Update to the latest stable Helm chart for the desired version
|
|
helm --namespace crossplane-system upgrade crossplane crossplane-stable/crossplane --version <version>
|
|
```
|
|
|
|
## Upgrading to v1.2.x and Subsequent Versions
|
|
|
|
Since `v1.2.0`, we do not include any custom resource instances in our Helm chart.
|
|
This means the `Lock` object and `Provider`s and `Configuration`s you might have
|
|
possibly installed via Helm values will get deleted when you upgrade to `v1.2.x`.
|
|
The following commands will instruct Helm not to delete any instances of those
|
|
types:
|
|
|
|
```console
|
|
for name in $(kubectl get locks.pkg.crossplane.io -o name); do kubectl annotate $name 'helm.sh/resource-policy=keep'; done
|
|
for name in $(kubectl get providers.pkg.crossplane.io -o name); do kubectl annotate $name 'helm.sh/resource-policy=keep'; done
|
|
for name in $(kubectl get configurations.pkg.crossplane.io -o name); do kubectl annotate $name 'helm.sh/resource-policy=keep'; done
|
|
```
|
|
|
|
After annotations are in place you can upgrade from the currently installed version
|
|
by running:
|
|
|
|
```console
|
|
# Update to the latest stable Helm chart for the desired version
|
|
helm --namespace crossplane-system upgrade crossplane crossplane-stable/crossplane --version <version>
|
|
```
|