共用方式為

升級 Active Directory 連接器

  • 發行項

本文說明如何升級 Active Directory 連接器。

必要條件

您需要先安裝下列項目，才能繼續進行本文中的工作：

  • 連線並驗證 Kubernetes 叢集
  • 已選取現有 Kubernetes 內容
  • 在 direct或 indirect 模式中部署的 Azure Arc 資料控制器
  • 已部署的 Active Directory 連接器

安裝工具

若要升級 active Directory 連接器 (adc)，您必須具有 Kubernetes 工具，例如安裝 kubectl。

本文中的範例會使用 kubectl，但您可以使用類似的方法搭配其他 Kubernetes 工具，例如 Kubernetes 儀表板、oc 或 Helm (如果您熟悉這些工具和 Kubernetes yaml/json)。

安裝 kubectl 工具

限制

Active Directory 連接器的自動升級適用於 imageTag v1.12.0_2022-10-11 和更新版本，且 Arc 資料控制器必須至少是 v1.11.0_2022-09-13 版本。

在升級資料控制器之前，Active Directory 連接器 (adc) 的版本必須與資料控制器和相同。

目前沒有可用的批次升級程序。

升級舊版的 Active Directory 連接器

針對 imageTag v1.11.0_2022-09-13 版本或更舊版本，Active Directory 連接器必須手動升級，如下所示：

使用 kubectl 命令來檢視 yaml 中的現有規格。

kubectl get adc <adc-name> --namespace <namespace> --output yaml

執行 kubectl 修補程式以更新所需的版本。

kubectl patch adc <adc-name> --namespace <namespace> --type merge --patch '{"spec": {"update": {"desiredVersion": "v1.11.0_2022-09-13"}}}'

監視器

您可以使用 kubectl 監視升級進度，如下所示：

kubectl describe adc <adc-name> --namespace <namespace>

輸出

命令的輸出會顯示資源資訊。 升級資訊將會在 [狀態] 中顯示。

在升級期間，State 將會顯示 Updating，且 Running Version 將會是目前的版本：

Status:
  Last Update Time:     2022-09-20T16:01:48.449512Z
  Observed Generation:  1
  Running Version:      v1.10.0_2022-08-09
  State:                Updating

當升級完成時，State 將會顯示 Ready，且 Running Version 將會是新版本：

Status:
  Last Update Time:     2022-09-20T16:01:54.279612Z
  Observed Generation:  2
  Running Version:      v1.11.0_2022-09-13
  State:                Ready

疑難排解

當所需的版本設定為特定版本時，啟動載入器作業會嘗試升級至該版本，直到成功為止。 如果升級成功，規格的 RunningVersion 屬性會更新為新版本。 升級可能會失敗，例如不正確的映像標籤、無法連線至登錄或存放庫、配置給容器的 CPU 或記憶體不足，或儲存體不足。

  1. 執行下列命令，以查看是否有任何 Pod 顯示 Error 狀態或有大量重新啟動：

    kubectl get pods --namespace <namespace>

  2. 若要查看事件以了解是否發生錯誤，請執行

    kubectl describe pod <pod name> --namespace <namespace>

  3. 若要取得 Pod 中的容器清單，請執行

    kubectl get pods <pod name> --namespace <namespace> -o jsonpath='{.spec.containers[*].name}*'

  4. 若要取得容器的記錄，請執行

    kubectl logs <pod name> <container name> --namespace <namespace>

若要檢視常見的錯誤以及如何進行疑難排解，請移至針對資源進行疑難排解。