Google Distributed Cloud 軟體錯誤

這是 Google Distributed Cloud 軟體專用產品、裸機和 VMware 的錯誤目錄。

每個錯誤項目都包含下列資訊:

  • 錯誤 ID:簡短的專屬 ID,格式為 E######,其中 ###### 是專屬號碼。

  • 錯誤標題:人類可讀的簡短錯誤說明。

  • 錯誤說明:詳細資訊,協助您排解及解決錯誤原因。

E000000:未指定 Kubeconfig 檔案

執行 bmctl 指令時,未指定 kubeconfig 檔案。

如要繼續操作,請務必使用 --kubeconfig 旗標提供 kubeconfig 檔案。

範例:

bmctl [command] --kubeconfig [kubeconfig-file]

E000001:kubeconfig 檔案無效

提供的 kubeconfig 檔案並非一般檔案模式。

請務必指定有效的 kubeconfig 檔案,然後再試一次。

E000002:已呼叫 Bootstrap.Run 函式

Bootstrap.Run 函式會執行工作流程,初始化記錄目錄和檔案,並視需要建立啟動程序叢集。

這個函式只會在執行 bmctl 指令時呼叫一次,以免建立多個 bootstrap 叢集。

如果 Bootstrap.Run 函式叫用多次,就會發生這項錯誤,這並非預期行為。

請等待任何現有的 bmctl 程序完成,然後再試一次。

E000003:找不到相符的區域或可用區

請確認叢集設定檔中 spec.clusterOperations.location 內提供的位置存在於 Google Cloud 專案中。

如要查看專案中所有區域和可用區的清單,請執行下列指令:

gcloud compute regions list

如果專案中確實有您提供的區域或可用區,請確認大小寫正確無誤。區域和可用區須區分大小寫。

E000004:Secret 儲存在不正確的命名空間

例如,傳回的錯誤訊息可能如下:

The secret 'x' should be stored in the namespace 'y'.
Please remove 'x' from the path "p" in the configuration file of cluster 'c'.

如要解決這個問題,請從叢集設定檔中,移除參照錯誤命名空間的 Secret。

E000005:HTTP 狀態碼不符

嘗試存取 Google Cloud API 或 Google Container Registry API 時,傳回非預期的 HTTP 狀態碼。

確認 Proxy 設定正確無誤,並視情況提供 Proxy 網址。

請採取下列任一做法,確保提供服務帳戶金鑰:

  • 將 GOOGLE_APPLICATION_CREDENTIALS 環境變數設為包含服務帳戶憑證的檔案路徑。
  • 執行下列指令,使用預設憑證向 Google Cloud 進行驗證:

    gcloud auth application-default login
    

詳情請參閱 https://cloud.google.com/docs/authentication#adc。

請前往 Google Cloud 控制台 ->「IAM 與管理」->「服務帳戶」查看服務帳戶。 如果服務帳戶金鑰已過期,請按照 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/how-to/update-secrets 的說明更新金鑰。

請檢查服務帳戶的角色和權限,然後再試一次。 如要瞭解需要建立及設定哪些 Google Cloud 資源,請參閱 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/installing/configure-sa。

E000006:沒有管理員叢集的 Kubeconfig,無法管理使用者叢集

如果沒有管理員叢集的 kubeconfig 路徑,我們就無法管理使用者叢集。必須提供管理員叢集的 kubeconfig 路徑,才能管理使用者叢集。

如要解決這個錯誤,請務必在管理使用者叢集時,使用 --kubeconfig 旗標提供管理員叢集的 kubeconfig 路徑。

這可確保管理使用者叢集時,已正確設定必要的驗證和權限。

E000007:版本不符

叢集設定檔中 spec.anthosBareMetalVersion 下方指定的版本,與用於管理叢集的 bmctl 二進位檔版本不符。

如何解決這項錯誤:

  • 將 bmctl 二進位檔更新為與叢集版本相符的適當版本。
  • 如要升級,請更新叢集設定中指定的版本,以反映 bmctl 二進位檔版本。

E000008:未指定 ClusterOperations 設定

叢集必須具備 ClusterOperations 設定。

請確認叢集設定檔中 spec.clusterOperations 下方的叢集已正確定義 ClusterOperations 設定。

E000009:未指定 ClusterOperations 中的 ProjectID

ClusterOperations 設定中的 ProjectID 欄位空白。必須提供 ProjectID,才能管理叢集作業。

請確認叢集設定檔中 spec.clusterOperations.projectID 下方的 ProjectID 定義正確。

E000010:未指定 ClusterOperations 中的位置

ClusterOperations 設定中的「Location」欄位空白。必須提供位置,才能管理叢集作業。

請確認叢集設定檔中 spec.clusterOperations.location 下方的位置定義正確。

E000011:使用存取權杖時無法使用服務帳戶

如果叢集是使用存取權杖建立,則須移除叢集設定檔中指定的服務帳戶金鑰路徑。

請確認下列事項:

  1. 環境變數 GCP_ACCESS_TOKEN_X 已設定。
  2. 叢集設定檔中參照的服務帳戶金鑰路徑會遭到移除。

E000012:使用存取權杖時無法使用服務帳戶

如果叢集是使用服務帳戶金鑰建立,請確認:

  1. 未設定環境變數 GCP_ACCESS_TOKEN_X。
  2. 叢集設定檔中已設定所有必要的服務帳戶金鑰路徑。

E000013:在沒有 --force 的情況下略過 Google Cloud 預檢失敗

旗標 --bypass-gcp-preflight-errors 必須與 --force 一併設定。

請務必同時使用這兩個旗標,才能繼續操作。

E000014:不支援 Docker 容器執行階段

系統不再支援 Docker 容器執行階段。

在叢集設定檔中,將容器執行階段設為 spec.nodeConfig.containerRuntime 下方的 containerd。

E000015:未啟用 API

專案未啟用某些必要 API。

請確認專案已啟用所有必要的 API,詳情請參閱 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/installing/configure-sa。

E000016:kubeconfig 檔案狀態錯誤

提供的 kubeconfig 檔案不存在或無法存取。

請確認 kubeconfig 檔案存在,且 bmctl 指令具備必要的存取權限。

E000017:未啟用 IPV4 轉送

管理員工作站未啟用 IPv4 轉送功能。必須啟用 IPv4 轉送功能。

如要解決這項錯誤,請按照下列步驟操作:

  1. 確認 /proc/sys/net/ipv4/ip_forward 檔案存在。
  2. 執行下列指令,啟用 IPv4 轉送功能:
echo '1' > /proc/sys/net/ipv4/ip_forward

E000018:無法剖析設定檔

無法剖析叢集的設定檔。有幾個問題可能會導致這個問題。

請確認設定檔 bmctl-workspace/[cluster-name]/[cluster-name].yaml 存在,且 bmctl 指令具備必要的存取權限。

請檢查設定檔是否有語法錯誤或缺少欄位。

如需更新設定檔,請務必採用正確的格式和結構。詳情請參閱 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/reference/cluster-config。

E000019:控制層負載平衡器工作未完成

這表示等待控制層或負載平衡器工作完成時發生錯誤。

檢查叢集的控制層或負載平衡器工作狀態:

kubectl describe jobs -A

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000020:無法建立 HTTP 用戶端

無法建立 HTTP 用戶端,確保工作站可連上 Google Cloud API 和 Container Registry。

請確認 Proxy 設定正確無誤,並視需要提供 Proxy 網址。

E000021:無法連線至 Google API

我們無法驗證與 Google Cloud API 或 Google Container Registry API 的連線。

工作站必須能連上 Google Cloud API 和 Container Registry,才能正常運作。

請採取下列任一做法,確保提供服務帳戶金鑰:

  • 將 GOOGLE_APPLICATION_CREDENTIALS 環境變數設為包含服務帳戶憑證的檔案路徑。
  • 執行下列指令,使用預設憑證向 Google Cloud 進行驗證:

    gcloud auth application-default login
    

詳情請參閱 https://cloud.google.com/docs/authentication#adc。

如要查看服務帳戶,請前往 Google Cloud 控制台 ->「IAM 與管理」->「服務帳戶」。 如果服務帳戶金鑰已過期,請按照 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/how-to/update-secrets 的說明更新。

請檢查服務帳戶的角色和權限,然後再試一次。 如要瞭解需要建立及設定哪些 Google Cloud 資源,請參閱 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/installing/configure-sa。

E000022:無法剖析叢集版本

無法剖析叢集設定檔中的版本。

如要解決這項錯誤,請確認叢集設定檔中 spec.anthosBareMetalVersion 下指定的版本有效,且符合預期格式。

E000023:GKE 成員資格用戶端錯誤

無法取得用戶端來建立 GKE Hub 成員資格註冊。

如果在叢集設定檔的 spec.gkeConnect 下設定 GKE Connect,則必須具備 GKE 成員資格。

請確認叢集設定檔中已指定 gcpAccessToken 或 gkeConnectAgentServiceAccountKeyPath。

E000024:無法建立 GKE 註冊檢查

無法建立新的 GKE 註冊檢查。

這項檢查是為了確認:

  • 尚未註冊 GKE Connect。
  • 您的服務帳戶具備足夠權限,可對 GKE Connect 註冊執行異動。

請前往 Google Cloud 控制台 ->「Kubernetes Engine」->「叢集」,確認叢集沒有現有的 GKE Connect 成員資格。如果叢集已有成員資格,請執行下列任一操作:

  • 請改用其他叢集名稱。
  • 透過 Google Cloud 控制台取消註冊現有叢集,或執行下列指令:

    gcloud container hub memberships unregister <CLUSTER_NAME> --gke-cluster=<LOCATION>/<CLUSTER_NAME>
    

    參考資料:https://cloud.google.com/sdk/gcloud/reference/container/hub/memberships/unregister

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000025:GKE 註冊檢查失敗

這表示執行 GKE 註冊檢查時發生錯誤。

這項檢查對於驗證下列事項至關重要:

  • 尚未註冊 GKE Connect。
  • 您的服務帳戶具備足夠權限,可對 GKE Connect 註冊執行異動。

請前往 Google Cloud 控制台 ->「Kubernetes Engine」->「叢集」,確認叢集沒有現有的 GKE Connect 成員資格。如果叢集已有成員資格,請執行下列任一操作:

  • 請改用其他叢集名稱。
  • 透過 Google Cloud 控制台取消註冊現有叢集,或執行下列指令:

    gcloud container hub memberships unregister <CLUSTER_NAME> --gke-cluster=<LOCATION>/<CLUSTER_NAME>
    

參考資料:https://cloud.google.com/sdk/gcloud/reference/container/hub/memberships/unregister

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000026:無法擷取 Google 預設憑證

無法擷取 Google 預設憑證。如要瞭解詳情,請參閱 https://cloud.google.com/docs/authentication/production#automatically。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000027:Google Cloud 權限遭拒

這表示 Google Cloud API 要求遭拒。

請採取下列任一做法,確保提供服務帳戶金鑰:

  • 將 GOOGLE_APPLICATION_CREDENTIALS 環境變數設為包含服務帳戶憑證的檔案路徑。
  • 執行下列指令,使用預設憑證向 Google Cloud 進行驗證:

    gcloud auth application-default login
    

詳情請參閱 https://cloud.google.com/docs/authentication#adc。

如要查看服務帳戶,請前往 Google Cloud 控制台 ->「IAM 與管理」->「服務帳戶」。 如果服務帳戶金鑰已過期,請按照 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/how-to/update-secrets 的說明更新金鑰。

請檢查服務帳戶的角色和權限,然後再試一次。 如要瞭解需要建立及設定哪些 Google Cloud 資源,請參閱 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/installing/configure-sa。

E000028:服務帳戶金鑰無效

用於 Google 預設憑證的服務帳戶金鑰無效。

如要查看服務帳戶,請前往 Google Cloud 控制台 ->「IAM 與管理」->「服務帳戶」。 如果服務帳戶金鑰已過期,請按照 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/how-to/update-secrets 的說明更新金鑰。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000029:Google Cloud 權限不足

權限不足,無法與 Google Cloud API 通訊。必須提供有效的服務帳戶金鑰,才能順利通訊。

請採取下列任一做法,確保提供服務帳戶金鑰:

  • 將 GOOGLE_APPLICATION_CREDENTIALS 環境變數設為包含服務帳戶憑證的檔案路徑。
  • 執行下列指令,使用預設憑證向 Google Cloud 進行驗證:

    gcloud auth application-default login
    

詳情請參閱 https://cloud.google.com/docs/authentication#adc。

如要查看服務帳戶,請前往 Google Cloud 控制台 ->「IAM 與管理」->「服務帳戶」。 如果服務帳戶金鑰已過期,請按照 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/how-to/update-secrets 的說明更新金鑰。

請檢查服務帳戶的角色和權限,然後再試一次。 如要瞭解需要建立及設定哪些 Google Cloud 資源,請參閱 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/installing/configure-sa。

E000030:無法建立運算服務

我們無法建立運算服務,從 Google Cloud 專案擷取可用區或位置資訊,因此無法檢查叢集設定中 spec.clusterOperations.location 指定的位置。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000031:無法建立服務帳戶檢查

無法建立服務帳戶檢查。

系統會使用叢集設定檔中 cloudOperationsServiceAccountKeyPath 底下指定的服務帳戶金鑰檔案,建立服務帳戶檢查。

請確認服務帳戶檔案存在且有效。

如要查看服務帳戶,請前往 Google Cloud 控制台 ->「IAM 與管理」->「服務帳戶」。 如果服務帳戶金鑰已過期,請按照 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/how-to/update-secrets 的說明更新金鑰。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000032:服務帳戶檢查失敗

這表示執行服務帳戶檢查時發生錯誤。

這項檢查會驗證叢集設定檔中,cloudOperationsServiceAccountKeyPath 下方參照的服務帳戶金鑰檔案。

請確認下列事項:

請前往 Google Cloud 控制台 ->「IAM 與管理」->「服務帳戶」,查看服務帳戶金鑰。 如果服務帳戶金鑰已過期,請按照 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/how-to/update-secrets 的說明更新金鑰。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000033:無法設定標記

無法為記錄目錄或檔案設定旗標。

bmctl 指令會使用記錄目錄或檔案,在指令執行時儲存記錄。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000034:無法建立目錄

無法建立目錄。

這類問題通常是因為權限不足,無法建立目錄,或是建立目錄的路徑不存在。

請確認您具備建立目錄的必要權限,且指定的位置確實存在。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000035:Container Registry 權限驗證失敗

執行 Container Registry 權限驗證時發生錯誤。

系統會使用 gcrServiceAccountKey 下方叢集設定檔中參照的服務帳戶金鑰檔案執行驗證。

請確認服務帳戶金鑰檔案存在且有效。請前往 Google Cloud 控制台 ->「IAM 與管理」->「服務帳戶」,查看服務帳戶金鑰。 如果服務帳戶金鑰已過期,請按照 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/how-to/update-secrets 的說明更新金鑰。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

如要忽略驗證失敗,請在執行指令時使用 --ignore-validation-errors 旗標。

E000036:最低核心版本需求

工作站的最低核心版本驗證失敗。工作站必須符合最低核心版本需求。

確認核心版本的數字部分大於或等於 4.15.0。如要查看核心版本,請執行下列指令:

uname -r

您也可以在 /proc/version 檔案中找到核心詳細資料。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000037:無法擷取服務帳戶名稱

無法擷取 Workload Identity 所需的服務帳戶。

請在叢集設定檔中提供下列其中一項,修正錯誤:

  • 將 spec.gkeConnect.projectID 欄位設為 Google Cloud 專案 ID。
  • 將 metadata.annotations 下方的 baremetal.cluster.gke.io/gcr-service-account 設為服務帳戶名稱。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000038:無法建立啟動叢集

無法成功建立啟動叢集。啟動叢集是暫時叢集,會託管建立或升級自行管理 (管理員、混合或獨立) 叢集所需的 Kubernetes 控制器。

如要修正啟動叢集相關問題,請參閱 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/troubleshooting/create-upgrade。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000039:啟動叢集網際網路故障

無法使用下列指令驗證啟動叢集的網際網路連線:

docker exec bmctl-control-plane curl https://oauth2.googleapis.com/$discovery/rest

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000040:無法從 Kubeconfig 檔案建立 REST 設定

無法從 kubeconfig 檔案建立 REST 設定。您需要 REST 設定,才能建立與 Kubernetes API 伺服器通訊的方式。

請確認提供的 kubeconfig 檔案存在且有效。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000041:無法安裝啟動叢集依附元件

無法將所有必要資源套用至啟動叢集。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000042:無法安裝啟動叢集外部資訊清單

無法從 --addon-manager-manifests-path 標記指定的目錄安裝資訊清單。

請確認提供的資訊清單目錄存在且有效。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000043:無法擷取資訊清單檔案

無法成功擷取資訊清單檔案。 資訊清單檔案應會擷取至 .manifests 目錄,該目錄會在叫用 bmctl 指令時建立。

確認 bmctl 指令具備必要權限,可在系統上建立目錄和檔案,且 .manifests 目錄已成功建立。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000044:無法建立 Kubernetes 用戶端

無法使用提供的 kubeconfig 檔案,為叢集建立 Kubernetes 用戶端。

請確認 kubeconfig 檔案存在且有效。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000045:無法載入叢集資訊清單設定檔

載入程序會將設定檔中的項目轉換為 KusBuild,並使用叢集自訂資源中的值設定參數。設定檔位置取決於資訊清單的根目錄、設定檔名稱和環境。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000046:無法設定 Workload Identity

無法成功為專案設定 Workload Identity。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000047:無法建立或更新偵錯選項

系統無法根據提供給 bmctl 指令的旗標和叢集設定檔頂端部分,在啟動程序叢集中建立或更新偵錯選項 ConfigMap。

這個 ConfigMap 包含相關設定資料,是偵錯時不可或缺的資源。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000048:無法建立用量服務

無法建立服務用量。這項服務是存取 Google Cloud 服務用量 API 的關鍵,可讓您執行必要工作,例如確認是否已啟用必要 API。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000049:API 啟用檢查失敗

這表示執行 API 啟用檢查時發生錯誤。這可確保專案已啟用所有必要的 API,詳情請參閱 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/installing/configure-sa。

如要略過 API 啟用檢查失敗,請使用 --skip-api-check 旗標。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000050:無法執行物件作業

這表示在 Kubernetes 或自訂物件上執行 Get、Patch、List、Update、Delete 或 Apply 作業時發生錯誤。

確認 Kubernetes 叢集可供存取,且 API 伺服器可正常回應。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000051:無法封送物件

無法將物件封送處理為 YAML 格式。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000052:無法從服務帳戶產生 Secret

無法根據叢集設定檔中 gkeRegisterServiceAccountKey 指定的服務帳戶金鑰路徑,產生要儲存在命名空間 gke-register 的 Secret gkeRegisterServiceAccountKey。

確認指定的 Secret 檔案存在。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000053:無法讀取叢集設定檔

無法讀取叢集設定檔。

請確認叢集設定檔存在,且 bmctl 指令具備必要的存取權限。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000054:無法套用預檢依附元件資源

無法成功套用預檢指令依附元件。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000055:Google Cloud 預檢失敗

Google Cloud 預檢失敗。請查看預檢資源,瞭解詳情。

查看預檢資源:

kubectl describe preflightcheck -A

如要略過 Google Cloud 預檢失敗,請使用 --bypass-gcp-preflight-errors 和 --force 旗標。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000056:預檢失敗

預檢失敗。請查看預檢資源,瞭解詳情。

查看預檢資源:

kubectl describe preflightcheck -A

如要略過預檢失敗,請使用 --force 旗標。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000057:無法驗證預檢狀態

無法成功驗證預檢資源的狀態。

如要進一步瞭解預檢資源,請參閱下列文章:

kubectl describe preflightcheck -A

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000058:Kubeconfig Secret 尚未就緒

這表示讀取 kubeconfig 密鑰或等待密鑰就緒時發生錯誤。

請確認 Secret <CLUSTER_NAME>-kubeconfig 存在於啟動叢集的叢集命名空間中,且路徑 .data 不是空白。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000059:無法寫入 Kubeconfig 檔案

無法成功將 kubeconifg 檔案寫入路徑 bmctl-workspace/<CLUSTER_NAME>/<CLUSTER_NAME>-kubeconfig。

確認 bmctl 指令具備必要權限,可寫入 kubeconfig 檔案的目錄。

您可以嘗試執行 bmctl reset 指令來解決這個問題,然後再次嘗試建立叢集。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000060:叢集尚未準備就緒

這表示等待叢集準備就緒時發生錯誤。

查看叢集狀態,瞭解詳情:

kubectl describe cluster <CLUSTER_NAME> -A

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000061: NodePool 未就緒

這表示等待節點集區準備就緒時發生錯誤。

檢查節點集區的狀態:

kubectl describe nodepool -A

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000062: SecretForwarder 未就緒

這表示等待 SecretForwarders 準備就緒時發生錯誤。

檢查 SecretForwarder 的狀態:

kubectl describe secretforwarder -A

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000063:無法將非結構化物件轉換為具體類型

無法將非結構化物件轉換為具體類型。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000064:無法安裝叢集 API 供應器

無法驗證管理員叢集是否已安裝叢集 API 供應器。

如要排解問題,請登入啟動叢集,並查看 lifecycle-controllers-deployer 工作和 lifecycle-controller-manager Pod 記錄。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000065:無法透視

無法成功將資源從啟動叢集轉移至實際叢集。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000066:無法套用資源

這表示套用資源時發生錯誤。這項資源可能是叢集設定檔中指定的客戶資源。

請確認所有客戶指定的資源格式正確且有效。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000067:無法建立指令

我們無法使用指定旗標建立預留位置指令,供 bmctl 內部指令使用。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000068:無法擷取 GKE 版本

無法根據叢集設定檔中 spec.anthosBareMetalVersion 指定的叢集版本,擷取 GKE 版本。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000069:叢集已是目標版本

這表示叢集已是目標版本。請確認叢集設定檔中 spec.anthosBareMetalVersion 下方指定的版本高於目前的叢集版本,然後再試一次。

E000070:叢集和 NodePool 已是目標版本

這表示叢集和節點集區都已是目標版本。請確認叢集設定檔中 spec.anthosBareMetalVersion 下指定的版本高於目前版本,然後再試一次。

E000071:CIDR 中的 IP 位址不足

這表示 bootstrap 叢集 Pod CIDR 範圍沒有足夠的 IP 位址,無法容納節點。

請務必使用 --bootstrap-cluster-pod-cidr 旗標提供 CIDR 範圍,確保節點有足夠的 IP 位址。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000072:預先發布版功能升級政策驗證失敗

我們無法驗證叢集指定的支援預先發布版功能是否符合升級需求。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000073:無法將啟動程序註冊至 GKE Connect 成員資格

無法將啟動叢集註冊為 GKE Hub 成員。

在 Google Cloud 控制台 -> Kubernetes Engine -> 專案中的叢集,確認啟動叢集名稱 (預設選擇或透過旗標 --bootstrap-cluster 提供) 沒有現有的 GKE 連線成員資格。

如果已有使用該叢集名稱的成員資格,請執行下列任一操作:

  • 請使用 --bootstrap-cluster 旗標提供其他名稱
  • 請透過 Google Cloud 控制台取消註冊現有叢集,或執行下列指令:

    gcloud container hub memberships unregister <CLUSTER_NAME>
    

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000074:無法透過服務帳戶建立 Secret

無法使用叢集設定檔中指定的服務帳戶檔案建立密鑰。

請確認檔案存在且可存取。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000075:無法擷取 GKE Hub 網址

無法擷取 GKE Hub 端點網址。GKE Hub 端點是用於 GKE Hub API 要求的網址端點。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000076:升級未完成

等待升級完成時發生錯誤。叢集和節點集區必須位於目標版本,升級作業才會判定為完成。

檢查節點集區和叢集的狀態:

kubectl describe nodepool -n <NAMESPACE> --kubeconfig <KUBECONFIG_FILE>
kubectl describe cluster -n <NAMESPACE> --kubeconfig <KUBECONFIG_FILE>

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000077:無法建立 Workload Identity Stackdriver 密鑰

無法建立 Workload Identity Stackdriver 密鑰。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000078:無法提高節點集區版本

無法將 NodePool 資源目前版本升級至目標版本。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000079:無法升級叢集版本

無法將叢集資源目前版本升級至目標版本。

請確認目標版本大於目前版本,且有效。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000080:無法更新 Kubeconfig Secret

無法更新叢集的 kubeconfig 密鑰。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000081:缺少密鑰

這表示 Secret 資源不含特定金鑰。

如要進一步瞭解特定錯誤,請查看指令傳回的錯誤。

E000082:無法列印升級結果

無法列印叢集升級結果。

檢查 BaremetalMachine 資源,找出升級失敗的節點:

kubectl describe baremetalmachines -n <NAMESPACE> --kubeconfig <KUBECONFIG_FILE>

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000083:缺少 GKEConnect 規格

叢集設定中未指定 GKEConnect 規格。

請確認叢集設定檔中提供 spec.gkeConnect 欄位。

E000084:無法建立 Connect 代理連線檢查

無法建立新的 Connect 代理程式連線檢查。

如要進一步瞭解特定錯誤,請查看指令傳回的錯誤。

E000085:Connect 代理程式連線檢查失敗

執行 Connect Agent 連線能力檢查時發生錯誤。

如要進一步瞭解特定錯誤,請查看指令傳回的錯誤。

E000086:無法擷取具有群組版本種類的自訂資源

這表示使用 GroupVersionKind 擷取自訂資源時發生錯誤。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000087:無法從私人登錄檔建構私人登錄檔設定

我們無法根據叢集設定檔中 privateRegistries 下方指定的叢集憑證設定,建構登錄檔設定。

請確認叢集設定檔中 privateRegistries 下方的設定有效,然後再試一次。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000088:無法從登錄檔鏡像建構私人登錄檔設定

我們無法根據叢集設定檔中 registryMirrors 下方指定的叢集憑證設定,建構登錄檔設定。

請確認叢集設定檔中 registryMirrors 下方的設定有效,然後再試一次。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000089:無法更新節點存取權

這表示更新節點存取權時發生錯誤。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000090:無法計算 bmctl 更新中的差異

這表示在執行 bmctl update 指令時,系統在計算 YAML 叢集設定檔與叢集中實際設定之間的差異時發生錯誤。

如要解決這個問題,您可以執行 bmctl get config,取得叢集中的即時設定,並在 bmctl 外部手動執行與 YAML 叢集設定檔的差異比較。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000091:控制台提示輸入內容無效

提供給控制台提示的輸入內容無效。

輸入 yes 或 no。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000092:無法建立叢集專屬命名空間

建立叢集的第一步,是為新叢集建立專屬命名空間。新叢集幾乎所有資源都儲存在這個命名空間中。

這項錯誤表示系統嘗試確保這類叢集專屬命名空間存在 (建立新的命名空間或單純檢查是否存在),但失敗了。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E000097:叢集已暫停

這項錯誤表示目標叢集有 cluster.x-k8s.io/paused 註解,因此無法繼續執行作業。

如要解決這個問題,請移除註解來取消暫停叢集,或使用 --skip-paused-annotation-check 旗標略過這項檢查。

如要進一步瞭解特定錯誤,請查看指令傳回的包裝錯誤。

E300000:偵測到孤立容器

這表示我們透過節點問題偵測工具,在節點上偵測到孤立容器。

孤立容器是指不再主動執行或運作,但仍處於部分清除或不一致狀態的容器程序。

如要查看完整記錄,請在有問題的節點上執行下列指令:

journalctl -u node-problem-detector

根據錯誤訊息中的孤立容器詳細資料,擷取容器 ID。

使用下列指令,從節點中移除孤立容器:

crictl stop <container-id>

crictl rm <container-id>

如果上述指令無法移除孤立容器,則必須停止每個容器的程序。您可以使用下列指令,擷取每個容器的程序 ID 或 PID,並停止容器。

crictl inspect <container-id> | grep pid

kill -9 <pid>

後續步驟

如果您已按照修正措施指南操作,但錯誤仍持續發生,請與技術支援團隊聯絡。

如要進一步瞭解如何排解叢集問題,請參閱下列資源:

裸機適用的 Google Distributed Cloud

Google Distributed Cloud for VMware