Update Chinese docs

2026-09-25 20:48:11 +00:00 · 2023-09-08 16:35:58 +08:00
parent 039fa9c1db
commit 3b43125dba
63 changed files with 9643 additions and 99 deletions
@@ -2,7 +2,7 @@
 title: 参与 Rancher 社区贡献
 ---

-本节介绍 Rancher 使用的仓库、如何构建仓库以及提交 issue 时要包含的信息。
+本文介绍了 Rancher 仓库和 Rancher 文档、如何构建 Rancher 仓库以及提交 issue 时要包含哪些信息。

 有关如何为 Rancher 项目开发做出贡献的更多详细信息，请参阅 [Rancher Developer Wiki](https://github.com/rancher/rancher/wiki)。Wiki 包含以下主题的资源：

@@ -14,7 +14,15 @@ title: 参与 Rancher 社区贡献

 在 Rancher Users Slack 上，开发者的频道是 **#developer**。

-## 仓库
+## Rancher 文档
+
+如果你对此网站上的文档有建议，请在主 [Rancher 文档](https://github.com/rancher/rancher-docs)仓库中[提交 issue](https://github.com/rancher/rancher-docs/issues/new/choose)。此仓库包含 Rancher v2.0 及更高版本的文档。
+
+有关贡献和构建 Rancher v2.x 文档仓库的更多详细信息，请参阅 [Rancher 文档 README](https://github.com/rancher/rancher-docs#readme)。
+
+有关 Rancher v1.6 及更早版本的文档，请参阅 [Rancher 1.x docs](https://github.com/rancher/rancher.github.io) 仓库，其中包含 https://rancher.com/docs/rancher/v1.6/en/ 的源文件。
+
+## Rancher 仓库

 所有仓库都位于我们的主要 GitHub 组织内。Rancher 使用了很多仓库，以下是部分主要仓库的描述：

@@ -38,19 +46,19 @@ title: 参与 Rancher 社区贡献
 ![Rancher diagram](/img/ranchercomponentsdiagram-2.6.svg)<br/>
 <sup>用于配置/管理 Kubernetes 集群的 Rancher 组件。</sup>

-## 构建
+### 构建 Rancher 仓库

 每个仓库都应该有一个 Makefile，并且可以使用 `make` 命令进行构建。`make` 目标基于仓库中 `/scripts` 目录中的脚本，每个目标都使用 [Dapper](https://github.com/rancher/dapper) 在孤立的环境中运行。`Dockerfile.dapper` 将用于此操作，它包含了所需的所有构建工具。

 默认目标是 `ci`，它将运行 `./scripts/validate`、`./scripts/build`、`./scripts/test ` 和 `./scripts/package`。生成的二进制文件将在 `./build/bin` 中，通常也打包在 Docker 镜像中。

-## Bug、Issue 和疑问
+### Rancher Bug、Issue 或疑问

 如果你发现任何 bug 或问题，由于有人可能遇到过同样的问题，或者我们已经正在寻找解决方案，因此请先在[已报告 issue](https://github.com/rancher/rancher/issues) 中搜索。

 如果找不到与你的问题相关的内容，请通过[提出 issue](https://github.com/rancher/rancher/issues/new) 与我们联系。与 Rancher 相关的仓库有很多，但请将 issue 提交到 Rancher 仓库中，这样能确保我们能看到这些 issue。如果你想就一个用例提出问题或询问其他用户，你可以在 [Rancher 论坛](https://forums.rancher.com)上发帖。

-### 提交 Issue 的检查清单
+#### 提交 Issue 的检查清单

 提交问题时请遵循此清单，以便我们调查和解决问题。如果你能提供更多信息，我们就可以使用更多数据来确定导致问题的原因或发现更多相关的内容。

@@ -126,11 +134,3 @@ title: 参与 Rancher 社区贡献
   - Docker Daemon 日志记录（可能并不全部存在，取决于操作系统）
      - `/var/log/docker.log`
 - **指标**：如果你遇到性能问题，请提供尽可能多的指标数据（文件或屏幕截图）来帮助我们确定问题。如果你遇到主机相关的问题，你可以提供 `top`、`free -m`、`df` 的输出，这些输出会显示进程/内存/磁盘的使用情况。
-
-## 文档
-
-如果你对我们的文档有修改意见，请在我们的文档仓库中提交 PR。
-
- [Rancher 2.x 文档仓库](https://github.com/rancher/docs)：Rancher 2.x 所有文档都在这个仓库中。具体位于仓库的 `content` 文件夹中。
-
- [Rancher 1.x 文档仓库](https://github.com/rancher/rancher.github.io)：Rancher 1.x 所有文档都在这个仓库中。具体位于仓库的 `rancher` 文件夹中。
@@ -12,6 +12,6 @@ title: 安装 Rancher CIS Benchmark

 :::note

-CIS Benchmark 4.0.0 及更高版本默认禁用 PSP。要在加固集群上安装 CIS Benchmark，在安装 Chart 之前将 values 中的 `global.psp.enabled` 设置为 `true`。
+如果你使用 Kubernetes v1.24 或更早版本，并且具有使用 [Pod 安全策略](../../new-user-guides/authentication-permissions-and-global-configuration/create-pod-security-policies.md) (PSP) 加固的集群，则 CIS Benchmark 4.0.0 及更高版本会默认禁用 PSP。要在 PSP 加固集群上安装 CIS Benchmark，请在安装 Chart 之前将 values 中的 `global.psp.enabled` 设置为 `true`。[Pod 安全准入](../../new-user-guides/authentication-permissions-and-global-configuration/pod-security-standards.md) (PSA) 加固集群不受影响。

 :::
@@ -4,7 +4,7 @@ title: 配置树外 vSphere 云提供商

 Kubernetes 正在逐渐不在树内维护云提供商。vSphere 有一个树外云提供商，可通过安装 vSphere 云提供商和云存储插件来使用。

-本页介绍如何在启动集群后安装 Cloud Provider Interface (CPI) 和 Cloud Storage Interface (CSI) 插件。
+本文介绍了如何在设置集群后安装 Cloud Provider Interface (CPI) 和 Cloud Storage Interface (CSI) 插件。

 ## 先决条件

@@ -1,6 +1,7 @@
 ---
-title: 将 vSphere 树内卷迁移到 CSI
+title: 将 vSphere 树内卷迁移到树外
 ---
+
 Kubernetes 正在逐渐不在树内维护云提供商。vSphere 有一个树外云提供商，可通过安装 vSphere 云提供商和云存储插件来使用。

 本页介绍如何从树内 vSphere 云提供商迁移到树外，以及如何在迁移后管理现有虚拟机。
@@ -2,6 +2,7 @@
 title: Kubernetes 镜像仓库和容器镜像仓库
 description: 了解容器镜像仓库和 Kubernetes 镜像仓库、它们的用例以及如何在 Rancher UI 中使用私有镜像仓库
 ---
+
 镜像仓库是 Kubernetes 密文（Secret），包含用于向[私有容器镜像仓库](https://kubernetes.io/docs/tasks/configure-pod-container/pull-image-private-registry/)进行身份验证的凭证。

 “Registry” 这个词可能有两种意思，可指代容器或 Kubernetes 镜像仓库：
@@ -7,7 +7,8 @@ description: Ingress 配置

 在 Kubernetes v1.21 及更高版本中，NGINX Ingress Controller 不再默认运行在 hostNetwork 中。它改为将 hostPorts 用于端口 80 和端口 443，因此你可以将准入 Webhook 配置为只能通过 ClusterIP 访问。这确保了只能从集群内部访问 webhook。

-由于 controller 的这一更改，默认不再将 `hostNetwork` 设置为 `true`。但是，你必须将 `hostNetwork` 设置为 `true` 才能使基于 TCP 和 UDP 的 Service 正常工作。
+由于 controller 的这一更改，默认 RKE1 配置不再将 `hostNetwork` 设置为 `true`。但是，你必须将 `hostNetwork` 设置为 `true` 才能使基于 TCP 和 UDP 的 Service 正常工作。为此，请[编辑](../../../../reference-guides/cluster-configuration/rancher-server-configuration/rke1-cluster-configuration.md#使用-yaml-编辑集群)集群的 YAML 并按照[官方 RKE1 文档](https://rke.docs.rancher.com/config-options/add-ons/ingress-controllers#configuring-network-options)中的步骤操作。
+

 :::

@@ -2,6 +2,7 @@
 title: "四层和七层负载均衡"
 description: "Kubernetes 支持四层负载均衡和七层负载均衡。了解对不同 deployment 的支持"
 ---
+
 Kubernetes 支持四层负载均衡和七层负载均衡。

 ## 四层负载均衡器
@@ -2,6 +2,7 @@
 title: "Kubernetes 持久存储：卷和存储类"
 description: "了解在 Kubernetes 中创建持久存储的两种方式：持久卷和存储类"
 ---
+
 在部署需要保留数据的应用时，你需要创建持久存储。持久存储允许你在运行应用的 pod 之外存储应用数据。即使运行应用的 pod 发生故障，这种存储方式也能让你保留应用数据。

 本文假设你已了解 Kubernetes 的持久卷、持久卷声明和存储类的概念。如需更多信息，请参阅[存储的工作原理](../how-to-guides/new-user-guides/manage-clusters/create-kubernetes-persistent-storage/manage-persistent-storage/about-persistent-storage.md)。
@@ -1,6 +1,7 @@
 ---
 title: 跨集群部署应用
 ---
+
 ### Fleet

 Rancher 2.5 引入了 Fleet，这是一种跨集群部署应用的新方式。
@@ -1,6 +1,7 @@
 ---
 title: 启用实验功能
 ---
+
 Rancher 包含一些默认关闭的实验功能。在某些情况下，例如当你认为使用[不支持的存储类型](../how-to-guides/advanced-user-guides/enable-experimental-features/unsupported-storage-drivers.md)的好处大于使用未经测试的功能的风险时，你可能想要启用实验功能。为了让你能够试用这些默认关闭的功能，我们引入了功能开关（feature flag）。

 实验功能可以通过以下三种方式启用：
@@ -1,6 +1,7 @@
 ---
 title: Rancher 部署快速入门指南
 ---
+
 :::caution

 本章节中提供的指南，旨在帮助你快速启动一个用于 Rancher 的沙盒，以评估 Rancher 是否能满足你的使用需求。快速入门指南不适用于生产环境。如果你需要获取生产环境的操作指导，请参见[安装](installation-and-upgrade.md)。
@@ -22,9 +22,8 @@ title: 安全
 安全是 Rancher 全部功能的基础。Rancher 集成了全部主流身份验证工具和服务，并提供了企业级的 [RBAC 功能](manage-role-based-access-control-rbac.md)，让你的 Kubernetes 集群更加安全。

 本文介绍了安全相关的文档以及资源，让你的 Rancher 安装和下游 Kubernetes 集群更加安全。
-### NeuVector 与 Rancher 的集成

-_2.6.5 的新功能_
+### NeuVector 与 Rancher 的集成

 NeuVector 是一个开源的、以容器为中心的安全应用程序，现已集成到 Rancher 中。NeuVector 提供生产安全、DevOps 漏洞保护和容器防火墙等功能。请参阅 [Rancher 文档](../integrations-in-rancher/neuvector.md)和 [NeuVector 文档](https://open-docs.neuvector.com/)了解更多信息。

@@ -2,6 +2,7 @@
 title: 创建 vSphere 集群
 description: 使用 Rancher 创建 vSphere 集群。集群可能包括具有不同属性的 VM 组，这些属性可用于细粒度控制节点的大小。
 ---
+
 import YouTube from '@site/src/components/YouTube'

 你可以结合使用 Rancher 与 vSphere，从而在本地体验云环境的操作。
@@ -10,7 +10,7 @@ Rancher CLI（命令行界面）是一个命令行工具，可用于与 Rancher
 你可以直接 UI 下载二进制文件。

 1. 点击左上角的 **☰**。
-1. 单击底部的 **v2.6.x**，**v2.6.x** 是一个超链接文本，表示已安装的 Rancher 版本。
+1. 在导航侧边栏菜单底部，单击**简介**。
 1. 在 **CLI 下载**中，有 Windows、Mac 和 Linux 的二进制文件下载链接。你还可以访问我们的 CLI [发布页面](https://github.com/rancher/cli/releases)直接下载二进制文件。

 ### 要求
@@ -13,7 +13,7 @@ title: vSphere 节点模板配置
 | 凭证字段 | 描述 |
 |-----------------|--------------|
 | vCenter 或 ESXi Server | 输入 vCenter 或 ESXi 主机名/IP。ESXi 是你创建和运行虚拟机和虚拟设备的虚拟化平台。你可以通过 vCenter Server 服务来管理网络中连接的多个主机并池化主机资源。 |
-| 端口 | 可选：配置 vCenter 或 ESXi Server 的端口。 |
+| 端口 | 配置 vCenter 或 ESXi Server 的端口。 |
 | 用户名和密码 | 你的 vSphere 登录用户名和密码。 |

 ## 调度
@@ -92,4 +92,4 @@ title: vSphere 节点模板配置
 如果要配置 Red Hat Enterprise Linux (RHEL) 或 CentOS 节点，请将 **Docker Install URL** 字段保留为默认值，或选择 **none**。由于 Docker 已经安装在这些节点上，因此将绕过 Docker 安装检查。

 如果没有将 **Docker Install URL** 设置为默认值或 **none**，你可能会看到错误消息：`Error creating machine: RHEL ssh command error: command: sudo -E yum install -y curl err: exit status 1 output: Updating Subscription Management repositories`。
-:::
+:::