Aidez à améliorer cette page

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Pour contribuer à ce guide de l'utilisateur, cliquez sur le GitHub lien Modifier cette page qui se trouve dans le volet droit de chaque page.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configuration des paramètres d'Argo CD

La fonctionnalité EKS pour Argo CD fournit une expérience Argo CD entièrement gérée. Upstream Argo CD propose de nombreux paramètres et fonctionnalités optionnels, et cette fonctionnalité prend en charge un sous-ensemble d'entre eux. Pour les paramètres pris en charge, vous les configurez de la même manière qu'Argo CD en amont, via l'interface argocd-cm ConfigMap de votre cluster. La fonctionnalité lit les champs pris en charge à partir de celui-ci ConfigMap et les applique à l'instance Argo CD gérée.

Les sections suivantes décrivent comment configurer les argocd-cm ConfigMap paramètres pris en charge.

Conditions préalables

Avant de configurer les paramètres d'Argo CD, vous devez disposer des éléments suivants :

Configurez l'argocd-cm ConfigMap

Pour configurer les paramètres Argo CD pris en charge, créez un ConfigMap nom argocd-cm dans votre cluster. La fonctionnalité gérée lit les paramètres pris en charge à partir de celui-ci ConfigMap et les applique à l'instance Argo CD gérée. Pour connaître les paramètres pris en charge par cette fonctionnalité et la manière dont elle les applique, consultezParamètres pris en charge.

Créez le ConfigMap avec les exigences suivantes :

L'exemple suivant montre la ConfigMap structure, avec un paramètre qui affiche une bannière sur l'interface utilisateur d'Argo CD. Ajoutez d'autres paramètres pris data en charge ci-dessous de la même manière.

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

Comment la fonctionnalité applique vos paramètres

Vous configurez Argo CD en créant un argocd-cm ConfigMap dans votre propre cluster. Cette fonctionnalité applique les paramètres pris en charge de votre instance Argo CD ConfigMap à l'instance gérée. Il applique uniquement les paramètres pris en charge et ignore tout autre champ ou fonctionnalité que vous définissez. Tout paramètre qui n'est pas répertorié dans n'Paramètres pris en chargeest pas pris en charge et n'a aucun effet.

Cette fonctionnalité valide les valeurs que vous définissez. Si une valeur n'est pas valide ou mal formée, la fonctionnalité ignore cette valeur et continue de fonctionner avec sa configuration par défaut pour ce paramètre. Une erreur dans votre instance Argo CD gérée ConfigMap n'est pas interrompue.

Paramètres pris en charge

Les sections suivantes répertorient les argocd-cm paramètres pris en charge par la fonctionnalité gérée, regroupés par catégorie. Chaque réglage utilise la même clé et le même format que l'Argo CD en amont. La colonne Comment votre valeur est appliquée de chaque tableau indique si votre valeur ajoute ou remplace la configuration par défaut de la fonctionnalité. Pour une description complète de chaque paramètre, consultez la ConfigMap référence argocd-cm sur le site Web de documentation d'Argo CD.

Interface utilisateur

Ces paramètres personnalisent l'interface utilisateur d'Argo CD.

Paramètres des ressources

Ces paramètres contrôlent la manière dont la fonctionnalité surveille, compare et affiche les ressources gérées par Argo CD.

Paramètres du référentiel et des outils

Ces paramètres contrôlent les outils de manifeste qu'Argo CD utilise pour afficher vos manifestes.

Drapeaux Kustomize.buildOptions pris en charge

Pourkustomize.buildOptions, la fonctionnalité filtre votre valeur selon un ensemble d'indicateurs sûrs et pris en charge. Il ne prend pas en charge les indicateurs qui permettent à la compilation de lire des fichiers arbitraires ou d'exécuter du code arbitraire. Il supprime individuellement tout indicateur non pris en charge ou toute valeur non valide et applique les autres indicateurs pris en charge. Vous pouvez écrire des drapeaux au --flag=value format --flag value ou.

La fonctionnalité supprime tout autre indicateur, y compris --load-restrictor--enable-exec, et--enable-alpha-plugins.

Surveillances d'état personnalisées

Argo CD évalue l'état des ressources qu'il déploie. Pour les ressources Kubernetes standard telles que les déploiements et les services, Argo CD intègre une logique de santé. Pour les ressources personnalisées qu'Argo CD ne reconnaît pas, il n'a pas de logique de santé intégrée et ne signale aucun état de santé.

Lorsqu'une ressource personnalisée ne fait l'objet d'aucun bilan de santé, Argo CD ne signale aucun état de santé pour elle et l'exclut de l'état général de l'application. Par conséquent, une application peut signaler Healthy même si ses ressources sont toujours en cours d'approvisionnement ou en panne. Cela signifie également que les vagues de synchronisation peuvent avancer avant que ces ressources ne soient prêtes, car l'ordre de synchronisation dépend de l'état de santé déclaré.

Grâce à des bilans de santé personnalisés, vous pouvez définir une logique d'intégrité pour vos ressources personnalisées, afin qu'Argo CD affiche un état de santé précis et séquence correctement les déploiements. Vous définissez des bilans de santé personnalisés de la même manière que dans Argo CD en amont, à l'aide des mêmes clés de configuration. Les scripts en amont et les exemples communautaires existants fonctionnent avec la fonctionnalité EKS pour Argo CD sans modification.

Built-in bilans de santé pour ACK et kro

La fonctionnalité EKS pour Argo CD inclut des contrôles de santé intégrés pour les ressources AWS Controllers for Kubernetes (ACK) et kro (Kube Resource Orchestrator). Ces ressources indiquent un état de santé précis sans configuration supplémentaire.

Pour modifier la façon dont la fonctionnalité évalue l'état d'une ressource ACK ou KRO, vous pouvez définir un bilan de santé personnalisé pour ce type de ressource. Un bilan de santé personnalisé que vous définissez pour un type de ressource remplace le bilan de santé intégré pour ce type.

Rédiger un bilan de santé personnalisé

Définissez un bilan de santé personnalisé en ajoutant un script Lua au argocd-cm ConfigMap, à l'aide d'une clé au format suivant :

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

<group>Remplacez-le par le groupe d'API de la ressource personnalisée et <kind> par son type. Par exemple, la clé d'une ressource personnalisée avec le groupe d'API example.com et le type Database estresource.customizations.health.example.com_Database.

Le script Lua a accès à l'objet ressource via la obj variable globale. Le script doit renvoyer une table dont status le champ est défini sur l'une des Healthy valeurs Progressing suivantes :Degraded, ouSuspended. Le script peut également définir un message champ facultatif pour fournir un message d'état descriptif.

L'exemple suivant ConfigMap définit un bilan de santé pour une ressource Database personnalisée. Le script indique la ressource au Healthy moment où se trouve sa phase d'étatReady, et dans le Progressing cas contraire :

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

Pour plus d'informations sur le format de script de contrôle de santé, la liste des bilans de santé intégrés et des exemples communautaires que vous pouvez adapter, consultez Resource Health sur le site Web de documentation d'Argo CD.

Sécurité et limites

Grâce à la fonctionnalité gérée, vos scripts de contrôle de santé personnalisés s'exécutent dans un environnement informatique isolé et entièrement géré. L'environnement d'exécution est isolé par fonctionnalité et n'a pas accès aux données de votre cluster ni aux AWS API. Vous ne provisionnez, ne corrigez ni n'exploitez aucune partie de l'environnement d'exécution.

Lorsque vous rédigez des bilans de santé personnalisés à utiliser avec la fonctionnalité EKS, tenez compte des points suivants :

Si l'évaluation de l'état de santé est temporairement indisponible, les rapports de capacité ont affecté les ressources personnalisées Progressing au lieu de supprimer leur état de santé. Cela permet de garder les ressources affectées visibles dans l'état de santé de l'application jusqu'à la reprise de l'évaluation.

Vérifier un bilan de santé personnalisé

Après avoir appliqué ou mis à jour le argocd-cm ConfigMap, confirmez que le bilan de santé est actif :