Bantu meningkatkan halaman ini

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Untuk berkontribusi pada panduan pengguna ini, pilih GitHub tautan Edit halaman ini di yang terletak di panel kanan setiap halaman.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Pemecahan Masalah Kemampuan EKS

Pendekatan pemecahan masalah umum

Saat memecahkan masalah Kemampuan EKS, ikuti pendekatan umum ini:

Gunakan log pengontrol untuk pemecahan masalah

Jika Anda telah mengonfigurasi pengiriman log pengontrol (lihatAkses log pengontrol Kemampuan EKS), Anda dapat menanyakan log untuk mengidentifikasi kesalahan rekonsiliasi, konflik sumber daya, dan masalah konfigurasi.

Kesalahan kueri di semua pengontrol

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

Filter log untuk pengontrol layanan ACK tertentu

Gunakan controllerGroup bidang untuk mengisolasi log dari pengontrol layanan ACK tertentu:

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

Untuk memfilter lebih lanjut berdasarkan jenis sumber daya (misalnya, hanya SecurityGroup log dari pengontrol EC2):

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

Filter log untuk aplikasi Argo CD tertentu

Gunakan application bidang untuk mengisolasi log untuk aplikasi CD Argo tertentu:

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

Melacak rekonsiliasi untuk sumber daya tertentu

Gunakan reconcileID bidang untuk mengikuti siklus rekonsiliasi tunggal:

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

Pola log umum yang menunjukkan masalah

Periksa kesehatan kemampuan

Semua Kemampuan EKS memberikan informasi kesehatan melalui konsol EKS dan describe-capability API.

Konsol:

Tab Capabilities menunjukkan:

AWS CLI:

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

Respons meliputi:

Status kemampuan umum

MENCIPTAKAN: Kemampuan sedang disiapkan.

AKTIF: Kemampuan berjalan dan siap digunakan. Jika sumber daya tidak berfungsi seperti yang diharapkan, periksa status sumber daya dan izin IAM.

MEMPER BARUI: Perubahan konfigurasi sedang diterapkan. Tunggu status kembali keACTIVE.

CREATE_FAILED atau UP DATE_FAILED: Pengaturan atau pembaruan mengalami kesalahan. Periksa bagian kesehatan untuk detailnya. Penyebab umum:

Verifikasi status sumber daya Kubernetes

Kapabilitas EKS membuat dan mengelola Kubernetes Custom Resource Definitions (CRD) di cluster Anda. Saat memecahkan masalah, periksa status sumber daya yang Anda buat:

# 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
      

Kondisi status sumber daya memberikan informasi tentang:

Tinjau izin IAM dan akses cluster

Banyak masalah kemampuan berasal dari masalah izin IAM atau konfigurasi akses cluster yang hilang. Verifikasi izin Peran Kemampuan dan entri akses cluster.

Periksa izin peran IAM

Verifikasi Peran Kemampuan memiliki izin yang diperlukan:

# 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'

Kebijakan kepercayaan harus mengizinkan prinsi capabilities.eks.amazonaws.com pal layanan:

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

Periksa Entri Akses EKS dan Kebijakan Akses

Semua kemampuan memerlukan Entri Akses EKS yang tepat dan Kebijakan Akses pada cluster tempat mereka beroperasi.

Verifikasi Entri Akses ada:

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

Cari Peran Kemampuan ARN dalam daftar. Jika hilang, kemampuan tidak dapat mengakses cluster.

Periksa Kebijakan Akses yang dilampirkan pada entri:

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

Semua kemampuan memerlukan Kebijakan Akses yang sesuai:

Untuk penerapan multi-cluster Argo CD:

Jika menerapkan ke cluster jarak jauh, verifikasi Peran Kemampuan memiliki Entri Akses pada setiap cluster target:

# 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
         

Jika Entri Akses hilang pada cluster target, Argo CD tidak dapat menyebarkan aplikasi ke kluster target. Lihat Daftarkan kluster target untuk detail konfigurasi.

Capability-specific pemecahan masalah

Untuk panduan pemecahan masalah terperinci khusus untuk setiap jenis kemampuan:

Masalah umum di semua kemampuan

Kemampuan terjebak dalam keadaan CREATING

Jika kemampuan tetap dalam CREATING keadaan lebih lama dari yang diharapkan:

Sumber daya tidak dibuat atau diperbarui

Jika kemampuan ACTIVE tetapi sumber daya tidak dibuat atau diperbarui:

Kesehatan kemampuan menunjukkan masalah

Jika describe-capability menunjukkan masalah kesehatan:

Langkah selanjutnya