**協助改進此頁面** 

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

若要為本使用者指南貢獻內容，請點選每個頁面右側面板中的**在 GitHub 上編輯此頁面**連結。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Amazon EKS 混合節點閘道組態參考
<a name="hybrid-nodes-gateway-configuration"></a>

此頁面記錄 Amazon EKS 混合節點閘道的所有可設定參數。如需安裝指示，請參閱[EKS 混合節點閘道入門](hybrid-nodes-gateway-getting-started.md)。如需閘道的概觀，請參閱 [Amazon EKS 混合節點閘道](hybrid-nodes-gateway-overview.md)。

## Helm Chart 值
<a name="hybrid-nodes-gateway-helm-values"></a>

下表列出 `eks-hybrid-nodes-gateway` Helm Chart 中的所有值。您可以在 或 期間使用`--set`旗標`helm install`或自訂`values.yaml`檔案來設定這些值`helm upgrade`。


| Value | Type | 預設 | 必要 | 描述 | 
| --- | --- | --- | --- | --- | 
|  `image.repository`  | string |  `public.ecr.aws/eks/eks-hybrid-nodes-gateway`  | 否 | 閘道映像的容器映像儲存庫。預設為公有 Amazon ECR 登錄檔。 | 
|  `image.tag`  | string | 圖表 `appVersion`  | 否 | 影像標籤。預設為 中`appVersion`定義的 `Chart.yaml`。 | 
|  `image.pullPolicy`  | string |  `IfNotPresent`  | 否 | 映像提取政策。有效值：`Always`、`IfNotPresent`、`Never`。 | 
|  `replicas`  | integer |  `2`  | 否 | 閘道 Pod 複本的數量。兩個複本是生產環境中高可用性的建議組態。 | 
|  `nodeLabel`  | string |  `hybrid-gateway-node`  | 否 | 用於選取閘道節點的節點標籤金鑰。節點必須將此標籤設為 `"true"`。 | 
|  `vpcCIDR`  | string |  `""`  | 是 | 用於 Cilium VTEP 組態的 VPC CIDR 區塊。範例：`10.0.0.0/16`。 | 
|  `podCIDRs`  | string |  `""`  | 是 | Cilium 在混合節點上使用的 Pod CIDRs 逗號分隔清單。範例：`10.85.0.0/16,10.86.0.0/16`。 | 
|  `routeTableIDs`  | string |  `""`  | 是 | 以逗號分隔的 VPC 路由表 IDs 清單，以混合式 Pod 路由進行程式設計。範例：`rtb-0123456789abcdef0,rtb-0123456789abcdef1`。 | 
|  `autoMode.enabled`  | 布林值 |  `true`  | 否 | 啟用 EKS Auto Mode 整合。當 時`true`，圖表會新增`eks.amazonaws.com/compute-type: auto`節點選擇器，並使用零停機時間滾動更新策略。針對受`false`管節點群組或自我管理節點，將 設定為 。 | 

### 安裝命令範例
<a name="hybrid-nodes-gateway-install-examples"></a>

 **EKS 自動模式** （預設）：

```
helm install eks-hybrid-nodes-gateway oci://public.ecr.aws/eks/eks-hybrid-nodes-gateway \
  --version 1.0.0 \
  --namespace eks-hybrid-nodes-gateway \
  --create-namespace \
  --set vpcCIDR={{VPC_CIDR}} \
  --set podCIDRs={{POD_CIDRS}} \
  --set routeTableIDs={{ROUTE_TABLE_IDS}}
```

 **受管節點群組或自我管理節點**：

```
helm install eks-hybrid-nodes-gateway oci://public.ecr.aws/eks/eks-hybrid-nodes-gateway \
  --version 1.0.0 \
  --namespace eks-hybrid-nodes-gateway \
  --create-namespace \
  --set autoMode.enabled=false \
  --set vpcCIDR={{VPC_CIDR}} \
  --set podCIDRs={{POD_CIDRS}} \
  --set routeTableIDs={{ROUTE_TABLE_IDS}}
```

## 自動模式與受管節點群組組態
<a name="hybrid-nodes-gateway-auto-vs-mng"></a>

`autoMode.enabled` Helm 值控制部署範本中的兩種行為：


| Behavior (行為) |  `autoMode.enabled=true` (default) |  `autoMode.enabled=false`  | 
| --- | --- | --- | 
|  **節點選擇器**  | 除了閘道節點標籤之外，`eks.amazonaws.com/compute-type: auto`新增 。 | 僅使用閘道節點標籤 (`hybrid-gateway-node: "true"`)。 | 
|  **滾動更新策略**  |  `maxSurge: 1`， `maxUnavailable: 0` — 在終止舊的 Pod 之前，先啟動新的 Pod，以確保升級期間不會停機。 |  `maxSurge: 0`， `maxUnavailable: 1` — 會在啟動新的 Pod 之前終止舊的 Pod，因為節點容量已預先佈建。 | 

使用 EKS Auto Mode 時，您必須先建立 `NodePool`和 ，`NodeClass`再安裝 Helm Chart。NodePool 會使用正確的標籤、污點和來源/目的地檢查組態來佈建 EC2 執行個體。如需必要的 YAML，請參閱 [EKS 混合節點閘道入門](hybrid-nodes-gateway-getting-started.md)。使用受管節點群組或自我管理節點時，您必須在安裝圖表之前自行佈建和標記節點。

對於所有部署目標，部署會使用 `hostNetwork: true`和 需要 `NET_ADMIN`功能。Pod 反親和性可確保兩個閘道 Pod 在不同的節點上執行。

## 領導者選擇調校
<a name="hybrid-nodes-gateway-leader-tuning"></a>

閘道使用以 Kubernetes Lease 為基礎的領導者選擇來維護作用中待命模型。預設參數會針對快速容錯移轉進行調校：


| 參數 | 預設 | Description | 
| --- | --- | --- | 
|  `--leader-election-lease-duration`  |  `3s`  | 非領導層在上次觀察到的租約續約後等待多久，再嘗試取得租約。較低的值可更快地偵測領導者故障，但在暫時性網路問題期間增加錯誤容錯移轉的風險。 | 
|  `--leader-election-renew-deadline`  |  `2s`  | 主動領導者在放棄領導之前嘗試續約租約的時間上限。必須小於租用持續時間。 | 
|  `--leader-election-retry-period`  |  `1s`  | 候選者重試取得或續約租約的頻率。 | 

使用預設值時，作用中閘道失敗時的預期容錯移轉時間約為 3–5 秒。這包括待命偵測租用過期、取得租用，以及執行領導者設定序列 (VPC 路由表更新和 Cilium VTEP 組態） 的時間。

### 何時調整領導者選擇參數
<a name="hybrid-nodes-gateway-leader-tuning-guidance"></a>
+  如果您發現閘道 Pod 和 Kubernetes API 伺服器之間發生暫時性網路延遲，導致領導者頻繁轉換，請**延長租用持續時間**。
+  如果您需要更快的容錯移轉偵測，且閘道節點和 API 伺服器之間的網路可靠且低延遲，請**縮短租用持續時間**。
+  **增加重試期間**，以減少大型叢集中領導者選擇的 API 伺服器負載。

**注意**  
`--leader-election-renew-deadline` 一律必須小於 `--leader-election-lease-duration`。如果續約期限超過租賃期間，領導者可能會在續約之前遺失租賃。

## 相關主題
<a name="hybrid-nodes-gateway-configuration-related"></a>
+  [Amazon EKS 混合節點閘道](hybrid-nodes-gateway-overview.md) 
+  [EKS 混合節點閘道入門](hybrid-nodes-gateway-getting-started.md) 
+  [Amazon EKS 混合節點閘道操作](hybrid-nodes-gateway-operations.md) 
+  [Amazon EKS 混合節點閘道疑難排解](hybrid-nodes-gateway-troubleshooting.md)