協助改進此頁面

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

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

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

設定 Argo CD 設定

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

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

先決條件

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

設定 argocd-cm ConfigMap

若要設定支援的 Argo CD 設定，請在叢集argocd-cm中建立名為 的 ConfigMap。受管功能會從此 ConfigMap 讀取支援的設定，並將其套用至受管 Argo CD 執行個體。如需 功能支援的設定及其套用方式，請參閱 支援的設定。

建立具有下列需求的 ConfigMap：

下列範例顯示 ConfigMap 結構，其設定會在 Argo CD UI 上顯示橫幅。data 以相同方式新增 下的其他支援設定。

apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-cm
  namespace: argocd
  labels:
    app.kubernetes.io/part-of: argocd
data:
  ui.bannercontent: "Production cluster"

功能如何套用您的設定

您可以在自己的叢集中建立 argocd-cm ConfigMap 來設定 Argo CD。此功能會將 ConfigMap 中支援的設定套用至受管 Argo CD 執行個體。它只會套用支援的設定，並忽略您設定的任何其他欄位或功能。任何未列在 中的設定支援的設定都不受支援，而且沒有任何效果。

該功能會驗證您設定的值。如果值無效或格式不正確，則 功能會忽略該值，並繼續執行該設定的預設組態。ConfigMap 中的錯誤不會破壞您的受管 Argo CD 執行個體。

支援的設定

下列各節列出 受管功能支援的argocd-cm設定，依類別分組。每個設定都使用與上游 Argo CD 相同的金鑰和格式。每個資料表的套用值方式欄會顯示您的值是否附加至或覆寫功能的預設組態。如需每個設定的完整說明，請參閱 Argo CD 文件網站上的 argocd-cm ConfigMap 參考。

使用者界面

這些設定會自訂 Argo CD UI。

資源設定

這些設定控制功能如何監看、比較和顯示 Argo CD 管理的資源。

儲存庫和工具設定

這些設定控制 Argo CD 用來轉譯資訊清單的資訊清單工具。

支援的 kustomize.buildOptions 旗標

對於 kustomize.buildOptions， 功能會將您的值篩選為一組安全、支援的旗標。它不支援允許組建讀取任意檔案或執行任意程式碼的旗標。它會個別捨棄任何不支援的旗標或無效的值，並套用其餘支援的旗標。您可以撰寫 --flag value或 --flag=value形式的旗標。

此功能會捨棄任何其他旗標，包括 --load-restrictor、 --enable-exec和 --enable-alpha-plugins。

自訂運作狀態檢查

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 之後，請確認運作狀態檢查為作用中：