Update v2.6/v2.7 translation and fix v2.4-related broken links (#531)

* Update v2.7 translation * Update v2.6 translation * Fix broken links
2026-05-01 02:33:15 +00:00 · 2023-04-11 22:38:54 +08:00
parent a5e3b54e32
commit 1b5278c3a9
13 changed files with 66 additions and 52 deletions
@@ -32,7 +32,8 @@ RKE v1.1.0 改变了集群升级的方式。

 :::note 先决条件：

- 以下选项仅适用于 [Rancher 启动的 RKE Kubernetes 集群](../../pages-for-subheaders/launch-kubernetes-with-rancher.md)和[注册的 K3s Kubernetes 集群](../../how-to-guides/new-user-guides/kubernetes-clusters-in-rancher-setup/register-existing-clusters.md#注册-k3s-集群的其他功能)。
+- 以下选项适用于 [Rancher 启动的 Kubernetes 集群](../../pages-for-subheaders/launch-kubernetes-with-rancher.md)和[注册的 K3s Kubernetes 集群](../../how-to-guides/new-user-guides/kubernetes-clusters-in-rancher-setup/register-existing-clusters.md#注册-k3s-集群的其他功能)。
+- 以下选项也适用于导入且已注册的 RKE2 集群。如果你从外部云平台导入集群但不注册，你将无法在 Rancher 中升级 Kubernetes 版本。
 - 在升级 Kubernetes 之前，先[备份你的集群](../../pages-for-subheaders/backup-restore-and-disaster-recovery.md)。

 :::
@@ -15,14 +15,14 @@ title: Helm CLI 快速入门

 ## 在 Linux 上安装 K3s

+Rancher 需要安装在支持的 Kubernetes 版本上。如需指定 K3s 版本，在运行 K3s 安装脚本时使用 `INSTALL_K3S_VERSION` 环境变量（例如 `INSTALL_K3S_VERSION="v1.24.10+k3s1"`）。请参阅[支持维护条款](https://rancher.com/support-maintenance-terms/)。
+
 在 Linux 主机上运行以下命令来安装 K3s 集群：

 ```
-curl -sfL https://get.k3s.io | INSTALL_K3S_VERSION="***" sh -s - server --cluster-init
+curl -sfL https://get.k3s.io | INSTALL_K3S_VERSION=<VERSION> sh -s - server --cluster-init
 ```

-Rancher 需要安装在支持的 Kubernetes 版本上。如需指定 K3s 版本，在运行 K3s 安装脚本时，使用 `INSTALL_K3S_VERSION` 环境变量。请参阅[支持维护条款](https://rancher.com/support-maintenance-terms/)。
-
 `--cluster-init` 允许 K3s 使用嵌入式 etcd 作为数据存储，并能够转换为 HA 设置。请参阅[嵌入式数据库的高可用性](https://rancher.com/docs/k3s/latest/en/installation/ha-embedded/)。

 保存 Linux 主机的 IP。
@@ -38,6 +38,8 @@ kubeconfig 文件对于访问 Kubernetes 集群非常重要。从 Linux 主机
 scp root@<IP_OF_LINUX_MACHINE>:/etc/rancher/k3s/k3s.yaml ~/.kube/config
 ```

+在某些情况下，它可能需要确保你的 shell 定义了环境变量 `KUBECONFIG=~/.kube/config`，例如，它可以在你的配置文件或 rc 文件中导出。
+
 </TabItem>
 <TabItem value="Windows">

@@ -2,36 +2,56 @@
 title: 配置全局默认私有镜像仓库
 ---

-你可以使用私有容器镜像仓库，在组织内共享你的自定义系统镜像。借助私有镜像仓库，你可以让集群使用私有的、一致的、且来源可信的、集中的系统镜像。
+:::note
+本页介绍了安装 Rancher 后如何从 Rancher UI 配置全局默认私有镜像仓库。

-在 Rancher 中设置私有镜像仓库的主要方法有两种：通过全局视图中的**设置**选项卡设置全局默认镜像仓库，以及在集群级别设置的高级选项中设置私有镜像仓库。全局默认镜像仓库可以用于离线设置，不需要凭证的镜像仓库。而集群级私有镜像仓库用于所有需要凭证的私有镜像仓库。
+有关如何在 Rancher 安装期间设置私有镜像仓库的说明，请参阅[离线安装指南](../../../pages-for-subheaders/air-gapped-helm-cli-install.md)。

-本文介绍了全局默认私有镜像仓库的配置，重点介绍安装 Rancher 后如何从 Rancher UI 配置镜像仓库。
+:::

-有关在安装 Rancher 期间使用命令行选项设置私有镜像仓库的说明，请参见[离线安装指南](../../../pages-for-subheaders/air-gapped-helm-cli-install.md)。
+私有镜像仓库是集群中私有、一致且集中的容器镜像源。你可以使用私有容器镜像仓库，在组织内共享自定义基础镜像。

-如果你的私有镜像仓库需要凭证，则它不能用作默认镜像仓库。没有全局的方法来为每个 Rancher 所配置的集群设置具有授权认证的私有镜像仓库。因此，如果你希望 Rancher 配置的集群使用凭证从私有镜像仓库中拉取镜像，则每次创建新集群时都必须[通过高级集群选项传递镜像仓库凭证](#部署集群时设置需要凭证的私有镜像仓库)。
+在 Rancher 中设置私有镜像仓库主要有两种方式：
+
+* 通过全局视图中的 **Settings** 选项卡设置全局默认镜像仓库。
+* 在集群级别设置下的高级选项中设置私有镜像仓库。
+
+全局默认镜像仓库适用于离线环境，可用于不需要凭证的镜像仓库。而集群级私有镜像仓库用于需要凭证的私有镜像仓库。

 ## 将不需要凭证的私有镜像仓库设置为默认镜像仓库

 1. 登录 Rancher 并配置默认管理员密码。
-1. 单击 **☰ > 全局设置**。
-1. 转到名为 `system-default-registry` 的设置，然后选择 **⋮ > 编辑设置**。
-1. 将值更改为你的镜像仓库（例如 `registry.yourdomain.com:port`）。不要在镜像仓库前加上 `http://` 或 `https://`。
+1. 选择 **☰ > 全局设置**。
+1. 转到 `system-default-registry` 并选择 **⋮ > 编辑设置**。
+1. 输入你镜像仓库的主机名和端口（例如 `registry.yourdomain.com:port`）。不要在文本前加上 `http://` 或 `https://`。

-**结果**：Rancher 将使用你的私有镜像仓库拉取系统镜像。
+**结果**：Rancher 会从你的私有镜像仓库中拉取系统镜像。

-## 部署集群时设置需要凭证的私有镜像仓库
+### 带 RKE2 下游集群的命名空间私有镜像仓库

-创建集群时，你可以按照以下步骤配置私有镜像仓库：
+默认情况下，大多数私有镜像仓库应该能与 RKE2 下游集群一起工作。

-1. 点击 **☰ > 集群管理**。
+但是，如果你尝试设置 URL 格式为 `website/subdomain:portnumber` 的命名空间私有镜像仓库，则需要执行额外的步骤：
+
+1. 选择 **☰ > 集群管理**。
+1. 在列表中找到 RKE2 集群，然后点击 **⋮ > 编辑配置**。
+1. 从**集群配置**菜单中，选择**镜像仓库**。
+1. 在**镜像仓库**中，选择**配置高级 Containerd Mirror 和仓库认证选项**选项。
+1. 在 **Mirrors** 下的文本字段中，输入**镜像仓库主机名**和 **Mirror 端点**。
+1. 单击**保存**。
+1. 根据需要对每个下游 RKE2 集群重复操作。
+
+## 创建集群时配置使用凭证的私有镜像仓库
+
+无法为每个 Rancher 配置的集群全局设置具有授权认证的私有镜像仓库。因此，如果你希望 Rancher 配置的集群从使用凭证的私有镜像仓库中拉取镜像，则每次创建新集群时都必须通过高级集群选项传递镜像仓库凭证。
+
+由于创建集群后无法配置私有镜像仓库，因此你需要在初始集群设置期间执行这些步骤。
+
+1. 选择 **☰ > 集群管理**。
 1. 在**集群**页面上，单击**创建**。
 1. 选择集群类型。
-1. 在**集群配置**中，转到**镜像仓库**选项卡，然后单击**为 Rancher 从私有镜像仓库中拉取镜像**。
+1. 在**集群配置**中，转到**镜像仓库**选项卡，然后选择**为 Rancher 从私有镜像仓库中拉取镜像**。
 1. 输入镜像仓库主机名和凭证。
 1. 单击**创建**。

-**结果**：新集群将能够从私有镜像仓库中拉取镜像。
-
-集群创建后无法配置私有镜像仓库。
+**结果**：新集群将从私有镜像仓库中拉取镜像。
@@ -17,9 +17,7 @@ Rancher 管理注册集群的范围取决于集群的类型。详情请参见[

 ### 权限

-如果你现有的 Kubernetes 集群已经定义了 `cluster-admin` 角色，则你必须具有此 `cluster-admin` 权限才能在 Rancher 中注册集群。
-
-为了应用权限，你需要先运行：
+要在 Rancher 中注册集群，你必须在该集群中拥有 `cluster-admin` 权限。如果没有，请运行以下命令将权限授予用户：

 ```plain
 kubectl create clusterrolebinding cluster-admin-binding \
@@ -27,13 +25,11 @@ kubectl create clusterrolebinding cluster-admin-binding \
  --user [USER_ACCOUNT]
 ```

-然后再运行 `kubectl` 命令来注册集群。
-
-默认情况下，GKE 用户没有此权限，因此你需要在注册 GKE 集群之前运行该命令。要详细了解 GKE RBAC，请单击[此处](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control)。
+由于默认情况下 Google Kubernetes Engine (GKE) 不授予 `cluster-admin` 角色，因此你必须先在 GKE 集群上运行命令，然后才能注册。要详细了解 GKE RBAC，请参阅 [Google 官方文档](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control)。

 ### EKS、AKS 和 GKE 集群

-EKS、AKS 和 GKE 集群必须至少有一个托管节点组才能导入 Rancher 或通过 Rancher 进行配置。
+要成功将这些集群导入 Rancher 或从 Rancher 中配置它们，Elastic Kubernetes Service (EKS)、Azure Kubernetes Service (AKS) 和 Google Kubernetes Engine (GKE) 集群必须至少有一个托管节点组。

 ## 注册集群

@@ -128,13 +124,11 @@ RKE2 或 K3s 集群注册到 Rancher 后，Rancher 会识别它。Rancher UI 将

 ### 已注册 EKS, AKS 和 GKE 集群的附加功能

-如果你注册了 Amazon EKS、Azure AKS 或 GKE 集群，Rancher 将视其为在 Rancher 中创建的集群。
+Rancher 处理注册的 EKS、AKS 或 GKE 集群的方式与处理在 Rancher 中创建的集群的方式类似。但是，如果你通过 Rancher UI 删除已注册的集群，Rancher 不会销毁这些集群。

-你现在可以将 Amazon EKS、Azure AKS 和 GKE 集群注册到 Rancher。在大多数情况下，注册的集群和在 Rancher UI 中创建的集群的处理方式相同（除了删除）。
+如果你在 Rancher 中创建 EKS、AKS 或 GKE 集群，然后将其删除，Rancher 会销毁该集群。通过 Rancher 删除已注册的集群时，Rancher Server 会_断开_与集群的连接。该集群仍然存在，只是它不再在 Rancher 中。你仍然可以像注册前一样访问已注销的集群。

-删除在 Rancher 中创建的 EKS、AKS 或 GKE 集群后，该集群将被销毁。删除在 Rancher 中注册集群时，它与 Rancher Server 会断开连接，但它仍然存在。你仍然可以像在 Rancher 中注册之前一样访问它。
-
-[此页面](../../../pages-for-subheaders/kubernetes-clusters-in-rancher-setup.md)上的表格中列出了已注册集群的功能。
+有关可用于管理已注册集群的功能，请参阅[按集群类型划分的集群管理功能](../../../pages-for-subheaders/kubernetes-clusters-in-rancher-setup.md)。

 ## 配置 RKE2 和 K3s 集群升级