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
This commit is contained in:
vickyhella
2023-04-11 10:38:54 -04:00
committed by GitHub
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 集群升级
@@ -80,7 +80,7 @@ kubectl -n cattle-system apply -R -f ./rancher
升级后出现网络问题?
请参见[恢复集群网络](../../../../version-2.0-2.4/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/upgrades/namespace-migration.md)。
请参见[恢复集群网络](/versioned_docs/version-2.0-2.4/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/upgrades/namespace-migration.md)。
:::
@@ -99,7 +99,7 @@ helm rollback rancher 3 -n cattle-system
## 回滚到 Rancher 2.2-2.4
要回滚到 2.5 之前的 Rancher 版本,参考此处的步骤[恢复备份 — Kubernetes 安装](../../../../version-2.0-2.4/how-to-guides/new-user-guides/backup-restore-and-disaster-recovery/restore-rancher-launched-kubernetes-clusters-from-backup.md)。如果恢复 Rancher Server 的集群的某个快照,Rancher 的版本以及状态均会恢复回到快照时的版本和状态。
要回滚到 2.5 之前的 Rancher 版本,参考此处的步骤[恢复备份 — Kubernetes 安装](/versioned_docs/version-2.0-2.4/how-to-guides/new-user-guides/backup-restore-and-disaster-recovery/restore-rancher-launched-kubernetes-clusters-from-backup.md)。如果恢复 Rancher Server 的集群的某个快照,Rancher 的版本以及状态均会恢复回到快照时的版本和状态。
有关回滚 Docker 安装的 Rancher,请参见[本页](../other-installation-methods/rancher-on-a-single-node-with-docker/roll-back-docker-installed-rancher.md)。
@@ -111,4 +111,4 @@ helm rollback rancher 3 -n cattle-system
## 回滚到 Rancher 2.0-2.1
我们不再支持回滚到 Rancher 2.0-2.1。回滚到这些版本的说明保留在[此处](../../../../version-2.0-2.4/how-to-guides/new-user-guides/backup-restore-and-disaster-recovery/restore-rancher-launched-kubernetes-clusters-from-backup/roll-back-to-v2.0-v2.1.md),仅用于无法升级到 v2.2 的情况。
我们不再支持回滚到 Rancher 2.0-2.1。回滚到这些版本的说明保留在[此处](/versioned_docs/version-2.0-2.4/how-to-guides/new-user-guides/backup-restore-and-disaster-recovery/restore-rancher-launched-kubernetes-clusters-from-backup/roll-back-to-v2.0-v2.1.md),仅用于无法升级到 v2.2 的情况。
@@ -27,7 +27,7 @@ kubeconfig 也可以通过 `--kubeconfig` 标签(详情请参见 https://helm.
本安装指南假定你使用的是 Helm 3。
如果你使用 Helm 2,请参见 [Helm 2 迁移到 Helm 3 文档](https://helm.sh/blog/migrate-from-helm-v2-to-helm-v3/)。如果你不能升级到 Helm 3[Helm 2 升级页面](../../../../version-2.0-2.4/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/upgrades/helm2.md)提供了使用 Helm 2 升级的旧升级指南。
如果你使用 Helm 2,请参见 [Helm 2 迁移到 Helm 3 文档](https://helm.sh/blog/migrate-from-helm-v2-to-helm-v3/)。如果你不能升级到 Helm 3[Helm 2 升级页面](/versioned_docs/version-2.0-2.4/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/upgrades/helm2.md)提供了使用 Helm 2 升级的旧升级指南。
### 离线安装:推送镜像到私有镜像仓库
@@ -170,7 +170,7 @@ helm upgrade rancher rancher-<CHART_REPO>/rancher \
升级后出现网络问题?
请参见[恢复集群网络](../../../../version-2.0-2.4/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/upgrades/namespace-migration.md)。
请参见[恢复集群网络](/versioned_docs/version-2.0-2.4/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/upgrades/namespace-migration.md)。
:::
@@ -380,7 +380,7 @@ docker run -d --volumes-from rancher-data \
:::note 升级后下游集群出现网络问题?
请参见[恢复集群网络](../../../../../version-2.0-2.4/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/upgrades/namespace-migration.md)。
请参见[恢复集群网络](/versioned_docs/version-2.0-2.4/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/upgrades/namespace-migration.md)。
:::
@@ -4,7 +4,7 @@ title: Helm 版本要求
本文介绍 Helm 的要求。Helm 是用于把 Rancher 安装在高可用 Kubernetes 集群上的工具。
> 我们已针对 Helm 3 更新了安装指南。如果你使用 Helm 2 进行安装,请参见 [Helm 2 迁移到 Helm 3 文档](https://helm.sh/blog/migrate-from-helm-v2-to-helm-v3/)。[本文](../../../../version-2.0-2.4/pages-for-subheaders/helm2.md)提供了较早的使用 Helm 2 的 Rancher 高可用安装指南的副本。如果你如果无法升级到 Helm 3,可以使用这个说明安装。
> 我们已针对 Helm 3 更新了安装指南。如果你使用 Helm 2 进行安装,请参见 [Helm 2 迁移到 Helm 3 文档](https://helm.sh/blog/migrate-from-helm-v2-to-helm-v3/)。[本文](/versioned_docs/version-2.0-2.4/pages-for-subheaders/helm2.md)提供了较早的使用 Helm 2 的 Rancher 高可用安装指南的副本。如果你如果无法升级到 Helm 3,可以使用这个说明安装。
- 如需安装或升级 Rancher 2.5,请使用 Helm 3.2.x 或更高版本。
- Kubernetes 1.16 要求 Helm 2.16.0 或更高版本。如果使用的是默认 Kubernetes 版本,请参见[发行说明](https://github.com/rancher/rke/releases)获取所使用的 RKE 版本。
@@ -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)。
:::
@@ -10,7 +10,7 @@ title: 配置全局默认私有镜像仓库
有关在安装 Rancher 期间使用命令行选项设置私有镜像仓库的说明,请参见[离线安装指南](../../../pages-for-subheaders/air-gapped-helm-cli-install.md)。
如果你的私有镜像仓库需要凭证,则它不能用作默认镜像仓库。没有全局的方法来为每个 Rancher 配置的集群设置具有授权认证的私有镜像仓库。因此,如果你希望 Rancher 配置的集群使用凭证从私有镜像仓库中拉取镜像,则每次创建新集群时都必须[通过高级集群选项传递镜像仓库凭证](#部署集群时设置需要凭证的私有镜像仓库)。
如果你的私有镜像仓库需要凭证,则它不能用作默认镜像仓库。无法为每个 Rancher 配置的集群全局设置具有授权认证的私有镜像仓库。因此,如果你希望 Rancher 配置的集群使用凭证从私有镜像仓库中拉取镜像,则每次创建新集群时都必须[通过高级集群选项传递镜像仓库凭证](#部署集群时设置需要凭证的私有镜像仓库)。
## 将不需要凭证的私有镜像仓库设置为默认镜像仓库
@@ -17,9 +17,7 @@ Rancher 管理注册集群的范围取决于集群的类型。详情请参见[
### 权限
如果你现有的 Kubernetes 集群已经定义了 `cluster-admin` 角色,则你必须具有此 `cluster-admin` 权限才能在 Rancher 中注册集群。
为了应用权限,你需要先运行:
要在 Rancher 中注册集群,你必须在该集群中拥有 `cluster-admin` 权限。如果没有,请运行以下命令将权限授予用户:
```plain
kubectl create clusterrolebinding cluster-admin-binding \
@@ -29,7 +27,7 @@ kubectl create clusterrolebinding cluster-admin-binding \
然后再运行 `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)。
如果你正在注册 K3s 集群,请确保 `cluster.yml` 是可读的。默认情况下它受到保护。详情请参考[配置 K3s 集群以导入到 Rancher](#配置-k3s-集群以在-rancher-中启用注册)。
@@ -142,15 +140,13 @@ K3s 集群注册到 Rancher 后,Rancher 会将它识别为 K3s。Rancher UI
- 配置能同时升级的最大节点数
- 查看 K3s 集群的配置参数和用于启动集群中每个节点的环境变量的只读版本
### 已注册 EKS 和 GKE 集群的附加功能
### 已注册 EKS, AKS 和 GKE 集群的附加功能
如果你注册了 Amazon EKS 或 GKE 集群,Rancher 将视其为在 Rancher 中创建的集群。
Rancher 处理注册的 EKS、AKS 或 GKE 集群的方式与处理在 Rancher 中创建的集群的方式类似。但是,如果你通过 Rancher UI 删除已注册的集群,Rancher 不会销毁这些集群。
你现在可以将 Amazon EKS GKE 集群注册到 Rancher。在大多数情况下,注册的集群和在 Rancher UI 中创建的集群的处理方式相同(除了删除)
如果你在 Rancher 中创建 EKS、AKS GKE 集群,然后将其删除,Rancher 会销毁该集群。通过 Rancher 删除已注册的集群时,Rancher Server 会_断开_与集群的连接。该集群仍然存在,只是它不再在 Rancher 中。你仍然可以像注册前一样访问已注销的集群
删除在 Rancher 中创建的 EKS 或 GKE 集群后,该集群将被销毁。删除在 Rancher 中注册集群时,它与 Rancher Server 会断开连接,但它仍然存在。你仍然可以像在 Rancher 中注册之前一样访问它
[此页面](../../../pages-for-subheaders/kubernetes-clusters-in-rancher-setup.md)上的表格中列出了已注册集群的功能。
有关可用于管理已注册集群的功能,请参阅[按集群类型划分的集群管理功能](../../../pages-for-subheaders/kubernetes-clusters-in-rancher-setup.md)
## 配置 K3s 集群升级
@@ -291,7 +291,7 @@ timeout: 30
1. 选择通知的条件。你可以选择接收以下状态的通知:`失败``成功``已更改`。例如,如果你想在执行失败时接收通知,请选择**失败**。
1. 如果你没有现有的通知器,Rancher 会提示未设置通知器的警告,并显示跳转到通知器页面的链接。你可以按照[说明](../../../version-2.0-2.4/explanations/integrations-in-rancher/notifiers.md)添加通知器。如果你已经有通知器,你可以单击**添加收件人**按钮,将他们添加到通知中。
1. 如果你没有现有的通知器,Rancher 会提示未设置通知器的警告,并显示跳转到通知器页面的链接。你可以按照[说明](/versioned_docs/version-2.0-2.4/explanations/integrations-in-rancher/notifiers.md)添加通知器。如果你已经有通知器,你可以单击**添加收件人**按钮,将他们添加到通知中。
:::note