View a markdown version of this page

Buat kemampuan Argo CD menggunakan CLI AWS - Amazon EKS
PrasyaratLangkah 1: Buat peran kemampuan IAMLangkah 2: Buat kemampuan Argo CDLangkah 3: Verifikasi kemampuan aktifLangkah 4: Verifikasi sumber daya kustom tersediaLangkah selanjutnya

Bantu tingkatkan 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 Edit halaman ini pada GitHub tautan 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.

Buat kemampuan Argo CD menggunakan CLI AWS

Buat kemampuan Argo CD di cluster Amazon EKS Anda menggunakan AWS CLI. Prosedur ini memandu Anda melalui pembuatan peran IAM, mengonfigurasi integrasi Pusat AWS Identitas, dan memverifikasi kemampuan aktif.

Prasyarat

  • AWS CLI — Versi 2.12.3 atau yang lebih baru. Untuk memeriksa versi Anda, jalankanaws --version. Untuk informasi selengkapnya, lihat Menginstal di Panduan Pengguna Antarmuka Baris AWS Perintah.

  • kubectl— Alat baris perintah untuk bekerja dengan cluster Kubernetes. Untuk informasi selengkapnya, lihat Mengatur kubectl dan eksctl.

  • AWS Pusat Identitas dikonfigurasi - Argo CD memerlukan Pusat AWS Identitas untuk otentikasi. Pengguna lokal tidak didukung. Jika Anda belum menyiapkan Pusat AWS Identitas, lihat Memulai dengan Pusat AWS Identitas untuk membuat instance Pusat Identitas, dan Menambahkan pengguna dan Menambahkan grup untuk membuat pengguna dan grup untuk akses CD Argo.

Langkah 1: Buat peran kemampuan IAM

Buat file kebijakan kepercayaan:

cat > argocd-trust-policy.json << 'EOF'
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "capabilities.eks.amazonaws.com"
      },
      "Action": [
        "sts:AssumeRole",
        "sts:TagSession"
      ]
    }
  ]
}
EOF

Buat peran IAM:

aws iam create-role \
  --role-name ArgoCDCapabilityRole \
  --assume-role-policy-document file://argocd-trust-policy.json
catatan

Jika Anda berencana untuk menggunakan integrasi opsional dengan AWS Secrets Manager atau AWS CodeConnections, tambahkan izin ke peran. Untuk contoh kebijakan IAM dan panduan konfigurasi, lihat Kelola rahasia aplikasi dengan AWS Secrets Manager danConnect ke repositori Git dengan AWS CodeConnections.

Langkah 2: Buat kemampuan Argo CD

Buat sumber daya kemampuan Argo CD di cluster Anda.

Pertama, atur variabel lingkungan untuk konfigurasi Pusat Identitas Anda:

# Get your Identity Center instance ARN (replace region if your IDC instance is in a different region)
export IDC_INSTANCE_ARN=$(aws sso-admin list-instances --region region-code --query 'Instances[0].InstanceArn' --output text)

# Get a user ID for RBAC mapping (replace with your username and region if needed)
export IDC_USER_ID=$(aws identitystore list-users \
  --region region-code \
  --identity-store-id $(aws sso-admin list-instances --region region-code --query 'Instances[0].IdentityStoreId' --output text) \
  --query 'Users[?UserName==your-username].UserId' --output text)

echo "IDC_INSTANCE_ARN=$IDC_INSTANCE_ARN"
echo "IDC_USER_ID=$IDC_USER_ID"

Buat kemampuan dengan integrasi Pusat Identitas. Ganti region-code dengan AWS Wilayah tempat klaster Anda berada, my-cluster dengan nama cluster Anda, dan idc-region-code dengan kode wilayah tempat instance Pusat Identitas Anda berada:

aws eks create-capability \
  --region region-code \
  --cluster-name my-cluster \
  --capability-name my-argocd \
  --type ARGOCD \
  --role-arn arn:aws:iam::$(aws sts get-caller-identity --query Account --output text):role/ArgoCDCapabilityRole \
  --delete-propagation-policy RETAIN \
  --configuration '{
    "argoCd": {
      "awsIdc": {
        "idcInstanceArn": "'$IDC_INSTANCE_ARN'",
        "idcRegion": "'[.replaceable]`idc-region-code`'"
      },
      "rbacRoleMappings": [{
        "role": "ADMIN",
        "identities": [{
          "id": "'$IDC_USER_ID'",
          "type": "SSO_USER"
        }]
      }]
    }
  }'

Perintah segera kembali, tetapi kemampuannya membutuhkan waktu untuk menjadi aktif karena EKS menciptakan infrastruktur dan komponen kemampuan yang diperlukan. EKS menginstal Kubernetes Custom Resource Definitions (CRD) di klaster Anda selama pembuatan kemampuan.

catatan

Jika Anda menerima kesalahan bahwa klaster tidak ada atau Anda tidak memiliki izin, verifikasi:

  • Nama cluster benar

  • AWS CLI Anda dikonfigurasi untuk wilayah yang benar

  • Anda memiliki izin IAM yang diperlukan

Langkah 3: Verifikasi kemampuan aktif

Tunggu kemampuan untuk menjadi aktif. Ganti region-code dengan AWS Wilayah tempat klaster Anda berada dan my-cluster dengan nama cluster Anda.

aws eks describe-capability \
  --region region-code \
  --cluster-name my-cluster \
  --capability-name my-argocd \
  --query 'capability.status' \
  --output text

Kemampuan siap ketika status ditampilkanACTIVE. Tunggu sampai statusnya ACTIVE sebelum Anda melanjutkan ke langkah berikutnya.

Anda juga dapat melihat detail kemampuan lengkap:

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

Langkah 4: Verifikasi sumber daya kustom tersedia

Setelah kemampuan aktif, verifikasi bahwa sumber daya kustom Argo CD tersedia di cluster Anda:

kubectl api-resources | grep argoproj.io

Anda harus melihat Application dan jenis ApplicationSet sumber daya terdaftar.

Langkah selanjutnya