diff --git a/docs/drafts/how-to-z-stream-upgrades.md b/docs/drafts/how-to-z-stream-upgrades.md new file mode 100644 index 000000000..835abc2b5 --- /dev/null +++ b/docs/drafts/how-to-z-stream-upgrades.md @@ -0,0 +1,24 @@ +## How-to: Z-Stream Automatic Updates + +To restrict automatic updates to only z-stream patches and avoid breaking changes, use the `"~"` version range operator when setting the version for the desired package in Catalog source. + +Example: + +```yaml +apiVersion: olm.operatorframework.io/v1alpha1 +kind: ClusterExtension +metadata: + name: argocd +spec: + source: + sourceType: Catalog + catalog: + packageName: argocd-operator + version: “~2.3" # Automatically upgrade patch releases for v2.3 + install: + namespace: argocd + serviceAccount: + name: argocd-installer +``` + +For more information on SemVer version ranges see [version ranges](version-ranges.md)