協助改進此頁面

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

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

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

設定 Argo CD 設定

透過適用於 Argo CD 的 EKS 功能，您可以獲得全受管 Argo CD 體驗。上游 Argo CD 提供許多選用的設定和功能，而適用於 Argo CD 的 EKS 功能支援其中一部分。對於支援的設定，您可以透過叢集中的 argocd-cm ConfigMap 以與上游 Argo CD 相同的方式進行設定。 會從該 ConfigMap AWS 讀取支援的欄位，並將其套用至受管 Argo CD 執行個體。

下列各節說明如何為支援的設定設定設定 argocd-cm ConfigMap。

先決條件

設定 Argo CD 設定之前，您必須擁有：

設定 argocd-cm ConfigMap

若要設定支援的 Argo CD 設定，請在叢集argocd-cm中建立名為 的 ConfigMap。受管功能會從此 ConfigMap 讀取支援的欄位，並將其套用至受管 Argo CD 執行個體。此功能會忽略您設定的任何不支援的欄位和功能。檢閱支援的欄位清單，確認設定生效。

建立具有下列需求的 ConfigMap：

下列範例顯示 ConfigMap 結構：

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)

支援的設定

受管功能支援下列argocd-cm欄位：

自訂運作狀態檢查

Argo CD 會評估其部署之資源的運作狀態。對於 部署和服務等標準 Kubernetes 資源，Argo CD 具有內建的運作狀態邏輯。對於 Argo CD 無法辨識的自訂資源，它沒有內建的運作狀態邏輯，也不會報告運作狀態。

當自訂資源沒有運作狀態檢查時，Argo CD 會報告沒有運作狀態，並將其排除在應用程式的整體運作狀態之外。因此，應用程式可以報告Healthy，即使其資源仍在佈建或失敗。這也表示同步波可以在這些資源就緒之前進行，因為同步排序取決於報告的運作狀態。

透過自訂運作狀態檢查，您可以定義自訂資源的運作狀態邏輯，因此 Argo CD 會正確報告準確的運作狀態和序列部署。您可以使用相同的組態金鑰，以您在上游 Argo CD 中相同的方式定義自訂運作狀態檢查。現有的上游指令碼和社群範例適用於 Argo CD 的 EKS 功能，無需修改。

ACK 和 kro 的內建運作狀態檢查

Argo CD 的 EKS 功能包含 AWS Kubernetes (ACK) 和 kro (Kube Resource Orchestrator) 資源控制器的內建運作狀態檢查。這些資源會報告準確的運作狀態，無需額外的組態。

若要變更 功能如何評估 ACK 或 kro 資源的運作狀態，您可以定義該資源類型的自訂運作狀態檢查。您為資源類型定義的自訂運作狀態檢查會覆寫該類型的內建運作狀態檢查。

撰寫自訂運作狀態檢查

使用下列格式的金鑰，將 Lua 指令碼新增至 argocd-cm ConfigMap 來定義自訂運作狀態檢查：

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

以自訂資源的 API 群組取代 <group>，並以其類型取代 <kind>。例如，具有 API 群組example.com和種類的自訂資源的金鑰Database為 resource.customizations.health.example.com_Database。

Lua 指令碼可透過 全域obj變數存取資源物件。指令碼必須傳回 欄位status設定為 Healthy、Degraded、 Progressing或 之一的資料表Suspended。指令碼也可以設定選用message欄位，以提供描述性狀態訊息。

下列範例 ConfigMap 會定義Database自訂資源的運作狀態檢查。當資源的狀態階段為 Healthy時Ready，指令碼會回報資源，Progressing否則會回報資源：

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

如需運作狀態檢查指令碼格式、內建運作狀態檢查清單，以及您可以調整的社群範例的詳細資訊，請參閱 Argo CD 文件網站上的 Resource Health。

安全與限制

透過 受管功能，您的自訂運作狀態檢查指令碼會在隔離、全受管的運算中執行。每個功能都會隔離執行環境，而且無法存取叢集的資料或 AWS APIs。您不會佈建、修補或操作執行環境的任何部分。

當您撰寫自訂運作狀態檢查以搭配 EKS 功能使用時，請注意下列事項：

如果運作狀態評估暫時無法使用， 功能會報告受影響的自訂資源，Progressing而不是移除其運作狀態。這可讓受影響的資源在應用程式的運作狀態中可見，直到評估復原為止。

驗證自訂運作狀態檢查

套用或更新 argocd-cm ConfigMap 之後，請確認運作狀態檢查為作用中：