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.

Konfigurasikan pengaturan CD Argo

Dengan Kemampuan EKS untuk Argo CD, Anda mendapatkan pengalaman Argo CD yang dikelola sepenuhnya. Upstream Argo CD menyediakan banyak pengaturan dan fitur opsional, dan Kemampuan EKS untuk Argo CD mendukung sebagian dari mereka. Untuk pengaturan yang didukung, Anda mengkonfigurasinya dengan cara yang sama seperti CD Argo hulu, melalui cluster argocd-cm ConfigMap Anda. AWS membaca bidang yang didukung dari itu ConfigMap dan menerapkannya ke instance CD Argo yang dikelola.

Bagian berikut menjelaskan cara mengonfigur argocd-cm ConfigMap asi pengaturan yang didukung.

Prasyarat

Sebelum Anda mengkonfigurasi pengaturan CD Argo, Anda harus memiliki:

Konfigurasikan argocd-cm ConfigMap

Untuk mengkonfigurasi pengaturan CD Argo yang didukung, buat ConfigMap nama argocd-cm di cluster Anda. Kemampuan terkelola membaca bidang yang didukung dari ini ConfigMap dan menerapkannya ke instance CD Argo yang dikelola. Kemampuan mengabaikan bidang dan fitur yang tidak didukung yang Anda tetapkan. Tinjau daftar bidang yang didukung untuk mengonfirmasi bahwa pengaturan berlaku.

Buat ConfigMap dengan persyaratan berikut:

Contoh berikut menunjukkan ConfigMap struktur:

apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-cm
  namespace: argocd
  labels:
    app.kubernetes.io/part-of: argocd
data:
  # Supported settings go here (see the following sections)

Pengaturan yang didukung

Kemampuan terkelola mendukung argocd-cm bidang berikut:

Pemeriksaan kesehatan khusus

Argo CD menilai kesehatan sumber daya yang disebarkannya. Untuk sumber daya Kubernetes standar seperti Deployments and Services, Argo CD memiliki logika kesehatan bawaan. Untuk Sumber Daya Kustom yang tidak dikenali oleh Argo CD, tidak memiliki logika kesehatan bawaan dan tidak melaporkan status kesehatan.

Ketika Sumber Daya Kustom tidak memiliki pemeriksaan kesehatan, Argo CD tidak melaporkan kesehatan untuk itu dan mengecualikannya dari kesehatan Aplikasi secara keseluruhan. Akibatnya, Aplikasi dapat melaporkan Healthy bahkan ketika sumber dayanya masih disediakan atau gagal. Ini juga berarti bahwa gelombang sinkronisasi dapat maju sebelum sumber daya tersebut siap, karena urutan sinkronisasi tergantung pada kesehatan yang dilaporkan.

Dengan pemeriksaan kesehatan khusus, Anda dapat menentukan logika kesehatan untuk Sumber Daya Kustom Anda, sehingga CD Argo melaporkan penyebaran kesehatan dan urutan yang akurat dengan benar. Anda menentukan pemeriksaan kesehatan khusus dengan cara yang sama seperti yang Anda lakukan di CD Argo hulu, menggunakan kunci konfigurasi yang sama. Skrip hulu dan contoh komunitas yang ada bekerja dengan Kemampuan EKS untuk CD Argo tanpa modifikasi.

Built-in pemeriksaan kesehatan untuk ACK dan kro

Kapabilitas EKS untuk CD Argo mencakup pemeriksaan kesehatan bawaan untuk sumber daya Peng AWS ontrol untuk Kubernetes (ACK) dan kro (Kube Resource Orchestrator). Sumber daya ini melaporkan kesehatan yang akurat tanpa konfigurasi tambahan.

Untuk mengubah cara kemampuan menilai kesehatan sumber daya ACK atau kro, Anda dapat menentukan pemeriksaan kesehatan khusus untuk jenis sumber daya tersebut. Pemeriksaan kesehatan khusus yang Anda tetapkan untuk jenis sumber daya menggantikan pemeriksaan kesehatan bawaan untuk jenis tersebut.

Tulis pemeriksaan kesehatan khusus

Tentukan pemeriksaan kesehatan khusus dengan menambahkan skrip Lua ke argocd-cm ConfigMap, menggunakan kunci dalam format berikut:

resource.customizations.health.<group>_<kind>

Ganti <group> dengan grup API dari Sumber Daya Kustom dan <kind> dengan jenisnya. Misalnya, kunci untuk Sumber Daya Kustom dengan grup API example.com dan jenisnya Database adalahresource.customizations.health.example.com_Database.

Script Lua memiliki akses ke objek sumber daya melalui obj variabel global. Skrip harus mengembalikan tabel dengan status bidang yang disetel ke salah satu dariHealthy,Progressing,Degraded, atauSuspended. Script juga dapat mengatur message bidang opsional untuk memberikan pesan status deskriptif.

Contoh berikut ConfigMap mendefinisikan pemeriksaan kesehatan untuk Sumber Daya Database Kustom. Skrip melaporkan sumber daya seperti Healthy saat fase statusnyaReady, dan Progressing sebaliknya:

apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-cm
  namespace: argocd
  labels:
    app.kubernetes.io/part-of: argocd
data:
  resource.customizations.health.example.com_Database: |
    hs = {}
    hs.status = "Progressing"
    hs.message = "Waiting for the resource to become ready"
    if obj.status ~= nil then
      if obj.status.phase == "Ready" then
        hs.status = "Healthy"
        hs.message = "Database is ready"
      end
    end
    return hs

Untuk informasi selengkapnya tentang format skrip pemeriksaan kesehatan, daftar pemeriksaan kesehatan bawaan, dan contoh komunitas yang dapat Anda adaptasi, lihat Resource Health di situs dokumentasi Argo CD.

Keamanan dan keterbatasan

Dengan kemampuan terkelola, skrip pemeriksaan kesehatan kustom Anda berjalan dalam komputasi terisolasi dan dikelola sepenuhnya. Lingkungan eksekusi diisolasi per kemampuan dan tidak memiliki akses ke data cluster Anda atau ke AWS API. Anda tidak menyediakan, menambal, atau mengoperasikan bagian mana pun dari lingkungan eksekusi.

Perhatikan hal berikut saat Anda menulis pemeriksaan kesehatan khusus untuk digunakan dengan Kemampuan EKS:

Jika evaluasi kesehatan sementara tidak tersedia, laporan kemampuan mempengaruhi Sumber Daya Khusus sebagai Progressing bukannya menghapus status kesehatannya. Ini membuat sumber daya yang terpengaruh terlihat dalam kesehatan Aplikasi sampai evaluasi pulih.

Verifikasi pemeriksaan kesehatan khusus

Setelah Anda menerapkan atau memperbarui argocd-cm ConfigMap, konfirmasikan bahwa pemeriksaan kesehatan aktif: