Skip to content

Commit 842b8fd

Browse files
add: harvester zh-tw version 1215 (unfinished)
1 parent de1a887 commit 842b8fd

31 files changed

Lines changed: 1868 additions & 1876 deletions

‎i18n/zh-TW/docusaurus-plugin-content-docs/current/harvester/troubleshooting/harvester.md‎

Lines changed: 120 additions & 125 deletions
Large diffs are not rendered by default.

‎i18n/zh-TW/docusaurus-plugin-content-docs/current/harvester/troubleshooting/installation.md‎

Lines changed: 49 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -9,60 +9,60 @@ title: "Installation"
99
<link rel="canonical" href="https://docs.harvesterhci.io/v1.6/troubleshooting/index"/>
1010
</head>
1111

12-
The following sections contain tips to troubleshoot or get assistance with failed installations.
12+
以下章節包含對安裝失敗進行故障排除或取得協助的提示。
1313

14-
## Logging into the Harvester Installer (a live OS)
14+
## 登入 Harvester 安裝程式(即時作業系統)
1515

16-
Users can press the key combination `CTRL + ALT + F2` to switch to another TTY and log in with the following credentials:
16+
使用者可以按下組合鍵 `CTRL + ALT + F2` 切換到另一個 TTY,並使用以下憑證登入:
1717

18-
- User: `rancher`
19-
- Password: `rancher`
18+
- 使用者:`rancher`
19+
- 密碼:`rancher`
2020

21-
## Meeting hardware requirements
21+
## 滿足硬體需求
2222

23-
- Check that your hardware meets the [minimum requirements](../install/requirements.md#hardware-requirements) to complete installation.
23+
- 檢查您的硬體是否滿足[最低需求](../install/requirements.md#hardware-requirements)以完成安裝。
2424

25-
## Stuck in `Loading images. This may take a few minutes...`
25+
## 卡在 `Loading images. This may take a few minutes...`
2626

27-
Because the system doesn't have a default route, your installer may become "stuck" in this state. You can check your route status by executing the following command:
27+
由於系統沒有預設路由,您的安裝程式可能會「卡在」這個狀態。您可以透過執行以下命令來檢查路由狀態:
2828

2929
```shell
3030
$ ip route
31-
default via 10.10.0.10 dev mgmt-br proto dhcp <-- Does a default route exist?
31+
default via 10.10.0.10 dev mgmt-br proto dhcp <-- 是否存在預設路由?
3232
10.10.0.0/24 dev mgmt-br proto kernel scope link src 10.10.0.15
3333
```
3434

35-
Check that your DHCP server offers a default route option. Attaching content from `/run/cos/target/rke2.log` is helpful too.
35+
檢查您的 DHCP 伺服器是否提供預設路由選項。附加 `/run/cos/target/rke2.log` 的內容也會有所幫助。
3636

37-
For more information, see [DHCP Server Configuration](../install/pxe-boot-install.md#dhcp-server-configuration).
37+
如需更多資訊,請參閱 [DHCP Server Configuration](../install/pxe-boot-install.md#dhcp-server-configuration)。
3838

39-
## Modifying cluster token on agent nodes
39+
## 修改代理節點上的叢集權杖
4040

41-
When an agent node fails to join the cluster, it can be related to the cluster token not being identical to the server node token.
42-
In order to confirm the issue, connect to your agent node (i.e. with [SSH](./os.md#how-to-log-in-to-a-harvester-node) and check the `rancherd` service log with the following command:
41+
當代理節點無法加入叢集時,可能與叢集權杖與伺服器節點權杖不一致有關。
42+
為了確認問題,請連接到您的代理節點(例如使用 [SSH](./os.md#how-to-log-in-to-a-harvester-node))並使用以下命令檢查 `rancherd` 服務日誌:
4343

4444
```shell
4545
$ sudo journalctl -b -u rancherd
4646
```
4747

48-
If the cluster token setup in the agent node is not matching the server node token, you will find several entries of the following message:
48+
如果代理節點中設定的叢集權杖與伺服器節點權杖不符,您將發現多條以下訊息:
4949

5050
```shell
5151
msg="Bootstrapping Rancher (v2.7.5/v1.25.9+rke2r1)"
5252
msg="failed to bootstrap system, will retry: generating plan: response 502: 502 Bad Gateway getting cacerts: <html>\r\n<head><title>502 Bad Gateway</title></head>\r\n<body>\r\n<center><h1>502 Bad Gateway</h1></center>\r\n<hr><center>nginx</center>\r\n</body>\r\n</html>\r\n"
5353
```
5454

55-
Note that the Rancher version and IP address depend on your environment and might differ from the message above.
55+
請注意,Rancher 版本和 IP 位址取決於您的環境,可能與上述訊息不同。
5656

57-
To fix the issue, you need to update the token value in the `rancherd` configuration file `/etc/rancher/rancherd/config.yaml`.
57+
要修復此問題,您需要更新 `rancherd` 配置檔案 `/etc/rancher/rancherd/config.yaml` 中的權杖值。
5858

59-
For example, if the cluster token setup in the server node is `ThisIsTheCorrectOne`, you will update the token value as follow:
59+
例如,如果伺服器節點中設定的叢集權杖是 `ThisIsTheCorrectOne`,您將按如下方式更新權杖值:
6060

6161
```yaml
6262
token: 'ThisIsTheCorrectOne'
6363
```
6464
65-
To ensure the change is persistent across reboots, update the `token` value of the OS configuration file `/oem/90_custom.yaml`:
65+
為確保變更在重新啟動後持久化,請更新作業系統配置檔案 `/oem/90_custom.yaml` 的 `token` 值:
6666

6767
```yaml
6868
name: Harvester Configuration
@@ -96,23 +96,21 @@ stages:
9696

9797
:::note
9898

99-
To see what is the current cluster token value, log in your server node (i.e. with SSH)
100-
and look in the file `/etc/rancher/rancherd/config.yaml`. For example,
101-
you can run the following command to only display the token's value:
99+
要查看當前叢集權杖值,請登入您的伺服器節點(例如使用 SSH)並查看檔案 `/etc/rancher/rancherd/config.yaml`。例如,您可以執行以下命令僅顯示權杖的值:
102100

103101
```bash
104102
$ sudo yq eval .token /etc/rancher/rancherd/config.yaml
105103
```
106104

107105
:::
108106

109-
## Check the status of Harvester components
107+
## 檢查 Harvester 元件的狀態
110108

111-
Before checking the status of Harvester components, obtain a copy of the Harvester cluster's kubeconfig file following the [guide](../faq.md#how-can-i-access-the-kubeconfig-file-of-the-harvester-cluster).
109+
在檢查 Harvester 元件的狀態之前,請按照[指南](../faq.md#how-can-i-access-the-kubeconfig-file-of-the-harvester-cluster)取得 Harvester 叢集的 kubeconfig 檔案副本。
112110

113-
After you obtain a copy of the kubeconfig file, run the following script against the cluster to check the readiness of each component.
111+
取得 kubeconfig 檔案副本後,針對叢集執行以下腳本以檢查每個元件的就緒狀態。
114112

115-
- Harvester components script
113+
- Harvester 元件腳本
116114
```shell
117115
#!/bin/bash
118116
@@ -147,44 +145,44 @@ After you obtain a copy of the kubeconfig file, run the following script against
147145
```
148146

149147
:::note
150-
151-
You must replace `<VIP>` with the [real VIP](../install/management-address.md#how-to-get-the-vip-mac-address), which is the value of `kube-vip.io/requestedIP` in the link.
148+
149+
您必須將 `<VIP>` 替換為[實際的 VIP](../install/management-address.md#how-to-get-the-vip-mac-address),這是連結中 `kube-vip.io/requestedIP` 的值。
152150

153151
:::
154152

155-
## Collecting troubleshooting information
153+
## 收集故障排除資訊
156154

157-
Please include the following information in a bug report when reporting a failed installation:
155+
在報告安裝失敗時,請在錯誤報告中包含以下資訊:
158156

159-
- A failed installation screenshot.
160-
- System information and logs.
161-
- Available as of v1.0.2
157+
- 安裝失敗的螢幕截圖。
158+
- 系統資訊和日誌。
159+
- 從 v1.0.2 開始提供
162160

163-
Please follow the guide in [Logging into the Harvester Installer (a live OS)](#logging-into-the-harvester-installer-a-live-os) to log in. And run the command to generate a tarball that contains troubleshooting information:
161+
請按照[登入 Harvester 安裝程式(即時作業系統)](#logging-into-the-harvester-installer-a-live-os)中的指南登入。並執行命令以產生包含故障排除資訊的壓縮檔:
164162

165163
```
166164
supportconfig -k -c
167165
```
168166

169-
The command output messages contain the generated tarball path. For example the path is `/var/loq/scc_aaa_220520_1021 804d65d-c9ba-4c54-b12d-859631f892c5.txz` in the following example:
167+
命令輸出訊息包含產生的壓縮檔路徑。例如,在以下範例中,路徑為 `/var/loq/scc_aaa_220520_1021 804d65d-c9ba-4c54-b12d-859631f892c5.txz`:
170168

171169
![](/img/harvester/troubleshooting/installation-support-config-example.png)
172170

173171
:::note
174172

175-
A failure PXE Boot installation automatically generates a tarball if the [`install.debug`](../install/harvester-configuration.md#installdebug) field is set to `true` in the Harvester configuration file.
173+
如果在 Harvester 配置檔案中將 [`install.debug`](../install/harvester-configuration.md#installdebug) 欄位設定為 `true`,失敗的 PXE Boot 安裝會自動產生壓縮檔。
176174

177175
:::
178176

179-
## Harvester Console shows "Setting up Harvester" after day 0 Installation
177+
## Harvester 控制台在第 0 天安裝後顯示「Setting up Harvester」
180178

181-
### Issue Description
179+
### 問題描述
182180

183-
After a successful installation, the Harvester console persistently shows `Setting up Harvester`. While most UI and CLI operations remain unaffected, attempts to [start an upgrade](../upgrade/automatic.md#start-an-upgrade) are blocked.
181+
成功安裝後,Harvester 控制台持續顯示 `Setting up Harvester`。雖然大多數 UI 和 CLI 操作不受影響,但嘗試[開始升級](../upgrade/automatic.md#start-an-upgrade)會被阻止。
184182

185183
![](/img/harvester/troubleshooting/setting-up-harvester-after-day-0.png)
186184

187-
The following information is displayed after you run the command `kubectl get managedchart -n fleet-local harvester -oyaml`:
185+
執行命令 `kubectl get managedchart -n fleet-local harvester -oyaml` 後會顯示以下資訊:
188186

189187
```yaml
190188
...
@@ -203,18 +201,18 @@ status:
203201
type: Ready
204202
```
205203

206-
### Root Cause
204+
### 根本原因
207205

208-
The Harvester console runs the following command to determine if the status of the `harvester` ManagedChart (in the `fleet-local` namespace) is `Ready`.
206+
Harvester 控制台執行以下命令以確定 `harvester` ManagedChart(在 `fleet-local` 命名空間中)的狀態是否為 `Ready`。
209207

210208
```
211-
cmd := exec.Command("/bin/sh", "-c", kubectl -n fleet-local get ManagedChart harvester -o jsonpath='{.status.conditions}' |
209+
cmd := exec.Command("/bin/sh", "-c", kubectl -n fleet-local get ManagedChart harvester -o jsonpath='{.status.conditions}' |
212210
jq 'map(select(.type == "Ready" and .status == "True")) | length')
213211
```
214212
215-
The `ManagedChart` CRD is used by [Fleet](https://fleet.rancher.io/) to manage resources via GitOps. If any of those resources are directly modified, `ManagedChart` records and flags the deviations. In the above example, the error occurred because a custom image tag was directly applied to the `harvester-system/harvester-network-controller` DaemonSet.
213+
[Fleet](https://fleet.rancher.io/) 使用 `ManagedChart` CRD 透過 GitOps 管理資源。如果直接修改任何這些資源,`ManagedChart` 會記錄並標記偏差。在上述範例中,由於自訂映像標籤直接套用到 `harvester-system/harvester-network-controller` DaemonSet,因此發生錯誤。
216214
217-
To retrieve the full list of `ManagedChart` resources, run the command `kubectl get bundle -n fleet-local mcc-harvester -oyaml`.
215+
要檢索 `ManagedChart` 資源的完整清單,請執行命令 `kubectl get bundle -n fleet-local mcc-harvester -oyaml`。
218216
219217
```yaml
220218
apiVersion: fleet.cattle.io/v1alpha1
@@ -230,14 +228,14 @@ spec:
230228
- content: ...
231229
```
232230

233-
### Workaround
231+
### 解決方法
234232

235-
You can perform either of the following actions:
233+
您可以執行以下任一操作:
236234

237-
- Revert the direct changes made to the affected resources.
235+
- 還原對受影響資源所做的直接變更。
238236

239-
- Update the `ManagedChart` CRD with the desired custom configuration using `kubectl edit managedchart -n fleet-local harvester`.
237+
- 使用 `kubectl edit managedchart -n fleet-local harvester` 以所需的自訂配置更新 `ManagedChart` CRD。
240238

241-
### Related Issue
239+
### 相關問題
242240

243241
[#8655](https://github.com/harvester/harvester/issues/8655)

‎i18n/zh-TW/docusaurus-plugin-content-docs/current/harvester/troubleshooting/logging.md‎

Lines changed: 33 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -8,19 +8,19 @@ title: "Logging"
88
<link rel="canonical" href="https://docs.harvesterhci.io/v1.6/troubleshooting/logging"/>
99
</head>
1010

11-
The following sections contain tips to troubleshoot Harvester Logging.
11+
以下章節包含對 Harvester 日誌記錄進行故障排除的提示。
1212

13-
## Failed to enable `rancher-logging` Add-On
13+
## 無法啟用 `rancher-logging` 附加元件
1414

15-
### Issue Description
15+
### 問題描述
1616

17-
An error message appears on the Harvester UI when you attempt to enable the [`rancher-logging`](../advanced/addons.md) add-on.
17+
當您嘗試啟用 [`rancher-logging`](../advanced/addons.md) 附加元件時,Harvester UI 上會出現錯誤訊息。
1818

1919
![](/img/harvester/troubleshooting/failed-to-enable-rancher-logging-addon.png)
2020

21-
Log messages from the `cattle-logging-system/helm-install-rancher-logging` pod confirm that an error has occurred.
21+
來自 `cattle-logging-system/helm-install-rancher-logging` Pod 的日誌訊息確認發生了錯誤。
2222

23-
Example:
23+
範例:
2424

2525
```sh
2626
...
@@ -36,34 +36,34 @@ current value is "hvst-upgrade-md54b-upgradelog-operator"
3636

3737
![](/img/harvester/troubleshooting/logging-installation-failure-due-to-conflict.png)
3838

39-
### Root Cause
39+
### 根本原因
4040

41-
**Summary**: When you enable the `rancher-logging` add-on, Harvester attempts to install the [Logging Operator](https://kube-logging.dev/docs/#overview). The installation fails when the operator already exists on the cluster, which may be a stale resource from previous upgrade attempts or created by the current ongoing upgrade.
41+
**摘要**:當您啟用 `rancher-logging` 附加元件時,Harvester 會嘗試安裝 [Logging Operator](https://kube-logging.dev/docs/#overview)。當叢集上已存在 Logging Operator 時,安裝會失敗,該 Logging Operator 可能是先前升級嘗試遺留的資源或由當前正在進行的升級建立的。
4242

43-
The **Upgrade Software** screen includes an **Enable Logging** option that you must select to enable Harvester to log upgrade events.
43+
**Upgrade Software** 畫面包含一個 **Enable Logging** 選項,您必須選擇該選項以啟用 Harvester 記錄升級事件。
4444

4545
![](/img/harvester/troubleshooting/upgrade-with-enable-logging.png)
4646

47-
However, the background processing depends on whether the `rancher-logging` add-on is enabled.
47+
但是,背景處理取決於是否啟用了 `rancher-logging` 附加元件。
4848

49-
When the add-on is disabled, the upgrade controller creates the following `logging` and `managedchart` objects.
49+
當附加元件被停用時,升級控制器會建立以下 `logging` 和 `managedchart` 物件。
5050

5151
```sh
5252
$ kubectl get upgrade.harvesterhci -A
5353
NAMESPACE NAME AGE
54-
harvester-system hvst-upgrade-hpfnw 36s
54+
harvester-system hvst-upgrade-hpfnw 36s
5555

5656
$ kubectl get logging -A
57-
NAME LOGGINGREF CONTROLNAMESPACE
58-
hvst-upgrade-hpfnw-upgradelog-infra harvester-upgradelog harvester-system // newly created by upgrade controller
59-
hvst-upgrade-hpfnw-upgradelog-operator-root cattle-logging-system // newly created by upgrade controller, acts as logging-operator
57+
NAME LOGGINGREF CONTROLNAMESPACE
58+
hvst-upgrade-hpfnw-upgradelog-infra harvester-upgradelog harvester-system // 由升級控制器新建立
59+
hvst-upgrade-hpfnw-upgradelog-operator-root cattle-logging-system // 由升級控制器新建立,作為 logging-operator
6060

6161
$ kubectl get managedchart -A
6262
NAMESPACE NAME AGE
63-
fleet-local hvst-upgrade-hpfnw-upgradelog-operator 18s // newly created by upgrade controller
63+
fleet-local hvst-upgrade-hpfnw-upgradelog-operator 18s // 由升級控制器新建立
6464
```
6565

66-
When the add-on is enabled, the upgrade controller creates the following `logging` object.
66+
當附加元件被啟用時,升級控制器會建立以下 `logging` 物件。
6767

6868
```sh
6969
$ kubectl get upgrade.harvesterhci -A
@@ -74,40 +74,40 @@ $ kubectl get managedchart -A
7474
NAMESPACE NAME AGE
7575

7676
$ kubectl get logging -A
77-
NAME LOGGINGREF CONTROLNAMESPACE
78-
hvst-upgrade-9sn4x-upgradelog-infra harvester-upgradelog harvester-system // newly created by upgrade controller
79-
rancher-logging-kube-audit harvester-kube-audit-log-ref cattle-logging-system // originally created by rancher-logging addon
80-
rancher-logging-root cattle-logging-system // originally created by rancher-logging addon, acts as logging-operator
77+
NAME LOGGINGREF CONTROLNAMESPACE
78+
hvst-upgrade-9sn4x-upgradelog-infra harvester-upgradelog harvester-system // 由升級控制器新建立
79+
rancher-logging-kube-audit harvester-kube-audit-log-ref cattle-logging-system // 最初由 rancher-logging 附加元件建立
80+
rancher-logging-root cattle-logging-system // 最初由 rancher-logging 附加元件建立,作為 logging-operator
8181
```
8282

83-
You may encounter the issue in the following situations:
83+
您可能會在以下情況下遇到此問題:
8484

85-
- The `rancher-logging` add-on is initially disabled. You start the upgrade with the **Enable Logging** option selected. Without waiting for the upgrade to be completed, you enable the `rancher-logging` add-on. The Harvester UI displays an error message.
85+
- `rancher-logging` 附加元件最初被停用。您在選擇 **Enable Logging** 選項的情況下開始升級。在未等待升級完成的情況下,您啟用了 `rancher-logging` 附加元件。Harvester UI 顯示錯誤訊息。
8686

87-
- The `rancher-logging` add-on is initially disabled. You start the upgrade with the **Enable Logging** option selected and wait until the upgrade is completed. The `managedchart` and `logging` objects are not removed because of a [known issue](https://github.com/harvester/harvester/issues/7654). Next, you enable the `rancher-logging` add-on. The Harvester UI displays an error message.
87+
- `rancher-logging` 附加元件最初被停用。您在選擇 **Enable Logging** 選項的情況下開始升級並等待升級完成。由於[已知問題](https://github.com/harvester/harvester/issues/7654),`managedchart` 和 `logging` 物件未被移除。接下來,您啟用 `rancher-logging` 附加元件。Harvester UI 顯示錯誤訊息。
8888

89-
### Workaround
89+
### 解決方法
9090

91-
1. If an upgrade is in progress, wait until it is successfully completed or removed.
91+
1. 如果升級正在進行中,請等待其成功完成或移除。
9292

9393
:::info important
9494

95-
To avoid logging conflicts, do not enable or disable the `rancher-logging` add-on while an upgrade is in progress. This action is blocked in Harvester v1.7.0 and later versions.
95+
為避免日誌衝突,在升級進行中時請勿啟用或停用 `rancher-logging` 附加元件。在 Harvester v1.7.0 和更高版本中,此操作已被阻止。
9696

9797
:::
9898

99-
1. If the `rancher-logging` add-on is enabled but in a failed state, disable it.
99+
1. 如果 `rancher-logging` 附加元件已啟用但處於失敗狀態,請停用它。
100100

101-
1. Check the `logging` and `managedchart` objects. If the names of these objects start with `hvst-upgrade-`, manually delete them.
101+
1. 檢查 `logging` 和 `managedchart` 物件。如果這些物件的名稱以 `hvst-upgrade-` 開頭,請手動刪除它們。
102102

103-
1. Enable the `rancher-logging` add-on.
103+
1. 啟用 `rancher-logging` 附加元件。
104104

105105
:::note
106106

107-
All add-ons must be in a healthy state prior to starting an upgrade. This prerequisite is automatically verified in Harvester v1.7.0 and later versions.
107+
在開始升級之前,所有附加元件都必須處於健康狀態。在 Harvester v1.7.0 和更高版本中,此先決條件會自動驗證。
108108

109109
:::
110110

111-
### Related Issue
111+
### 相關問題
112112

113-
[#9289](https://github.com/harvester/harvester/issues/9289) and [#9644](https://github.com/harvester/harvester/issues/9644)
113+
[#9289](https://github.com/harvester/harvester/issues/9289) 和 [#9644](https://github.com/harvester/harvester/issues/9644)

0 commit comments

Comments
 (0)