協助改進此頁面

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

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

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

對 EKS 功能進行故障診斷

一般疑難排解方法

疑難排解 EKS 功能時，請遵循下列一般方法：

使用控制器日誌進行故障診斷

如果您已設定控制器日誌交付 （請參閱存取 EKS 功能控制器日誌)，您可以查詢日誌以識別對帳錯誤、資源衝突和組態問題。

所有控制器的查詢錯誤

fields @timestamp, controller, message, error
| filter level = "error"
| sort @timestamp desc
| limit 50

篩選特定 ACK 服務控制器的日誌

使用 controllerGroup 欄位隔離日誌與特定 ACK 服務控制器：

fields @timestamp, message, error
| filter controllerGroup = "s3.services.k8s.aws"
| filter level = "error"
| sort @timestamp desc

若要依資源類型進一步篩選 （例如，僅限來自 EC2 控制器的SecurityGroup日誌）：

fields @timestamp, message, error
| filter controllerGroup = "ec2.services.k8s.aws"
| filter controllerKind = "SecurityGroup"
| sort @timestamp desc
| limit 100

篩選特定 Argo CD 應用程式的日誌

使用 application 欄位隔離特定 Argo CD 應用程式的日誌：

fields @timestamp, message, error
| filter application = "my-application"
| sort @timestamp desc
| limit 100

追蹤特定資源的對帳

使用 reconcileID 欄位遵循單一調校週期：

fields @timestamp, level, message, error
| filter reconcileID = "your-reconcile-id"
| sort @timestamp asc

指出問題的常見日誌模式

檢查功能運作狀態

所有 EKS 功能都透過 EKS 主控台和 describe-capability API 提供運作狀態資訊。

主控台：

功能索引標籤會顯示：

AWS CLI：

aws eks describe-capability \
  --region region-code \
  --cluster-name my-cluster \
  --capability-name my-capability-name
      

回應包括：

常見功能狀態

CREATING：正在設定功能。

ACTIVE：功能正在執行並準備好使用。如果資源未如預期般運作，請檢查資源狀態和 IAM 許可。

正在更新：正在套用組態變更。等待狀態傳回 ACTIVE。

CREATE_FAILED 或 UPDATE_FAILED：設定或更新發生錯誤。如需詳細資訊，請參閱運作狀態區段。常見原因：

驗證 Kubernetes 資源狀態

EKS 功能會在叢集中建立和管理 Kubernetes 自訂資源定義 (CRDs)。疑難排解時，請檢查您建立的資源狀態：

# List resources of a specific type
kubectl get resource-kind -A

# Describe a specific resource to see conditions and events
kubectl describe resource-kind
         resource-name -n namespace

# View resource status conditions
kubectl get resource-kind
         resource-name -n namespace -o jsonpath='{.status.conditions}'

# View events related to the resource
kubectl get events --field-selector involvedObject.name=resource-name -n namespace
      

資源狀態條件提供下列相關資訊：

檢閱 IAM 許可和叢集存取

許多功能問題來自 IAM 許可問題或缺少叢集存取組態。驗證功能角色許可和叢集存取項目。

檢查 IAM 角色許可

驗證能力角色具有必要的許可：

# List attached managed policies
aws iam list-attached-role-policies --role-name my-capability-role

# List inline policies
aws iam list-role-policies --role-name my-capability-role

# Get specific policy details
aws iam get-role-policy --role-name my-capability-role --policy-name policy-name

# View the role's trust policy
aws iam get-role --role-name my-capability-role --query 'Role.AssumeRolePolicyDocument'

信任政策必須允許capabilities.eks.amazonaws.com服務主體：

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "capabilities.eks.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

檢查 EKS 存取項目和存取政策

所有功能都需要其操作所在叢集上適當的 EKS 存取項目和存取政策。

驗證存取項目是否存在：

aws eks list-access-entries \
  --cluster-name my-cluster \
  --region region-code
         

在清單中尋找功能角色 ARN。如果遺失，則 功能無法存取叢集。

檢查連接到項目的存取政策：

aws eks list-associated-access-policies \
  --cluster-name my-cluster \
  --principal-arn arn:aws:iam::111122223333:role/my-capability-role \
  --region region-code
         

所有功能都需要適當的存取政策：

針對 Argo CD 多叢集部署：

如果部署到遠端叢集，請確認功能角色在每個目標叢集上有存取項目：

# Check Access Entry on target cluster
aws eks describe-access-entry \
  --cluster-name target-cluster \
  --principal-arn arn:aws:iam::111122223333:role/argocd-capability-role \
  --region region-code
         

如果目標叢集上缺少存取項目，Argo CD 就無法將應用程式部署到其中。如需組態詳細資訊註冊目標叢集，請參閱 。

功能特定的疑難排解

如需每個功能類型特有的詳細故障診斷指引：

所有功能的常見問題

功能卡在 CREATING 狀態

如果功能保持 CREATING 狀態的時間超過預期：

未建立或更新的資源

如果功能是 ，ACTIVE但資源未建立或更新：

功能運作狀態顯示問題

如果 describe-capability 顯示運作狀態問題：

後續步驟