更新叢集主節點的步驟

開始之前，請確認您已安裝 操作員 或 管理員 IAM 平台存取角色。

如果正在進行憑證授權機構 (CA) 憑證輪換，群集主機的更新會被攔截。 在更新群集主站之前，請等待輪換完成。

若要更新 Kubernetes 的_主版本號_或_次_版本號：

1. 請檢視 Kubernetes 的版本資訊，並執行所有標示為「Update before master」的更新。

2. 檢閱任何 Kubernetes 有用警告，例如淘汰注意事項。

3. 請檢查叢集裡安裝的附加程式和外掛程式，以瞭解更新叢集版本可能造成的任何影響。

   • 正在檢查附加程式

     1. 列出叢集裡的附加程式。

        ibmcloud ks cluster addon ls --cluster CLUSTER
        

     2. 針對已安裝的每一個附加程式，檢查支援的 Kubernetes 版本。

        ibmcloud ks addon-versions
        

     3. 如果必須更新附加程式，才能在您要將叢集更新至的 Kubernetes 版本中執行，請 更新附加程式。

   • 正在檢查外掛程式

     1. 在 Helm 型錄中，尋找您在叢集裡安裝的外掛程式。
     2. 從側邊功能表中，展開 來源與 TAR 檔 區段。
     3. 下載並開啟原始碼。
     4. 請檢查 README.md 或 RELEASENOTES.md 檔案，以取得支援的版本。
     5. 如果必須更新外掛程式，才能在您要將叢集更新至的 Kubernetes 版本中執行，請遵循外掛程式指示來更新外掛程式。

4. 使用 IBM Cloud 主控台或執行 CLI ibmcloud ks cluster master update 指令來更新 API 伺服器和關聯的主節點元件。

5. 等待幾分鐘，然後確認更新已完成。 在 IBM Cloud 叢集儀表板上檢閱 API 伺服器版本，或執行 ibmcloud ks cluster ls。

6. 安裝與主節點中執行的 API 伺服器版本相符合的 kubectl cli 版本。 Kubernetes 不支援與伺服器版本相差兩個或更多版本（n ± 2）的 kubectl 客戶端版本。

主節點更新完成後，可以更新工作者節點，具體取決於您擁有的叢集基礎架構提供者的類型。

• 更新經典工作節點。
• 正在更新 VPC 工作節點。

必要條件

在更新標準基礎架構工作者節點之前，請檢閱必要條件步驟。

更新工作者節點可能會導致應用程式及服務發生運作中斷時間。 您的工作者節點機器會重新安裝映像，而且如果資料不是儲存在 Pod 之外即會被刪除。

• 如需最新的安全修補程式及修正程式，請確保在最新修補程式可用之後盡快將工作者節點更新至最新修補程式。 如需最新更新項目的相關資訊，請檢閱 Kubernetes 版本資訊。
• 請登入您的帳戶。 適用的話，請將適當的資源群組設為目標。 設定叢集的環境定義。
• 更新主節點。 工作節點的版本不得高於您 Kubernetes 主節點上執行的 API 伺服器版本。
• 在 Kubernetes 版本準備手冊 中，進行任何標示 在主節點之後更新 的變更。
• 若要套用修補程式更新，請參閱 Kubernetes 的版本資訊。
• 請考慮增加更多工作節點，以確保您的叢集在更新期間擁有足夠的容量來重新排程您的工作負載。 如需相關資訊，請參閱 將工作者節點新增至標準叢集 或 將工作者節點新增至 VPC 叢集。
• 請確認您已安裝 操作員 或 管理員 IAM 平台存取角色。

在 CLI 中使用配置對映更新標準工作者節點

設定配置對映以執行標準工作者節點的漸進式更新。

1. 完成必要條件步驟。

2. 列出可用的工作者節點，並記下其專用 IP 位址。

   ibmcloud ks worker ls --cluster CLUSTER
   

3. 檢視工作者節點的標籤。 您可以在 CLI 輸出的 Labels 區段中找到工作者節點標籤。 每個標籤都包含 NodeSelectorKey 及 NodeSelectorValue。

   kubectl describe node PRIVATE-WORKER-IP
   

   輸出範例

   NAME:               10.184.58.3
   Roles:              <none>
   Labels:             arch=amd64
                   beta.kubernetes.io/arch=amd64
                   beta.kubernetes.io/os=linux
                   failure-domain.beta.kubernetes.io/region=us-south
                   failure-domain.beta.kubernetes.io/zone=dal12
                   ibm-cloud.kubernetes.io/encrypted-docker-data=true
                   ibm-cloud.kubernetes.io/iaas-provider=softlayer
                   ibm-cloud.kubernetes.io/machine-type=u3c.2x4.encrypted
                   kubernetes.io/hostname=10.123.45.3
                   privateVLAN=2299001
                   publicVLAN=2299012
   Annotations:        node.alpha.kubernetes.io/ttl=0
                   volumes.kubernetes.io/controller-managed-attach-detach=true
   CreationTimestamp:  Tue, 03 Apr 2022 15:26:17 -0400
   Taints:             <none>
   Unschedulable:      false
   

4. 建立配置對映，並且定義工作者節點的無效性規則。 下列範例顯示四項檢查：zonecheck.json、regioncheck.json、defaultcheck.json 及檢查範本。 您可以使用這些檢查範例，為特定區域（zonecheck.json ）、區域（regioncheck.json ）中的工作節點定義規則，或是為所有未符合您在配置地圖（defaultcheck.json ）中定義的任何檢查條件的工作節點定義規則。請使用檢查範本來建立您自己的檢查。 針對每項檢查，若要識別工作者節點，您必須選擇前一個步驟中所擷取的其中一個工作者節點標籤。

   對於每項檢查，您只能為 NodeSelectorKey 和 NodeSelectorValue`` 設定一個值。 如果您要為多個地區、區域或其他工作者節點標籤設定規則，請建立新的檢查。 在配置地圖中最多可定義 15 項檢查。 如果您新增其他檢查，則在更新所要求的所有工作者節點之前，一次只會重新載入 1 個工作者節點。

   範例

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: ibm-cluster-update-configuration
     namespace: kube-system
   data:
     drain_timeout_seconds: "120"
     zonecheck.json: |
       {
         "MaxUnavailablePercentage": 30,
         "NodeSelectorKey": "failure-domain.beta.kubernetes.io/zone",
         "NodeSelectorValue": "dal13"
       }
     regioncheck.json: |
       {
         "MaxUnavailablePercentage": 20,
         "NodeSelectorKey": "failure-domain.beta.kubernetes.io/region",
         "NodeSelectorValue": "us-south"
       }
     defaultcheck.json: |
       {
         "MaxUnavailablePercentage": 20
       }
     <check_name>: |
       {
         "MaxUnavailablePercentage": <value_in_percentage>,
         "NodeSelectorKey": "<node_selector_key>",
         "NodeSelectorValue": "<node_selector_value>"
       }
   

   drain_timeout_seconds

   可選：等待 排水完成的超時時間（以秒為單位）。 排除工作者節點可安全地移除工作者節點中的所有現有 Pod，以及將 Pod 重新排定至叢集裡的其他工作者節點。 接受的值為範圍在 1 到 180 之間的整數。 預設值為 30。

   zonecheck.json 及 regioncheck.json

   兩個核對項目，用於定義一組工作節點的規則，您可以透過指定的 NodeSelectorKey 和 NodeSelectorValue 來識別這些節點。 zonecheck.json 會根據工作節點的區域標籤來識別這些節點，而 regioncheck.json 則會使用在配置過程中新增至每個工作節點的區域標籤。 在此範例中，在更新期間，所有區域標籤為 dal13 的工作節點中有 30%，以及所有位於 us-south 的工作節點中有 20%，可能會處於不可用狀態。

   defaultcheck.json

   若未建立配置地圖，或地圖設定有誤，則會套用 Kubernetes 的預設值。 依預設，叢集裡只能有 20% 的工作者節點同時無法使用。 您可以新增配置對映的預設檢查，來置換預設值。 在此範例中，凡未在區域（zone）與區域（region）檢查（dal13 或 us-south ）中指定的每個工作節點，都可能在更新期間處於不可用狀態。

   MaxUnavailablePercentage

   對於指定的標籤鍵和值，容許無法使用的節點數目上限，以百分比的格式指定。 工作者節點在部署、重新載入或佈建程序中會無法使用。 如果已排入佇列的工作者節點超出任何已定義的無法使用百分比上限，則會被封鎖而無法更新。

   NodeSelectorKey

   您要設定規則的工作者節點的標籤索引鍵。 可以為 IBM 提供的預設標籤以及您建立的工作者節點標籤設定規則。 若要針對屬於同一個工作節點池的工作節點新增一則規則，您可以使用「ibm-cloud.kubernetes.io/machine-type」標籤。

   NodeSelectorValue

   工作者節點必須具有以讓您定義的規則考量的標籤值。

5. 在叢集裡建立配置對映。

   kubectl apply -f <filepath/configmap.yaml>
   

6. 驗證已建立配置對映。

   kubectl get configmap --namespace kube-system
   

7. 更新工作者節點。

   ibmcloud ks worker update --cluster CLUSTER --worker WORKER-NODE-1-ID --worker WORKER-NODE-2-ID
   

8. 選用項目：驗證配置對映所觸發的事件，以及發生的所有驗證錯誤。 在 CLI 輸出的 Events 區段中，可以檢閱事件。

   kubectl describe -n kube-system cm ibm-cluster-update-configuration
   

9. 藉由檢閱工作者節點的 Kubernetes 版本，來確認更新已完成。

   kubectl get nodes
   

10. 請確認您沒有重複的工作節點。 有時，較舊的叢集可能會列出具有重複的 NotReady 狀態。 若要移除重複項目，請參閱疑難排解。

後續步驟：

• 對其他工作者節點儲存區重複更新處理程序。
• 通知在叢集內工作的開發人員，將 kubectl CLI 更新至 Kubernetes 主節點的版本。
• 如果 Kubernetes 儀表板未顯示使用率圖形，則會刪除 kube-dashboard Pod。

在主控台中更新標準工作者節點

首次設定配置對映後，接著就可以使用 IBM Cloud 主控台來更新工作者節點。

若要從主控台更新工作者節點，請執行下列動作：

1. 完成必要條件步驟和設定配置對映，以控制工作者節點的更新方式。
2. 從 IBM Cloud 主控台 功能表的 ，按一下 Containers > Clusters。
3. 從叢集頁面中，按一下您的叢集。
4. 在「工作節點」索引標籤中，勾選您要更新的每個工作節點旁的核取方塊。 動作列顯示在表格標頭列上方。
5. 從動作列中，按一下更新。

如果叢集裡已安裝 Portworx，則必須在已更新的工作者節點上重新啟動 Portworx Pod。 如需相關資訊，請參閱 Portworx 限制。

必要條件

在更新 VPC 基礎架構工作者節點之前，請檢閱必要條件步驟。

更新工作者節點可能會導致應用程式及服務發生運作中斷時間。 系統會移除工作者節點機器，並且如果資料未儲存在 Pod 外部，則將刪除資料。

• 如需最新的安全修補程式及修正程式，請確保在最新修補程式可用之後盡快將工作者節點更新至最新修補程式。 如需最新更新項目的相關資訊，請檢閱 Kubernetes 版本資訊。
• 請登入您的帳戶。 適用的話，請將適當的資源群組設為目標。 設定叢集的環境定義。
• 更新主節點。 工作節點的版本不得高於您 Kubernetes 主節點上執行的 API 伺服器版本。
• 在 Kubernetes 版本準備手冊 中，進行任何標示 在主節點之後更新 的變更。
• 若要套用修補程式更新，請參閱 Kubernetes 的版本資訊。
• 請確認您已安裝 操作員 或 管理員 IAM 平台存取角色。

管理 Fluentd 的自動更新

當您為叢集中的來源建立記錄配置以轉發至外部伺服器時，系統會在您的叢集中建立一個「Fluentd」元件。 若要變更記錄或篩選設定，請確保「Fluentd」元件已更新至最新版本。 依預設，會啟用元件的自動更新。

您可以透過下列方式來管理 Fluentd 元件的自動更新。 註: 若要執行以下指令，您必須擁有該叢集的 管理員 IBM Cloud IAM 平台存取角色 權限。

• 請執行 ibmcloud ks logging autoupdate get --cluster CLUSTER 指令，以檢查自動更新是否已啟用。
• 藉由執行 ibmcloud ks logging autoupdate disable 指令來停用自動更新。
• 如果停用了自動更新，但您需要對配置進行變更，則有兩個選項：
  • 開啟 Fluentd Pod 的自動更新。

      ibmcloud ks logging autoupdate enable --cluster CLUSTER
      ```
  * 在您使用包括 `--force-update` 選項的 logging 指令時，強制執行一次性更新。 **附註**：Pod 會更新到最新版本的 Fluentd 元件，但 Fluentd 此後不會自動更新。
          範例指令
  
  ```sh {: pre}
      ibmcloud ks logging config update --cluster CLUSTER --id LOG-CONFIG-ID --type LOG-TYPE --force-update
      ```
  

管理 Ingress ALB 的自動更新

控制何時更新 Ingress 應用程式負載平衡器 (ALB) 元件。 如需保持 ALB 最新的相關資訊，請參閱 管理 Ingress ALB 生命週期。