Skip to content

Commit

Permalink
Update Chinese docs
Browse files Browse the repository at this point in the history
  • Loading branch information
vickyhella committed Jun 7, 2023
1 parent 48c74c2 commit f896c08
Show file tree
Hide file tree
Showing 24 changed files with 755 additions and 359 deletions.
2 changes: 2 additions & 0 deletions docs/install/requirements.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,10 +22,12 @@ Harvester nodes have the following hardware requirements and recommendations for
| Network Switch | Trunking of ports required for VLAN support |

:::note

A three-node cluster is required to realize the multi-node features of Harvester fully.
- The first node always defaults to be a management node of the cluster.
- When there are three or more nodes, the two other nodes added first are automatically promoted to management nodes to form a high availability (HA) cluster.
- We recommend server-class hardware for the best results. Laptops and nested virtualization are not officially supported.

:::

## Network requirements
Expand Down
49 changes: 49 additions & 0 deletions i18n/zh/docusaurus-plugin-content-docs/current/host/host.md
Original file line number Diff line number Diff line change
Expand Up @@ -119,6 +119,55 @@ Admin 用户可以点击 **Enable Maintenance Mode** 来自动驱逐节点中所

:::

### 移除磁盘

移除磁盘前必须先清除磁盘上的 Longhorn 副本。

:::note

副本数据会自动重建到另一个磁盘来保持高可用性。

:::

#### 确定要移除的磁盘(Harvester 仪表板)
1. 前往 **Hosts** 页面。
2. 在包含磁盘的节点上,选择节点名称并转到 **Storage** 选项卡。
3. 找到要移除的磁盘。假设要移除的是 `/dev/sdb`,磁盘的挂载点是 `/var/lib/harvester/extra-disks/1b805b97eb5aa724e6be30cbdb373d04`

![Find disk to remove](/img/v1.2/host/remove-disks-harvester-find-disk.png)

#### 驱逐副本(Longhorn 仪表板)
1. 按照[此文档](../troubleshooting/harvester.md#访问嵌入式-rancher-和-longhorn-仪表板)启用嵌入式 Longhorn 仪表板。
2. 访问 Longhorn 仪表板并转到 **Node** 页面。
3. 展开包含磁盘的节点。确认挂载点 `/var/lib/harvester/extra-disks/1b805b97eb5aa724e6be30cbdb373d04` 在磁盘列表中。

![Check the removing disk](/img/v1.2/host/remove-disks-longhorn-nodes.png)

4. 选择 **Edit node and disks**

![Edit node and disks](/img/v1.2/host/remove-disks-longhorn-nodes-edit.png)

5. 滚动到要移除的磁盘。
-`Scheduling` 设置为 `Disable`
-`Eviction Requested` 设置为 `True`
选择 **Save**。不要选择删除图标。

![Evict disk](/img/v1.2/host/remove-disks-longhorn-nodes-evict-disk.png)

6. 磁盘将被禁用。等待磁盘副本数变为 `0` 后再继续移除磁盘。

![Wait replicas](/img/v1.2/host/remove-disks-longhorn-wait-replicas.png)

#### 移除磁盘(Harvester 仪表板)
1. 前往 **Hosts** 页面。
2. 在包含磁盘的节点上,选择 **⋮ > Edit Config**
3. 转到 **Storage** 选项卡并选择 **x** 来移除磁盘。

![Remove disk](/img/v1.2/host/remove-disks-harvester-remove.png)

4. 选择 **Save** 以移除磁盘。


## Ksmtuned 模式

_从 v1.1.0 起可用_
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -362,7 +362,7 @@ install:

#### 定义

为主机配置网络接口。每个键值对均代表一个网络接口。键的名称会成为网络名称,而值是每个网络的配置。有效的配置字段是:
为主机配置网络接口。有效的配置字段是:

- `method`:为该网络分配 IP 的方法。支持:
- `static`:手动分配 IP 和 网关。
Expand All @@ -377,7 +377,7 @@ install:
- `mode: balance-tlb`
- `miimon: 100`
- `mtu`:接口的 MTU。
- `vlan_id`:接口的 VLAN ID
- `vlan_id`:接口的 VLAN ID

:::note

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ Rancher `2.6.3+` 默认启用 Harvester 主机驱动。你可以前往 `Cluster
了解[如何创建 RKE2 Kubernetes 集群](./rke2-cluster.md)

## K3s Kubernetes 集群
点击了解[如何创建 K3s Kubernetes 集群](./k3s-cluster.md)
了解[如何创建 K3s Kubernetes 集群](./k3s-cluster.md)


## 拓扑分布约束
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ Harvester 是裸机服务器上的 HCI 解决方案,以下是 Harvester 安装
| 内存 | 32 GB(至少)。建议使用 64 GB 或以上的内存。 |
| 磁盘容量 | 140 GB(至少)用于测试,建议在生产中使用 500 GB 或以上的磁盘。 |
| 磁盘性能 | 每个磁盘 5,000+ 随机 IOPS (SSD/NVMe)。管理节点(前 3 个节点)必须[对 etcd 而言足够快](https://www.ibm.com/cloud/blog/using-fio-to-tell-whether-your-storage-is-fast-enough-for-etcd)|
| 网卡 | 1 Gbps 以太网(至少)用于测试,建议在生产中使用 10 Gbps 或以上的以太网 |
| 网卡 | 1 Gbps 以太网(至少)用于测试;生产中建议使用 10 Gbps 或以上的以太网 |
| 网络交换机 | VLAN 支持所需的端口中继。 |

建议使用服务器级硬件以获得最佳效果。笔记本电脑和嵌套虚拟化不受官方支持。
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,11 +28,11 @@ Harvester CSI Driver 提供了一个 CSI 接口,供 Harvester 中所创建的

- 选择外部云提供商的选项。

- [生成 addon 配置](https://github.com/harvester/harvester-csi-driver/blob/master/deploy/generate_addon.sh)并将它添加到 RKE 配置 YAML 中:
- [生成 addon 配置](https://github.com/harvester/harvester-csi-driver/blob/master/deploy/generate_addon_csi.sh)并将它添加到 RKE 配置 YAML 中:

```
# 依赖 kubectl 来操作 Harvester 集群
./deploy/generate_addon.sh <serviceaccount name> <namespace>
# depend on kubectl to operate the Harvester cluster
./deploy/generate_addon_csi.sh <serviceaccount name> <namespace>
```

### 使用 Harvester RKE2 主机驱动进行部署
Expand All @@ -41,15 +41,95 @@ Harvester CSI Driver 提供了一个 CSI 接口,供 Harvester 中所创建的

![select-harvester-cloud-provider](/img/v1.0/rancher/select-harvester-cloud-provider.png)

### 使用 Harvester K3s 主机驱动进行部署
#### 在 RKE2 集群中手动安装 CSI Driver

如果你想在不启用 Harvester 云提供商的情况下部署 Harvester CSI Driver,在 `Cloud Provider` 字段中选择 `Default - RKE2 Embedded``External`。如果你使用的是 Rancher v2.6,请选择 `None`

![](/img/v1.0/rancher/non-harvester-cloud-provider.png)

#### 前提

确保你满足以下前提条件:
- 系统上安装了 `kubectl``jq`
- 你拥有裸机 Harvester 集群的 `kubeconfig` 文件。
```
export KUBECONFIG=/path/to/your/harvester-kubeconfig
```

![](/img/v1.0/rancher/creating_guest_cluster.png)

执行以下步骤手动部署 Harvester CSI Driver:
#### 部署 Harvester CSI Driver

1. 生成 cloud-config。

- [生成 addon 配置](https://github.com/harvester/harvester-csi-driver/blob/master/deploy/generate_addon.sh)并放入 K3s 虚拟机 `/etc/kubernetes/cloud-config`
你可以使用 [generate_addon_csi.sh](https://raw.githubusercontent.com/harvester/harvester-csi-driver/master/deploy/generate_addon_csi.sh) 脚本生成 `kubeconfig` 文件。你可以在 [harvester/harvester-csi-driver](https://github.com/harvester/harvester-csi-driver) 仓库中找到该文件。按照以下步骤获取 `cloud-config``cloud-init` 数据:

`<serviceaccount name>` 通常对应来宾集群的名称(下图中 **Cluster Name** 的值),`<namespace>` 需要匹配来宾集群的命名空间(**Namespace** 的值)。

```
# ./generate_addon_csi.sh <serviceaccount name> <namespace> RKE2
```

```
# 依赖 kubectl 来操作 Harvester 集群
./deploy/generate_addon.sh <serviceaccount name> <namespace>
########## cloud-config ############
apiVersion: v1
clusters:
- cluster: <token>
server: https://<YOUR HOST HARVESTER VIP>:6443
name: default
contexts:
- context:
cluster: default
namespace: default
user: rke2-guest-01-default-default
name: rke2-guest-01-default-default
current-context: rke2-guest-01-default-default
kind: Config
preferences: {}
users:
- name: rke2-guest-01-default-default
user:
token: <token>
########## cloud-init user data ############
write_files:
- encoding: b64
content: YXBpVmVyc2lvbjogdjEKY2x1c3RlcnM6Ci0gY2x1c3RlcjoKICAgIGNlcnRpZmljYXRlLWF1dGhvcml0eS1kYXRhOiBMUzB0TFMxQ1JVZEpUaUJEUlZKVVNVWkpRMEZVUlMwdExTMHRDazFKU1VKbFZFTkRRVklyWjBGM1NVSkJaMGxDUVVSQlMwSm5aM0ZvYTJwUFVGRlJSRUZxUVd0TlUwbDNTVUZaUkZaUlVVUkVRbXg1WVRKVmVVeFlUbXdLWTI1YWJHTnBNV3BaVlVGNFRtcG5NVTE2VlhoT1JGRjNUVUkwV0VSVVNYcE5SRlY1VDFSQk5VMVVRVEJOUm05WVJGUk5lazFFVlhsT2FrRTFUVlJCTUFwTlJtOTNTa1JGYVUxRFFVZEJNVlZGUVhkM1dtTnRkR3hOYVRGNldsaEtNbHBZU1hSWk1rWkJUVlJaTkU1VVRURk5WRkV3VFVSQ1drMUNUVWRDZVhGSENsTk5ORGxCWjBWSFEwTnhSMU5OTkRsQmQwVklRVEJKUVVKSmQzRmFZMDVTVjBWU2FsQlVkalJsTUhFMk0ySmxTSEZEZDFWelducGtRa3BsU0VWbFpHTUtOVEJaUTNKTFNISklhbWdyTDJab2VXUklNME5ZVURNeFZXMWxTM1ZaVDBsVGRIVnZVbGx4YVdJMGFFZE5aekpxVVdwQ1FVMUJORWRCTVZWa1JIZEZRZ292ZDFGRlFYZEpRM0JFUVZCQ1owNVdTRkpOUWtGbU9FVkNWRUZFUVZGSUwwMUNNRWRCTVZWa1JHZFJWMEpDVWpaRGEzbEJOSEZqYldKSlVESlFWVW81Q2xacWJWVTNVV2R2WjJwQlMwSm5aM0ZvYTJwUFVGRlJSRUZuVGtsQlJFSkdRV2xCZUZKNU4xUTNRMVpEYVZWTVdFMDRZazVaVWtWek1HSnBZbWxVSzJzS1kwRnhlVmt5Tm5CaGMwcHpMM2RKYUVGTVNsQnFVVzVxZEcwMVptNTZWR3AxUVVsblRuTkdibFozWkZRMldXWXpieTg0ZFRsS05tMWhSR2RXQ2kwdExTMHRSVTVFSUVORlVsUkpSa2xEUVZSRkxTMHRMUzBLCiAgICBzZXJ2ZXI6IGh0dHBzOi8vMTkyLjE2OC4wLjEzMTo2NDQzCiAgbmFtZTogZGVmYXVsdApjb250ZXh0czoKLSBjb250ZXh0OgogICAgY2x1c3RlcjogZGVmYXVsdAogICAgbmFtZXNwYWNlOiBkZWZhdWx0CiAgICB1c2VyOiBya2UyLWd1ZXN0LTAxLWRlZmF1bHQtZGVmYXVsdAogIG5hbWU6IHJrZTItZ3Vlc3QtMDEtZGVmYXVsdC1kZWZhdWx0CmN1cnJlbnQtY29udGV4dDogcmtlMi1ndWVzdC0wMS1kZWZhdWx0LWRlZmF1bHQKa2luZDogQ29uZmlnCnByZWZlcmVuY2VzOiB7fQp1c2VyczoKLSBuYW1lOiBya2UyLWd1ZXN0LTAxLWRlZmF1bHQtZGVmYXVsdAogIHVzZXI6CiAgICB0b2tlbjogZXlKaGJHY2lPaUpTVXpJMU5pSXNJbXRwWkNJNklreGhUazQxUTBsMWFsTnRORE5TVFZKS00waE9UbGszTkV0amNVeEtjM1JSV1RoYVpUbGZVazA0YW1zaWZRLmV5SnBjM01pT2lKcmRXSmxjbTVsZEdWekwzTmxjblpwWTJWaFkyTnZkVzUwSWl3aWEzVmlaWEp1WlhSbGN5NXBieTl6WlhKMmFXTmxZV05qYjNWdWRDOXVZVzFsYzNCaFkyVWlPaUprWldaaGRXeDBJaXdpYTNWaVpYSnVaWFJsY3k1cGJ5OXpaWEoyYVdObFlXTmpiM1Z1ZEM5elpXTnlaWFF1Ym1GdFpTSTZJbkpyWlRJdFozVmxjM1F0TURFdGRHOXJaVzRpTENKcmRXSmxjbTVsZEdWekxtbHZMM05sY25acFkyVmhZMk52ZFc1MEwzTmxjblpwWTJVdFlXTmpiM1Z1ZEM1dVlXMWxJam9pY210bE1pMW5kV1Z6ZEMwd01TSXNJbXQxWW1WeWJtVjBaWE11YVc4dmMyVnlkbWxqWldGalkyOTFiblF2YzJWeWRtbGpaUzFoWTJOdmRXNTBMblZwWkNJNkltTXlZak5sTldGaExUWTBNMlF0TkRkbU1pMDROemt3TFRjeU5qWXpNbVl4Wm1aaU5pSXNJbk4xWWlJNkluTjVjM1JsYlRwelpYSjJhV05sWVdOamIzVnVkRHBrWldaaGRXeDBPbkpyWlRJdFozVmxjM1F0TURFaWZRLmFRZmU1d19ERFRsSWJMYnUzWUVFY3hmR29INGY1VnhVdmpaajJDaWlhcXB6VWI0dUYwLUR0cnRsa3JUM19ZemdXbENRVVVUNzNja1BuQmdTZ2FWNDhhdmlfSjJvdUFVZC04djN5d3M0eXpjLVFsTVV0MV9ScGJkUURzXzd6SDVYeUVIREJ1dVNkaTVrRWMweHk0X0tDQ2IwRHQ0OGFoSVhnNlMwRDdJUzFfVkR3MmdEa24wcDVXUnFFd0xmSjdEbHJDOFEzRkNUdGhpUkVHZkUzcmJGYUdOMjdfamR2cUo4WXlJQVd4RHAtVHVNT1pKZUNObXRtUzVvQXpIN3hOZlhRTlZ2ZU05X29tX3FaVnhuTzFEanllbWdvNG9OSEpzekp1VWliRGxxTVZiMS1oQUxYSjZXR1Z2RURxSTlna1JlSWtkX3JqS2tyY3lYaGhaN3lTZ3o3QQo=
owner: root:root
path: /var/lib/rancher/rke2/etc/config-files/cloud-provider-config
permissions: '0644'
```

- 从 Rancher 应用市场安装 `Harvester CSI Driver`
`cloud-init user data` 下的输出复制并粘贴到 **Machine Pools >Show Advanced > User Data**

2. 设置 cloud-provider-config。

应用上述 cloud-init 用户数据后,你需要创建 cloud-provider-config。

你可以再次检查路径 `/var/lib/rancher/rke2/etc/config-files/cloud-provider-config`

![](/img/v1.0/rancher/install-harvester-csi-driver-in-k3s.png)
:::note

要更改 cloud-provider-config 路径,你需要更新 cloud-init 用户数据。

:::

3. 安装 Harvester CSI Driver。

从 Rancher 应用市场安装 `Harvester CSI Driver` chart(请注意,默认情况下不需要更改 `cloud-config` 路径)。
![](/img/v1.0/rancher/install_csi_rancher_marketplace.png)

![](/img/v1.0/rancher/donot_change_cloud_config_path.png)

执行上述步骤后,你应该能够看些 CSI Driver pod 已启动并运行,要进行验证,你可以使用默认 storageClass `harvester` 来配置新的 PVC。

### 使用 Harvester K3s 主机驱动进行部署

你可以按照**前提**中 RKE2 部分描述的[部署 Harvester CSI Driver](./csi-driver.md#部署-harvester-csi-driver) 步骤进行操作。

唯一的区别是你需要如下更改脚本命令:

```
# ./generate_addon_csi.sh <serviceaccount name> <namespace> k3s
```
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ Rancher `2.6.3+` 默认启用 Harvester 主机驱动。你可以前往 `Cluster
了解[如何创建 RKE2 Kubernetes 集群](./rke2-cluster.md)

## K3s Kubernetes 集群
点击了解[如何创建 K3s Kubernetes 集群](./k3s-cluster.md)
了解[如何创建 K3s Kubernetes 集群](./k3s-cluster.md)


## 拓扑分布约束
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -49,6 +49,6 @@ Description: 在 Harvester VM 页面编辑虚拟机。

### 访问凭证

如果你的 Guest 操作系统安装了 QUEMU GuestAgent,访问凭证将允许你在运行时动态注入基本认证或 SSH 密钥。
如果你的 Guest 操作系统安装了 QEMU GuestAgent,访问凭证将允许你在运行时动态注入基本认证或 SSH 密钥。

有关更多详细信息,请查看参阅[通过 QEMU Guest Agent 进行动态 SSH 密钥注入](./access-to-the-vm.md#通过-qemu-guest-agent-进行动态-ssh-密钥注入)
Original file line number Diff line number Diff line change
Expand Up @@ -152,7 +152,7 @@ https://172.16.0.1/v3/import/w6tp7dgwjj549l88pr7xmxb4x6m54v5kcplvhbp9vv2wzqrrjhr
:::note

Harvester 在用户配置的 `no-proxy` 后附加必要的地址,来确保内部流量能正常工作。
例如:`localhost,127.0.0.1,0.0.0.0,10.0.0.0/8,longhorn-system,cattle-system,cattle-system.svc,.svc,.cluster.local`
例如:`localhost,127.0.0.1,0.0.0.0,10.0.0.0/8,longhorn-system,cattle-system,cattle-system.svc,harvester-system,.svc,.cluster.local`。v1.1.2 开始将 `harvester-system` 添加到列表。

:::

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ Harvester ISO 镜像包括实现在离线环境中运行的所有包。
:::note

Harvester 在用户配置的 `no-proxy` 后附加必要的地址,来确保内部流量能正常工作。
例如:`localhost,127.0.0.1,0.0.0.0,10.0.0.0/8,longhorn-system,cattle-system,cattle-system.svc,.svc,.cluster.local`
例如:`localhost,127.0.0.1,0.0.0.0,10.0.0.0/8,longhorn-system,cattle-system,cattle-system.svc,harvester-system,.svc,.cluster.local`。v1.1.2 开始将 `harvester-system` 添加到列表。

如果集群中的节点之间不使用代理进行通信,你需要在第一个节点安装成功后将 CIDR 添加到 `http-proxy.noProxy`。请参阅[部署多节点集群失败](./troubleshooting/harvester.md#http-proxy-设置错误导致多节点集群部署失败)

Expand Down
49 changes: 49 additions & 0 deletions i18n/zh/docusaurus-plugin-content-docs/version-v1.1/host/host.md
Original file line number Diff line number Diff line change
Expand Up @@ -119,6 +119,55 @@ Admin 用户可以点击 **Enable Maintenance Mode** 来自动驱逐节点中所

:::

### 移除磁盘

移除磁盘前必须先清除磁盘上的 Longhorn 副本。

:::note

副本数据会自动重建到另一个磁盘来保持高可用性。

:::

#### 确定要移除的磁盘(Harvester 仪表板)
1. 前往 **Hosts** 页面。
2. 在包含磁盘的节点上,选择节点名称并转到 **Storage** 选项卡。
3. 找到要移除的磁盘。假设要移除的是 `/dev/sdb`,磁盘的挂载点是 `/var/lib/harvester/extra-disks/1b805b97eb5aa724e6be30cbdb373d04`

![Find disk to remove](/img/v1.1/host/remove-disks-harvester-find-disk.png)

#### 驱逐副本(Longhorn 仪表板)
1. 按照[此文档](../troubleshooting/harvester.md#访问嵌入式-rancher-和-longhorn-仪表板)启用嵌入式 Longhorn 仪表板。
2. 访问 Longhorn 仪表板并转到 **Node** 页面。
3. 展开包含磁盘的节点。确认挂载点 `/var/lib/harvester/extra-disks/1b805b97eb5aa724e6be30cbdb373d04` 在磁盘列表中。

![Check the removing disk](/img/v1.1/host/remove-disks-longhorn-nodes.png)

4. 选择 **Edit node and disks**

![Edit node and disks](/img/v1.1/host/remove-disks-longhorn-nodes-edit.png)

5. 滚动到要移除的磁盘。
-`Scheduling` 设置为 `Disable`
-`Eviction Requested` 设置为 `True`
选择 **Save**。不要选择删除图标。

![Evict disk](/img/v1.1/host/remove-disks-longhorn-nodes-evict-disk.png)

6. 磁盘将被禁用。等待磁盘副本数变为 `0` 后再继续移除磁盘。

![Wait replicas](/img/v1.1/host/remove-disks-longhorn-wait-replicas.png)

#### 移除磁盘(Harvester 仪表板)
1. 前往 **Hosts** 页面。
2. 在包含磁盘的节点上,选择 **⋮ > Edit Config**
3. 转到 **Storage** 选项卡并选择 **x** 来移除磁盘。

![Remove disk](/img/v1.1/host/remove-disks-harvester-remove.png)

4. 选择 **Save** 以移除磁盘。


## Ksmtuned 模式

_从 v1.1.0 起可用_
Expand Down
Loading

0 comments on commit f896c08

Please sign in to comment.