Skip to content

Commit

Permalink
Update v2.6/v2.7 translation and fix v2.4-related broken links (ranch…
Browse files Browse the repository at this point in the history
…er#531)

* Update v2.7 translation

* Update v2.6 translation

* Fix broken links
  • Loading branch information
vickyhella authored Apr 11, 2023
1 parent a5e3b54 commit 1b5278c
Show file tree
Hide file tree
Showing 13 changed files with 66 additions and 52 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -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)

:::
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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。
Expand All @@ -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">

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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 会从你的私有镜像仓库中拉取系统镜像。

### 带 RKE2 下游集群的命名空间私有镜像仓库

**结果**:Rancher 将使用你的私有镜像仓库拉取系统镜像
默认情况下,大多数私有镜像仓库应该能与 RKE2 下游集群一起工作

## 部署集群时设置需要凭证的私有镜像仓库
但是,如果你尝试设置 URL 格式为 `website/subdomain:portnumber` 的命名空间私有镜像仓库,则需要执行额外的步骤:

创建集群时,你可以按照以下步骤配置私有镜像仓库:
1. 选择 **☰ > 集群管理**
1. 在列表中找到 RKE2 集群,然后点击 **⋮ > 编辑配置**
1.**集群配置**菜单中,选择**镜像仓库**
1.**镜像仓库**中,选择**配置高级 Containerd Mirror 和仓库认证选项**选项。
1.**Mirrors** 下的文本字段中,输入**镜像仓库主机名****Mirror 端点**
1. 单击**保存**
1. 根据需要对每个下游 RKE2 集群重复操作。

1. 点击 **☰ > 集群管理**
## 创建集群时配置使用凭证的私有镜像仓库

无法为每个 Rancher 配置的集群全局设置具有授权认证的私有镜像仓库。因此,如果你希望 Rancher 配置的集群从使用凭证的私有镜像仓库中拉取镜像,则每次创建新集群时都必须通过高级集群选项传递镜像仓库凭证。

由于创建集群后无法配置私有镜像仓库,因此你需要在初始集群设置期间执行这些步骤。

1. 选择 **☰ > 集群管理**
1.**集群**页面上,单击**创建**
1. 选择集群类型。
1.**集群配置**中,转到**镜像仓库**选项卡,然后单击**为 Rancher 从私有镜像仓库中拉取镜像**
1.**集群配置**中,转到**镜像仓库**选项卡,然后选择**为 Rancher 从私有镜像仓库中拉取镜像**
1. 输入镜像仓库主机名和凭证。
1. 单击**创建**

**结果**:新集群将能够从私有镜像仓库中拉取镜像。

集群创建后无法配置私有镜像仓库。
**结果**:新集群将从私有镜像仓库中拉取镜像。
Original file line number Diff line number Diff line change
Expand Up @@ -17,23 +17,19 @@ Rancher 管理注册集群的范围取决于集群的类型。详情请参见[

### 权限

如果你现有的 Kubernetes 集群已经定义了 `cluster-admin` 角色,则你必须具有此 `cluster-admin` 权限才能在 Rancher 中注册集群。

为了应用权限,你需要先运行:
要在 Rancher 中注册集群,你必须在该集群中拥有 `cluster-admin` 权限。如果没有,请运行以下命令将权限授予用户:

```plain
kubectl create clusterrolebinding cluster-admin-binding \
--clusterrole cluster-admin \
--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 集群

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

## 注册集群

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

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

如果你注册了 Amazon EKS、Azure AKS 或 GKE 集群,Rancher 将视其为在 Rancher 中创建的集群。

你现在可以将 Amazon EKS、Azure AKS 和 GKE 集群注册到 Rancher。在大多数情况下,注册的集群和在 Rancher UI 中创建的集群的处理方式相同(除了删除)。
Rancher 处理注册的 EKS、AKS 或 GKE 集群的方式与处理在 Rancher 中创建的集群的方式类似。但是,如果你通过 Rancher UI 删除已注册的集群,Rancher 不会销毁这些集群。

删除在 Rancher 中创建的 EKS、AKS 或 GKE 集群后,该集群将被销毁。删除在 Rancher 中注册集群时,它与 Rancher Server 会断开连接,但它仍然存在。你仍然可以像在 Rancher 中注册之前一样访问它
如果你在 Rancher 中创建 EKS、AKS 或 GKE 集群,然后将其删除,Rancher 会销毁该集群。通过 Rancher 删除已注册的集群时,Rancher Server 会_断开_与集群的连接。该集群仍然存在,只是它不再在 Rancher 中。你仍然可以像注册前一样访问已注销的集群

[此页面](../../../pages-for-subheaders/kubernetes-clusters-in-rancher-setup.md)上的表格中列出了已注册集群的功能
有关可用于管理已注册集群的功能,请参阅[按集群类型划分的集群管理功能](../../../pages-for-subheaders/kubernetes-clusters-in-rancher-setup.md)

## 配置 RKE2 和 K3s 集群升级

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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)

:::

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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)

Expand All @@ -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 的情况。
Original file line number Diff line number Diff line change
Expand Up @@ -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 升级的旧升级指南。

### 离线安装:推送镜像到私有镜像仓库

Expand Down Expand Up @@ -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)

:::

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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)

:::

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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 版本。
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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)

:::
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ title: 配置全局默认私有镜像仓库

有关在安装 Rancher 期间使用命令行选项设置私有镜像仓库的说明,请参见[离线安装指南](../../../pages-for-subheaders/air-gapped-helm-cli-install.md)

如果你的私有镜像仓库需要凭证,则它不能用作默认镜像仓库。没有全局的方法来为每个 Rancher 所配置的集群设置具有授权认证的私有镜像仓库。因此,如果你希望 Rancher 配置的集群使用凭证从私有镜像仓库中拉取镜像,则每次创建新集群时都必须[通过高级集群选项传递镜像仓库凭证](#部署集群时设置需要凭证的私有镜像仓库)
如果你的私有镜像仓库需要凭证,则它不能用作默认镜像仓库。无法为每个 Rancher 配置的集群全局设置具有授权认证的私有镜像仓库。因此,如果你希望 Rancher 配置的集群使用凭证从私有镜像仓库中拉取镜像,则每次创建新集群时都必须[通过高级集群选项传递镜像仓库凭证](#部署集群时设置需要凭证的私有镜像仓库)

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

Expand Down
Loading

0 comments on commit 1b5278c

Please sign in to comment.