Installer l’informateur Kubernetes Visibility Agent (KVA)

Vous pouvez installer Agent de visibilité Kubernetes Informer à l’aide d’un graphique Helm ou du Kubernetes fichier YAML.

Avant de commencer

Rôle requis : aucun

Pourquoi et quand exécuter cette tâche

Cette procédure décrit le processus d’installation standard Agent de visibilité Kubernetes de l’informateur. En règle générale, vous utiliseriez un graphique en barres pour effectuer l’installation, mais vous pouvez également configurer et exécuter le fichier YAML fourni par ServiceNow.Kubernetes

Procédure

Installez Agent de visibilité Kubernetes l’informateur à l’aide d’un graphique en barres ou du Kubernetes fichier YAML fourni par ServiceNow.

• Installez Agent de visibilité Kubernetes l’informateur à l’aide d’un graphique en barres.

  1. Modifiez la commande d’installation Helm.
     1. Dans la commande suivante, remplacez NAMESPACE, INSTANCE_NAME et CLUSTER_NAME par les valeurs pertinentes et remplacez le HELM_URL par l’URL de la version la plus récente, fournie dans l’article Helm Chart de Kubernetes Visibility Agent (anciennement CNO for Visibility) et Kubernetes file YAML releases [KB1564347] de la Now Support base de connaissances.

        helm install -n NAMESPACE --set acceptEula=Y --set instance.name=INSTANCE_NAME --set clusterName="CLUSTER_NAME" {--set image.repository=COMPANY_REPO --set image.tag=COMPANY_TAG} {--set proxyUrl=http://proxy_host:proxy_port} k8s-informer HELM_URL

        Remarque :

        • Les accolades indiquent que les segments de code qu’elles entourent sont facultatifs. Utilisez ces segments de code si l’image doit être extraite du référentiel d’images de votre organisation ou si le trafic sortant de votre cluster passe par un proxy.
        • En transmettant --set acceptEula=Y, vous acceptez le contrat de licence de l’utilisateur final. Vous pouvez lire le contrat de licence de l’utilisateur final en extrayant le EULA.pdf de informer-helm-<VERSION_NUMBER>.tgz.
        • Si l’informateur est installé dans OpenShift, ajoutez le openShift paramètre à la commande et définissez-le sur true :

          helm install -n NAMESPACE --set acceptEula=Y --set instance.name=INSTANCE_NAME --set clusterName="CLUSTER_NAME" {--set image.repository=COMPANY_REPO --set image.tag=COMPANY_TAG} {--set proxyUrl=http://proxy_host:proxy_port} {--set openShift=true} k8s-informer HELM_URL

          Remarque :

          Si l’informateur n’est pas installé dans OpenShift, il n’est pas nécessaire de définir ce paramètre.
        • Si vous utilisez des cartes de services hybrides pour mapper des ressources à l’intérieur et à l’extérieur du cluster Kubernetes, définissez les paramètres suivants :

          --set bringIngressAddresses=true --set bringNodeExternalIPs=true --set discoverK8sServiceExternalIps=true --set openShift=true

     2. Dans la commande, configurez des paramètres supplémentaires selon vos besoins :
        • Configurer la limite de mémoire du pod de l’informateur
        • Modifier la fréquence de découverte complète dans Agent de visibilité Kubernetes
        • Désactiver la découverte continue dans Agent de visibilité Kubernetes
        • Supprimez les changements fréquents dans la Kubernetes grappe pour réduire la charge sur votre instance. Lorsque cette fonctionnalité est active, l’informateur ne signale pas à l’instance les changements supérieurs au taux de seuil configuré. Pour plus d’informations, consultez l’article Suppression des changements fréquents dans les clusters Kubernetes signalés par Kubernetes Visibility Agent (anciennement CNO pour Visibilité) [KB1580745] dans la Now Support base de connaissances.
        • Contrôlez le nombre maximal de découvertes complètes que les informateurs peuvent exécuter sur plusieurs grappes en même temps. Pour plus d’informations, consultez l’article Planification des découvertes complètes dans Kubernetes Visibility Agent (anciennement CNO for Visibility) [KB1580250] dans la Now Support base de connaissances.
        • Activation des cartes de service d’application
  2. Exécutez la commande.
• Installez Agent de visibilité Kubernetes l’informateur à l’aide du Kubernetes fichier YAML.
  1. Téléchargez le Kubernetes fichier zip YAML fourni dans le graphique en barres de Kubernetes Visibility Agent (anciennement CNO pour Visibilité) et le fichier Kubernetes YAML versions l’article [KB1564347] dans la Now Support base de connaissances.
  2. Extrayez les fichiers k8s_informer.yaml et EULA.pdf du fichier zip.
  3. Modifiez le fichier k8s_informer.yaml.
     • Remplacez la valeur de ACCEPT_EULA par « Y », comme suit :

       - name: ACCEPT_EULA
         value: "Y"

       Remarque :

       En changeant la valeur en « O », vous acceptez le contrat de licence de l’utilisateur final inclus dans le fichier EULA.pdf.
     • Remplacez toutes les occurrences de <NAMESPACE> par l’espace de noms dans lequel vous souhaitez installer l’informateur.
     • Remplacez toutes les occurrences de <INSTANCE_NAME> par le nom de votre instance, sans le nom de domaine.
     • Remplacez <CLUSTER_NAME> par le nom de votre cluster tel qu’il apparaît dans le CMDB.
     • Si l’informateur est installé dans OpenShift, modifiez la valeur de la variable d’environnement OPENSHIFT sur true.
     • Activation des cartes de service d’application
  4. Si vous utilisez des cartes de services hybrides pour mapper des ressources à l’intérieur et à l’extérieur du cluster Kubernetes, définissez les paramètres suivants :

     - name: BRING_INGRESS_ADDRESSES value: "true" - name: BRING_NODE_EXTERNAL_IPS value: "true" - name: DISCOVER_K8S_SERVICE_EXTERNAL_IP value: "true" - name: OPENSHIFT value: "true" 

  5. Exécutez la commande suivante :

     kubectl apply -f k8s_informer.yaml

Résultats

Agent de visibilité Kubernetes est déployé sur le Kubernetes cluster et commence à diffuser des données dans votre instance.

Que faire ensuite

Pour plus d’informations sur Agent de visibilité Kubernetes l’administration et le dépannage, consultez l’article Administration et dépannage de l’agent de visibilité Kubernetes (anciennement CNO for Visibility) [KB1532614] dans la Now Support base de connaissances.

• Configurer la limite de mémoire du pod de l’informateur
  Définissez la limite de mémoire du Agent de visibilité Kubernetes pod Informateur.
• Modifier la fréquence de découverte complète dans Agent de visibilité Kubernetes
  Personnalisez la fréquence à laquelle vous souhaitez que l’informateur Agent de visibilité Kubernetes exécute une découverte complète.
• Désactiver la découverte continue dans Agent de visibilité Kubernetes
  Désactivez la découverte continue par Agent de visibilité Kubernetes si vous n’avez besoin que d’instantanés périodiques des ressources de votre cluster. Si vous avez plusieurs clusters avec des changements fréquents, la désactivation de la découverte continue réduit la charge sur votre instance.
• Afficher la version de la grappe dans le KubernetesCMDB
  Faites en sorte que l’informateur Agent de visibilité Kubernetes remplisse le champ approprié dans le CI cmdb_ci_kubernetes_cluster pour afficher la version de la Kubernetes grappe.
• Créer un CI cmdb_ci_linux_server pour chaque Kubernetes nœud
  Configurez si vous souhaitez que l’informateur Agent de visibilité Kubernetes crée un CI cmdb_ci_linux_server pour chaque Kubernetes nœud.
• Conserver les CI d’espace de noms inactifs pour les audits
  Si les normes de votre entreprise l’exigent, conservez les éléments de configuration (CI) d’espace de noms inactifs à des fins de référence et d’audit, avec la possibilité de les supprimer manuellement ultérieurement.
• Définir des listes d’inclusion et d’exclusion d’étiquettes et d’annotations
  Dans Agent de visibilité Kubernetes, définissez, incluez et excluez des listes d’étiquettes et d’annotations dans Kubernetes les ressources que l’informateur extrait dans le Base de données de gestion des configurations (CMDB).
• Ajouter des étiquettes et des annotations personnalisées aux Kubernetes ressources
  Ajoutez des étiquettes et des annotations personnalisées à toutes les ressources déployées dans Agent de visibilité Kubernetes la Kubernetes grappe.
• Mettre à niveau Agent de visibilité Kubernetes les informateurs à distance
  Mettez à niveau Agent de visibilité Kubernetes les pods de l’informateur dans Kubernetes des grappes à distance à partir de l’instance ServiceNow pour éviter de dépendre de votre Kubernetes administrateur. Vous pouvez mettre à niveau un ou plusieurs informateurs.
• Remplacer les paramètres de l’informateur de l’instance
  Contrôlez Agent de visibilité Kubernetes les paramètres d’exécution de l’informateur à partir de l’instance ServiceNow pour éviter de dépendre de votre Kubernetes administrateur.