From f27aee4743c3d9a17b565fe351ea27a62856fbff Mon Sep 17 00:00:00 2001 From: Derek Su Date: Tue, 21 Jan 2025 10:49:21 +0800 Subject: [PATCH 1/2] docs(v1.8.0): update image versions Longhorn 10010 Signed-off-by: Derek Su --- content/docs/1.8.0/references/helm-values.md | 24 +++++++++---------- .../enable-csi-snapshot-support.md | 8 +++---- 2 files changed, 16 insertions(+), 16 deletions(-) diff --git a/content/docs/1.8.0/references/helm-values.md b/content/docs/1.8.0/references/helm-values.md index b0bbec6f5..b6deae151 100644 --- a/content/docs/1.8.0/references/helm-values.md +++ b/content/docs/1.8.0/references/helm-values.md @@ -30,31 +30,31 @@ The `values.yaml` file contains items used to tweak a deployment of this chart. | Key | Type | Default | Description | |-----|------|---------|-------------| | image.csi.attacher.repository | string | `"longhornio/csi-attacher"` | Repository for the CSI attacher image. When unspecified, Longhorn uses the default value. | -| image.csi.attacher.tag | string | `"v4.4.2"` | Tag for the CSI attacher image. When unspecified, Longhorn uses the default value. | +| image.csi.attacher.tag | string | `"v4.8.0"` | Tag for the CSI attacher image. When unspecified, Longhorn uses the default value. | | image.csi.livenessProbe.repository | string | `"longhornio/livenessprobe"` | Repository for the CSI liveness probe image. When unspecified, Longhorn uses the default value. | -| image.csi.livenessProbe.tag | string | `"v2.12.0"` | Tag for the CSI liveness probe image. When unspecified, Longhorn uses the default value. | +| image.csi.livenessProbe.tag | string | `"v2.15.0"` | Tag for the CSI liveness probe image. When unspecified, Longhorn uses the default value. | | image.csi.nodeDriverRegistrar.repository | string | `"longhornio/csi-node-driver-registrar"` | Repository for the CSI Node Driver Registrar image. When unspecified, Longhorn uses the default value. | -| image.csi.nodeDriverRegistrar.tag | string | `"v2.9.2"` | Tag for the CSI Node Driver Registrar image. When unspecified, Longhorn uses the default value. | +| image.csi.nodeDriverRegistrar.tag | string | `"v2.13.0"` | Tag for the CSI Node Driver Registrar image. When unspecified, Longhorn uses the default value. | | image.csi.provisioner.repository | string | `"longhornio/csi-provisioner"` | Repository for the CSI Provisioner image. When unspecified, Longhorn uses the default value. | -| image.csi.provisioner.tag | string | `"v3.6.2"` | Tag for the CSI Provisioner image. When unspecified, Longhorn uses the default value. | +| image.csi.provisioner.tag | string | `"v5.1.0-20241220"` | Tag for the CSI Provisioner image. When unspecified, Longhorn uses the default value. | | image.csi.resizer.repository | string | `"longhornio/csi-resizer"` | Repository for the CSI Resizer image. When unspecified, Longhorn uses the default value. | -| image.csi.resizer.tag | string | `"v1.9.2"` | Tag for the CSI Resizer image. When unspecified, Longhorn uses the default value. | +| image.csi.resizer.tag | string | `"v1.13.1"` | Tag for the CSI Resizer image. When unspecified, Longhorn uses the default value. | | image.csi.snapshotter.repository | string | `"longhornio/csi-snapshotter"` | Repository for the CSI Snapshotter image. When unspecified, Longhorn uses the default value. | -| image.csi.snapshotter.tag | string | `"v6.3.2"` | Tag for the CSI Snapshotter image. When unspecified, Longhorn uses the default value. | +| image.csi.snapshotter.tag | string | `"v8.2.0"` | Tag for the CSI Snapshotter image. When unspecified, Longhorn uses the default value. | | image.longhorn.backingImageManager.repository | string | `"longhornio/backing-image-manager"` | Repository for the Backing Image Manager image. When unspecified, Longhorn uses the default value. | -| image.longhorn.backingImageManager.tag | string | `"master-head"` | Tag for the Backing Image Manager image. When unspecified, Longhorn uses the default value. | +| image.longhorn.backingImageManager.tag | string | `"v1.8.0"` | Tag for the Backing Image Manager image. When unspecified, Longhorn uses the default value. | | image.longhorn.engine.repository | string | `"longhornio/longhorn-engine"` | Repository for the Longhorn Engine image. | -| image.longhorn.engine.tag | string | `"master-head"` | Tag for the Longhorn Engine image. | +| image.longhorn.engine.tag | string | `"v1.8.0"` | Tag for the Longhorn Engine image. | | image.longhorn.instanceManager.repository | string | `"longhornio/longhorn-instance-manager"` | Repository for the Longhorn Instance Manager image. | -| image.longhorn.instanceManager.tag | string | `"master-head"` | Tag for the Longhorn Instance Manager image. | +| image.longhorn.instanceManager.tag | string | `"v1.8.0"` | Tag for the Longhorn Instance Manager image. | | image.longhorn.manager.repository | string | `"longhornio/longhorn-manager"` | Repository for the Longhorn Manager image. | -| image.longhorn.manager.tag | string | `"master-head"` | Tag for the Longhorn Manager image. | +| image.longhorn.manager.tag | string | `"v1.8.0"` | Tag for the Longhorn Manager image. | | image.longhorn.shareManager.repository | string | `"longhornio/longhorn-share-manager"` | Repository for the Longhorn Share Manager image. | -| image.longhorn.shareManager.tag | string | `"master-head"` | Tag for the Longhorn Share Manager image. | +| image.longhorn.shareManager.tag | string | `"v1.8.0"` | Tag for the Longhorn Share Manager image. | | image.longhorn.supportBundleKit.repository | string | `"longhornio/support-bundle-kit"` | Repository for the Longhorn Support Bundle Manager image. | | image.longhorn.supportBundleKit.tag | string | `"v0.0.37"` | Tag for the Longhorn Support Bundle Manager image. | | image.longhorn.ui.repository | string | `"longhornio/longhorn-ui"` | Repository for the Longhorn UI image. | -| image.longhorn.ui.tag | string | `"master-head"` | Tag for the Longhorn UI image. | +| image.longhorn.ui.tag | string | `"v1.8.0"` | Tag for the Longhorn UI image. | | image.openshift.oauthProxy.repository | string | `""` | Repository for the OAuth Proxy image. Specify the upstream image (for example, "quay.io/openshift/origin-oauth-proxy"). This setting applies only to OpenShift users. | | image.openshift.oauthProxy.tag | float | `""` | Tag for the OAuth Proxy image. Specify OCP/OKD version 4.1 or later (including version 4.15, which is available at quay.io/openshift/origin-oauth-proxy:4.15). This setting applies only to OpenShift users. | | image.pullPolicy | string | `"IfNotPresent"` | Image pull policy that applies to all user-deployed Longhorn components, such as Longhorn Manager, Longhorn driver, and Longhorn UI. | diff --git a/content/docs/1.8.0/snapshots-and-backups/csi-snapshot-support/enable-csi-snapshot-support.md b/content/docs/1.8.0/snapshots-and-backups/csi-snapshot-support/enable-csi-snapshot-support.md index 6a1505f42..c08da7615 100644 --- a/content/docs/1.8.0/snapshots-and-backups/csi-snapshot-support/enable-csi-snapshot-support.md +++ b/content/docs/1.8.0/snapshots-and-backups/csi-snapshot-support/enable-csi-snapshot-support.md @@ -24,14 +24,14 @@ You may manually install these components by executing the following steps. > For example, on a vanilla Kubernetes cluster, update the namespace from `default` to `kube-system` prior to issuing the `kubectl create` command. Install the Snapshot CRDs: -1. Download the files from https://github.com/kubernetes-csi/external-snapshotter/tree/v8.1.0/client/config/crd -because Longhorn v{{< current-version >}} uses [CSI external-snapshotter](https://kubernetes-csi.github.io/docs/external-snapshotter.html) v8.1.0 +1. Download the files from https://github.com/kubernetes-csi/external-snapshotter/tree/v8.2.0/client/config/crd +because Longhorn v{{< current-version >}} uses [CSI external-snapshotter](https://kubernetes-csi.github.io/docs/external-snapshotter.html) v8.2.0 2. Run `kubectl create -k client/config/crd`. 3. Do this once per cluster. Install the Common Snapshot Controller: -1. Download the files from https://github.com/kubernetes-csi/external-snapshotter/tree/v8.1.0/deploy/kubernetes/snapshot-controller -because Longhorn v{{< current-version >}} uses [CSI external-snapshotter](https://kubernetes-csi.github.io/docs/external-snapshotter.html) v8.1.0 +1. Download the files from https://github.com/kubernetes-csi/external-snapshotter/tree/v8.2.0/deploy/kubernetes/snapshot-controller +because Longhorn v{{< current-version >}} uses [CSI external-snapshotter](https://kubernetes-csi.github.io/docs/external-snapshotter.html) v8.2.0 2. Update the namespace to an appropriate value for your environment (e.g. `kube-system`) 3. Run `kubectl create -k deploy/kubernetes/snapshot-controller`. 3. Do this once per cluster. From a6dd381639b08b00850fd23d10786ad62b6fb8e8 Mon Sep 17 00:00:00 2001 From: Derek Su Date: Tue, 21 Jan 2025 11:25:24 +0800 Subject: [PATCH 2/2] docs(1.8.0): update important note Longhorn 10010 Signed-off-by: Derek Su --- content/docs/1.8.0/important-notes/_index.md | 5 +++++ content/docs/1.9.0/important-notes/_index.md | 5 +++++ 2 files changed, 10 insertions(+) diff --git a/content/docs/1.8.0/important-notes/_index.md b/content/docs/1.8.0/important-notes/_index.md index 7d076b4e1..9f0b32e42 100644 --- a/content/docs/1.8.0/important-notes/_index.md +++ b/content/docs/1.8.0/important-notes/_index.md @@ -9,6 +9,7 @@ Please see [here](https://github.com/longhorn/longhorn/releases/tag/v{{< current - [Deprecation](#deprecation) - [Environment Check Script](#environment-check-script) - [General](#general) + - [Kubernetes Version Requirement](#kubernetes-version-requirement) - [Upgrade Check Events](#upgrade-check-events) - [Manual Checks Before Upgrade](#manual-checks-before-upgrade) - [Install/Upgrade with Helm Controller](#installupgrade-with-helm-controller) @@ -41,6 +42,10 @@ The functionality of the [environment check script](https://github.com/longhorn/ ## General +### Kubernetes Version Requirement + +Due to the upgrade of the CSI external snapshotter to version v8.2.0, ensure that all clusters are running Kubernetes v1.25 or later before upgrading to Longhorn v1.8.0 or any newer version. + ### Upgrade Check Events Longhorn performs a pre-upgrade check when upgrading with Helm or Rancher App Marketplace. If a check fails, the upgrade will stop and the reason for the check's failure will be recorded in an event. For more detail, see [Upgrading Longhorn Manager](../deploy/upgrade/longhorn-manager). diff --git a/content/docs/1.9.0/important-notes/_index.md b/content/docs/1.9.0/important-notes/_index.md index 7d076b4e1..9f0b32e42 100644 --- a/content/docs/1.9.0/important-notes/_index.md +++ b/content/docs/1.9.0/important-notes/_index.md @@ -9,6 +9,7 @@ Please see [here](https://github.com/longhorn/longhorn/releases/tag/v{{< current - [Deprecation](#deprecation) - [Environment Check Script](#environment-check-script) - [General](#general) + - [Kubernetes Version Requirement](#kubernetes-version-requirement) - [Upgrade Check Events](#upgrade-check-events) - [Manual Checks Before Upgrade](#manual-checks-before-upgrade) - [Install/Upgrade with Helm Controller](#installupgrade-with-helm-controller) @@ -41,6 +42,10 @@ The functionality of the [environment check script](https://github.com/longhorn/ ## General +### Kubernetes Version Requirement + +Due to the upgrade of the CSI external snapshotter to version v8.2.0, ensure that all clusters are running Kubernetes v1.25 or later before upgrading to Longhorn v1.8.0 or any newer version. + ### Upgrade Check Events Longhorn performs a pre-upgrade check when upgrading with Helm or Rancher App Marketplace. If a check fails, the upgrade will stop and the reason for the check's failure will be recorded in an event. For more detail, see [Upgrading Longhorn Manager](../deploy/upgrade/longhorn-manager).