Addressing request to re-add notes regarding 2.6 (#528)

* Addressing request to re-add notes regarding 2.6 * versioned docs updated as well * rm'ed note from page that didn't need it added back * zh pages + missing en page
2026-05-02 11:13:20 +00:00 · 2023-04-11 14:59:35 -04:00
parent d02daea025
commit 5de5735017
17 changed files with 116 additions and 0 deletions
@@ -102,6 +102,12 @@ helm repo update

 从 [Helm Chart 仓库](https://artifacthub.io/packages/helm/cert-manager/cert-manager)中获取最新可用的 cert-manager Chart：

+:::note
+
+v2.6.4 兼容 cert-manager 版本 1.6.2 和 1.7.1。推荐使用 v1.7.x，因为 v 1.6.x 将在 2022 年 3 月 30 日结束生命周期。
+
+:::
+
 ```plain
 helm fetch jetstack/cert-manager --version v1.11.0
 ```
@@ -56,9 +56,20 @@ title: '2. 收集镜像并发布到私有仓库'

 在 Kubernetes 安装中，如果你使用的是 Rancher 默认的自签名 TLS 证书，则必须将 [`cert-manager`](https://artifacthub.io/packages/helm/cert-manager/cert-manager) 镜像添加到 `rancher-images.txt` 文件中。

+:::note
+
+v2.6.4 兼容 cert-manager 版本 1.6.2 和 1.7.1。推荐使用 v1.7.x，因为 v 1.6.x 将在 2022 年 3 月 30 日结束生命周期。
+
+:::

 1. 获取最新的 `cert-manager` Helm Chart，并解析模板以获取镜像的详情信息：

+   :::note
+
+   由于 cert-manager 的最新改动，你需要升级 cert-manager 版本。如果你需要升级 Rancher 并使用低于 0.12.0 的 cert-manager 版本，请参见[升级文档](../../resources/upgrade-cert-manager.md)。
+
+   :::
+
   ```plain
   helm repo add jetstack https://charts.jetstack.io
   helm repo update
@@ -30,6 +30,12 @@ kubectl create namespace cert-manager

 安装 cert-manager 的 CustomResourceDefinitions：

+:::note
+
+v2.6.4 兼容 cert-manager 版本 1.6.2 和 1.7.1。推荐使用 v1.7.x，因为 v 1.6.x 将在 2022 年 3 月 30 日结束生命周期。
+
+:::
+
 ```
 kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.11.0/cert-manager.crds.yaml
 ```
@@ -259,6 +259,13 @@ cert-manager-webhook-787858fcdb-nlzsq      1/1     Running   0          2m

 ## Cert-Manager API 变更和数据迁移

+---
+_v2.6.4 的新功能_
+
+Rancher 现在支持 cert-manager 1.6.2 和 1.7.1。推荐使用 v1.7.x，因为 v 1.6.x 将在 2022 年 3 月 30 日结束生命周期。详情请参见 [cert-manager 文档](../../../pages-for-subheaders/install-upgrade-on-a-kubernetes-cluster.md#4-安装-cert-manager)。有关将 cert-manager 从 1.5 升级到 1.6 的说明，请参见上游的 [cert-manager 文档](https://cert-manager.io/docs/installation/upgrading/upgrading-1.5-1.6/)。有关将 cert-manager 从 1.6 升级到 1.7 的说明，请参见上游的 [cert-manager 文档](https://cert-manager.io/docs/installation/upgrading/upgrading-1.6-1.7/)。
+
+---
+
 Cert-manager 已经弃用 `certificate.spec.acme.solvers` 字段，而且会在未来的版本中放弃对该字段的支持。

 根据 cert-manager 文档，v0.8 引入了配置 ACME 证书资源的新格式。具体来说，就是移动了 challenge solver 字段。v0.9 新旧格式均支持。请知悉，之后发布的新 cert-manager 版本会放弃对旧格式的支持。Cert-Manager 文档建议你在更新后，将 ACME 颁发者和证书资源更新到新格式。
@@ -122,6 +122,12 @@ Rancher Management Server 默认需要 SSL/TLS 配置来保证访问的安全性

 ### 4. 安装 cert-manager

+:::note
+
+v2.6.4 兼容 cert-manager 版本 1.6.2 和 1.7.1。推荐使用 v1.7.x，因为 v 1.6.x 将在 2022 年 3 月 30 日结束生命周期。
+
+:::
+
 > 如果你使用自己的证书文件（`ingress.tls.source=secret`）或使用[外部负载均衡器的 TLS 终止](../getting-started/installation-and-upgrade/installation-references/helm-chart-options.md#外部-tls-终止)，你可以跳过此步骤。

 仅在使用 Rancher 生成的证书（`ingress.tls.source=rancher`）或 Let's Encrypt 颁发的证书（`ingress.tls.source=letsEncrypt`）时，才需要安装 cert-manager。