Détection de Kubernetes

Gestion des opérations IT de Yokohama

Release

yokohama

ft:locale

fr-FR

ft:publication_title

Gestion des opérations IT de Yokohama

ft:clusterId

itom

bundleId

itom

workflow

Technology

Détection de Kubernetes

Rversion finale: Yokohama

Mis à jour 30 janv. 2025

27 minutes de lecture

Le ServiceNow Visibilité ITOM recherche Kubernetes et OpenShift composants et crée des services d’application qui les contiennent. Découverte recherche également des Kubernetes événements et les met fréquemment à jour pour CMDB refléter l’environnement dynamique Kubernetes .

Découverteutilise le modèle et ses sections d’extension pour détecter Kubernetes les composants de Kubernetes la Kubernetes version 1.21 :

La Collect OpenShift info section d’extension du Kubernetes modèle détecte les OpenShift composants du Kubernetes déploiement. La OpenShift section d’extension Build Config est disponible à partir de la version 1.0.53 du Store.
L'extension Service Mesh détecte les détails du maillage de service. Ces informations permettent au modèle de créer des relations service-service, affichées sous la forme Connects to::Connected. La découverte de maillage de services nécessite le déploiement d’Istio sur votre cluster K8s (Kubernetes). La section d’extension Service Mesh est disponible depuis les classes d’extension Kubernetes. Il est pris en charge sur la Madrid version ou une Now Platform version ultérieure.
Collect Container Repository et la section d'extension recherchent des registres de conteneurs et des images dans ces registres.

En outre, Découverte utilise le modèle d’événement pour détecter les événements pour Kubernetes les Kubernetes composants des versions Kubernetes 1.21.

À partir de la version ServiceNow Store1.0.68, vous Mappage des services pouvez utiliser des relations CI pour ajouter les composants aux services d’application lors de la détection basée sur les Kubernetes balises.

Découverte utilise les schémas suivants pour détecter l’ensemble de Kubernetes l’infrastructure déployée sur GCP, AWS et Azure :

Google Cloud Platform (GCP) – Obtenez des Kubernetes grappes.
Amazon Web Services (AWS) : obtenir Kubernetes les grappes.
Services de cloud computing Microsoft Azure : obtenir Kubernetes des grappes.

Ces modèles interrogent le cloud, collectent des données sur tous les clusters Kubernetes, et créent un calendrier sans serveur pour chaque cluster. Lorsque la grappe est supprimée, le calendrier est marqué comme inactif. Cette fonctionnalité élimine les frais généraux de création et de gestion de plusieurs informations d'identification et calendriers de détection sans serveur par cluster. Les modèles d'infrastructure dans le cloud sont déclenchés via la détection standard dans le cloud.

Demander des applications dans l'App Store

Visitez le site Web ServiceNow Store pour découvrir toutes les applications disponibles et pour obtenir des informations sur la procédure à suivre pour soumettre des demandes à la boutique. Pour obtenir des informations sur les notes de publication cumulatives pour toutes les applications publiées, consultez les ServiceNow Storenotes de publication relatives à l'historique des versions.

Prérequis

Remarque :

Pour connaître les conditions préalables à Kubernetes la détection d’infrastructure cloud, voir ci-dessous.

Remarque :

L’exécution de calendriers automatiques sans Kubernetes serveur récupère le jeton de porteur. Il n’est pas nécessaire d’ajouter des informations d’identification.

Procédez comme suit pour vous assurer que Découverte vous pouvez utiliser le modèle pour réussir à trouver Kubernetes.

Déployez la dernière version de l'application Discovery and Service Mapping Patterns à partir de ServiceNow Store.
Sur la Kubernetes plateforme, recherchez les paramètres pour configurer Kubernetes la détection :
- Rechercher l'URL du serveur kubeapi :
  1. Sur la Kubernetes plateforme, exécutez la commande suivante :
    kubectl cluster-info
  2. Dans la sortie, recherchez la ligne qui indique l'URL du serveur kubeapi. Par exemple, le Kubernetes plan de contrôle s’exécute à
    https://10.154.144.146:443
- Recherchez les espaces de noms du serveur kubeapi :
  1. Sur la Kubernetes plateforme, exécutez cette commande :
    kubectl get namespaces
  2. Dans la sortie, recherchez la ligne qui indique les espaces de noms. Par exemple, kube-system.
- Trouvez le nom d’utilisateur et le Kubernetes mot de passe :
  1. Sur la Kubernetes plateforme, exécutez cette commande :
    kubectl config view
  2. Dans la sortie, recherchez le nom d'utilisateur et le mot de passe.
    Remarque :
    Si, dans un certain environnement, la commande kubectl config view n’affiche pas les détails attendus, utilisez la commande prise en charge de l’administrateur Kubernetes pour récupérer les détails du nom d’utilisateur et du mot de passe.
- Trouvez le jeton de porteur valide avec les autorisations appropriées :
  1. Si vous n’avez pas le nom de jeton par défaut, utilisez la commande : kubectl describe secret.
  2. Lasortie affiche tous les comptes et tous les jetons. Recherchez le jeton valide :
    Où kubectl est le compte générique Kubernetes , description est la méthode générique kubectl.
    
    Le paramètre secret reflète le fait que dans votre Kubernetes cluster, le jeton par défaut est protégé en le contenant à l’intérieur de l’objet de type secret .
    
    kubectl décrire la sortie de la commande secrète au format codé BASE64.
  3. Si vous connaissez le nom du jeton par défaut, utilisez la commande suivante : kubectl décrire le secret jeton-de-base-g6pwc
    
    Le jeton par défaut-g6pwc reflète la valeur de paramètre du jeton par défaut pour g6pwc.
  4. La sortie affiche tous les jetons existants pour ce Kubernetes compte.
    Choisissez un jeton à utiliser pour configurer Kubernetes les informations d’identification sur la ServiceNow plateforme.
Assurez-vous que le serveur d’API est accessible à partir du serveur MID pour une découverte réussie Kubernetes .
Assurez-vous que l’utilisateur configuré sur la Kubernetes plateforme dispose des autorisations nécessaires pour exécuter les éléments /api/v1 suivants :
- https://<url>/api/v1/namespaces/
- https://<url>/api/v1/namespaces/<namespace>
- https://<url>/api/v1/namespaces/kube-system/endpoints/kube-controller-manager
- https://<url>/api/v1/services
- https://<url>/api/v1/pods
- https://<url>/api/v1/nodes
- https://<url>/api/v1/replicationcontrollers
- https://<url>/apis/networking.k8s.io/v1/ingresses
- https://<url>/apis/apps/v1/deployments
- https://<url>/apis/apps/v1/statefulsets
- https://<url>/apis/apps/v1/daemonsets
- https://<url>/apis/apps/v1/replicasets
- https://<url>/apis/batch/v1/cronjobs
- https://<url>/apis/batch/v1/jobs
Pour détecter les OpenShift composants du Kubernetes déploiement, assurez-vous que l’utilisateur configuré sur la Kubernetes plateforme dispose des autorisations nécessaires pour exécuter les éléments /api/v1 suivants :
- /apis/apps.openshift.io/v1/deploymentconfigs
- /apis/build.openshift.io/v1/buildconfigs
- /apis/route.openshift.io/v1/routes
- /apis/user.openshift.io/v1/groups
- /apis/user.openshift.io/v1/users
- /apis/project.openshift.io/v1/projects
- /apis/image.openshift.io/v1/images
- /apis/image.openshift.io/v1/imagestreams
Pour détecter les informations de maillage de service :
- Déployez Istio sur votre grappe K8s.
- Fournissez l’URL de Prometheus.
- Configurez Prometheus pour extraire les mesures à partir d'Istio.
Activez l’extension Obtenir les fichiers de configuration Kubernetes vers :
- Détecter les fichiers de configuration.
- Créez des fichiers de configuration suivis.
- Mappez les fichiers de configuration, les charges de travail et les services avec une relation.
Remarque :
Le contenu des fichiers suivis est au format JSON à partir de la version 1.0.92. Le contenu des fichiers suivis est au format YAML dans les versions 1.0.91 et antérieures.

Créez les informations d’identification Kubernetes sur la ServiceNow plateforme :

Sur la ServiceNow plateforme, accédez à Tout > Découverte > Informations d'identification.
Sélectionnez Nouveau.
Sélectionnez les informations d’identification Kubernetes.

Configurez les champs de formulaire (voir table) :


Champ	Description
Nom	Entrez un nom unique et descriptif pour ces informations d'identification.
Noms d'utilisateur	Entrez le nom d'utilisateur ou créez-le dans la table Informations d'identification. Évitez les espaces blancs dans les noms d'utilisateur. Un avertissement apparaît si la plateforme détecte des espaces blancs dans le nom d'utilisateur.
Mot de passe	Entrez le mot de passe de ces informations d'identification.
Jeton de porteur	Pour une authentification avancée à l’aide d’un jeton de porteur, saisissez le jeton de porteur utilisé Découverte pour l’authentification lors de l’accès à Kubernetes. Utilisez la séquence de caractères en tant que jeton, par exemple, 31ada4fd-adec-460c-809a-9e56ceb75269. Remarque : Le jeton Bearer doit être au format codé BASE64.
Authentification de jeton de porteur	Pour une authentification avancée à l’aide d’un jeton de porteur, cochez cette case.
Alias d'identification	Configurez l’alias d’utilisation des informations d’identification pour les Kubernetes appareils et applications autres que Kubernetes. Vous utilisez également cet alias pour définir une planification de découverte sans serveur pour la détection du Kubernetes déploiement. Sélectionnez l’icône du cadenas, puis sélectionnez l’icône de recherche. Dans le formulaire Alias de connexion et d’informations d’identification, sélectionnez Nouveau. Spécifiez un nom pour l'enregistrement d'alias d'informations d'identification. Définissez des attributs pour l'alias. Définissez Type sur `Informations d'identification`. Cliquez avec le bouton droit sur l’en-tête du formulaire et sélectionnez Enregistrer, puis sélectionnez Mettre à jour. Dans le formulaire Alias de connexion et d’informations d’identification, sélectionnez l’alias que vous venez d’ajouter. L'alias apparaît dans le champ Alias d'informations d'identification.

Sur le formulaire Informations d’identification Kubernetes , sélectionnez Mettre à jour.

Créez une planification de découverte sans serveur pour le Kubernetes modèle.

Créez et définissez le modèle d'exécution sans serveur conformément à la description de la documentation du produit. Configurez les paramètres requis par le Kubernetes modèle comme suit :

Tableau 1. Configurer des attributs de modèle d'exécution
Champ	Description
URL	Identificateur du nom d’hôte, adresse IP ou FQDN et port du Kubernetes serveur API. Utilisez le format suivant : example_hostname:example_port ou xample_ip:example_port. Fournissez le protocole correct (HTTP ou HTTPS) dans l'URL.
espace de noms	Espaces de noms transmis par le système dans la configuration de Découverte Kubernetes . Saisissez l'une des valeurs suivantes : Espace de noms individuel : entrez l’espace de noms puis « kube-system ». Par exemple : `dev,kube-system` Valeur par défaut : entrez `default, kube-system` Espaces de noms multipile : entrez les espaces de noms, utilisez une virgule (,) pour séparer les valeurs, puis entrez « kube-system ». Par exemple : `automatisation, application, test, kube-system` Tous les espaces de noms : utilisez un astérisque (*) pour entrer tous les espaces de noms
Alias d’informations d’identification	Alias associé aux informations d’identification créées Kubernetes précédemment.
nom du cluster	Nom de la Kubernetes grappe, au format suivant : <serviceaccountid><space><clustername>.
fournisseur	Le fournisseur dans le cloud : GCP ou AWS ou Azure.
cluster_resource_id	Exemple d’ID de ressource de grappe : Grappes Azure Kubernetes : ID de ressource. AWS : ARN de la grappe. GCP : nom global de la grappe.

Créez une planification de découverte sans serveur pour le modèle d’événement Kubernetes . Configurez l'exécution du calendrier toutes les 5 ou 10 minutes.
Remarque :
lorsque le modèle est exécuté pour la première fois, il stocke un élément event_timestamp. Plus tard, il collecte uniquement les événements delta en fonction de l'horodatage. Plus la fréquence d'exécution du modèle est élevée, moins les mises à jour de CMDB IRE sont nécessaires.

Créez un modèle d’exécution sans serveur pour le calendrier de détection et affectez-le au modèle d’événements Kubernetes . Configurez les paramètres requis par le Kubernetes modèle, comme décrit dans .Configurer des attributs de modèle d'exécution
Pour inclure les composants détectés dans les instances de service, activez les relations CI utilisées dans la détection basée sur les balises par Mappage des services. Ces relations CI sont disponibles à partir de la version 1.0.68 sur ServiceNow Store. Pour les étapes opérationnelles, consultez la rubrique Configuration de découverte basée sur les balises.

Prérequis pour la détection d'infrastructure dans le cloud Kubernetes

Pour le Google Cloud Platform (GCP) modèle – Get Kubernetes Clusters , procédez comme suit :

Dans l'instance ServiceNow, configurez un compte de service Google Cloud Platform (GCP) avec des informations d'identification et des autorisations valides.
Sur l’infrastructure, configurez l’avec Serveur MID un accès complet à toutes les API dans le GCP cloud : définissez les champs d’application de l’accès à l’API dans le cloud sur « Autoriser un accès complet à toutes les API dans le cloud ». L’instance de Serveur MID ne peut accéder qu’aux grappes spécifiques au projet.
Accédez à sys_properties.list et configurez les propriétés suivantes :
- sn_itom_pattern.k8s_midserver: spécifiez un nom valide Serveur MID .
- sn_itom_pattern.k8s_create_schedule_enabled : définissez la valeur sur vrai.
  Remarque :
  L’activation de la sn_itom_pattern.k8s_create_schedule_enabled propriété crée automatiquement un calendrier sans serveur pour vos clusters cloud, éliminant ainsi le besoin d’une planification manuelle. Si vous disposez déjà d’un calendrier manuel et que vous souhaitez le convertir en calendrier automatique, activez la propriété. Votre calendrier manuel sera mis à jour ; Aucun calendrier supplémentaire n’est créé.
Créer et exécuter Google Cloud Découverte
Remarque :

Pour extraire le jeton de porteur, tout en exécutant la planification GKE Kubernetes , utilisez la commande gcloud :

gcloud config helper --format="valeur(credential.access_token) »

La configuration de gcloud dans l’instance de Serveur MID accorde l’accès à la grappe GKE pour extraire le jeton.

Pour la détection en Amazon Elastic Kubernetes Service (EKS) grappe, procédez comme suit :

Dans l'instance ServiceNow, définissez un compte de service AWS avec des informations d'identification et des autorisations de compte de gestion valides.
1. Assurez-vous que la grappe dispose d’un Amazon Elastic Kubernetes Service (EKS) rôle de grappe avec un accès en lecture seule à toutes les ressources.
2. Créez une liaison de rôle de cluster entre le rôle de cluster et un utilisateur Kubernetes. Par exemple, utilisateur en lecture seule.
3. Créez un rôle AWS IAM avec la politique EKSReadOnly.
4. Associez le rôle IAM à l'utilisateur Kubernetes de l'une des façons suivantes :
  - Dans le cluster, modifiez aws-auth ConfigMap.
  - Exécutez la commande suivante :
    eksctl create iamidentitymapping --cluster yourClusterName --arnarn:aws:iam::yourAccountID:role/yourIAMRoleName --username read-only-user
Exécutez Amazon Elastic Kubernetes Service (EKS) la découverte de grappe de deux manières : à l’aide de l’interface AWS de ligne de commande (CLI) ou sans utiliser l’interface de AWS ligne de commande. Commencez par définir la propriété sn_itom_pattern.k8s_aws_cli_to_generate_token système pour utiliser le modèle que vous choisissez. Cette propriété système est définie sur vrai par défaut.
- Définissez cette propriété système sur vrai pour utiliser AWS l’interface de ligne de commande afin de générer un jeton.
- Définissez cette propriété système sur faux pour utiliser Endosser les rôles pour générer un jeton.
1. Exécutez la Amazon Elastic Kubernetes Service (EKS) découverte de grappe à l’aide de l’interface AWS de ligne de commande :
  1. Configurez avec Serveur MID l’interface de ligne AWS de commande configurée. La configuration AWS des informations d’identification CLI accorde l’accès à la Amazon Elastic Kubernetes Service (EKS) grappe.
    
    Remarque :
    L’utilisateur connecté au système doit être le même que l’utilisateur Serveur MID .
  2. Pour générer le jeton de porteur, pendant l’exécution du Amazon Elastic Kubernetes Service (EKS) calendrier, utilisez la AWS commande CLI :aws eks get-token --cluster-name <cluster_name>.
    
    La configuration de l’utilisateur/du AWS rôle CLI dans l’instance Serveur MID accorde l’accès à la Amazon Elastic Kubernetes Service (EKS) grappe pour générer le jeton.
2. Exécutez la Amazon Elastic Kubernetes Service (EKS) découverte de grappe sans utiliser l’interface AWS de ligne de commande :
  
  Remarque :
  
  Cette fonctionnalité est prise en charge à partir de la Schémas de découverte et de mappage des services version 1.0.96 - décembre 2022.
  
  Consultez la base de connaissances suivante pour obtenir des instructions détaillées : KB1182188 : découverte de grappe EKS à l’aide de STS AssumeRoles (sans AWS CLI)
Accédez à sys_properties.list et configurez les propriétés suivantes :
- sn_itom_pattern.k8s_midserver: spécifiez un nom valide Serveur MID .
- sn_itom_pattern.k8s_create_schedule_enabled : définissez la valeur sur vrai.
  Remarque :
  L’activation de la sn_itom_pattern.k8s_create_schedule_enabled propriété crée automatiquement un calendrier sans serveur pour vos clusters cloud, éliminant ainsi le besoin d’une planification manuelle. Si vous disposez déjà d’un calendrier manuel et que vous souhaitez le convertir en calendrier automatique, activez la propriété. Votre calendrier manuel sera mis à jour ; Aucun calendrier supplémentaire n’est créé.
Créez et exécutez un calendrier de détection dans le cloud AWS.

Pour Microsoft Azure Kubernetes Services (AKS) : Kubernetes découverte de grappes, procédez comme suit :

Remarque :

Le Kubernetes modèle prend en charge la détection des versions de grappe AKS antérieures à la version 1.30.

Effectuez la mise à jour vers la dernière Schémas de découverte et de mappage des services version.
Dans l’instance, configurez le compte de service avec des informations d’identification et une ServiceNowAzure autorisation valides Azure .
Accédez à sys_properties.list et configurez les propriétés suivantes :
- sn_itom_pattern.k8s_midserver: spécifiez un nom valide Serveur MID .
- sn_itom_pattern.k8s_create_schedule_enabled : définissez la valeur sur vrai.
  Remarque :
  L’activation de la sn_itom_pattern.k8s_create_schedule_enabled propriété crée automatiquement un calendrier sans serveur pour vos clusters cloud, éliminant ainsi le besoin d’une planification manuelle. Si vous disposez déjà d’un calendrier manuel et que vous souhaitez le convertir en calendrier automatique, activez la propriété. Votre calendrier manuel sera mis à jour ; Aucun calendrier supplémentaire n’est créé.
  .
Si vous n’avez pas de comptes locaux avec Kubernetes RBAC et que vous souhaitez améliorer l’efficacité du modèle, accédez à Serveur MID > Propriétés et définissez la sn_itom_pattern.aks_fetch_local_ad_token propriété sur faux.
Exécutez un calendrier de découverte dans le Azure cloud.

Configurez les Serveur MID dans les Découverte calendriers en fonction du type de compte de grappe. Si vous n’avez pas de comptes locaux avec RBAC, vous pouvez ignorer cette étape.


Type de compte de grappe	Découverte horaire Serveur MID
Authentification MS Entra ID avec Kubernetes RBAC.	N’importe quel Serveur MID.
Authentification MS Entra ID avec Azure RBAC.	N’importe quel Serveur MID.
Comptes locaux avec Kubernetes RBAC.	Sélectionnez le Serveur MID avec l’interface Azure de ligne de commande (CLI) configurée. La configuration des informations d’identification Azure CLI accorde l’accès au cluster AKS. Pour extraire le jeton de porteur lors de l’exécution du calendrier AKSKubernetes, utilisez la Azure commande CLI : `az aks get-credentials --name <cluster_name> --overwrite-existing --resource-group <resourceGroup_name> --file -.`

Remarque :

L’utilisateur connecté au système doit être le même que l’utilisateur Serveur MID .
Pour en savoir plus sur la configuration de la détection de grappe AKS, consultez l’article Détails de configuration de la détection de grappe AKS [KB1220553] dans la section Now Support Base de connaissances.

Tableau 2. Autre prise en charge Configuration système
	Nom de la propriété	Description de la propriété	Type	Valeur par défaut
	sn_itom_pattern.manifest_digest_image_id		Booléen	faux Remarque : Avant de définir cette propriété sur vrai et d’exécuter la découverte : Empêchez la création d’enregistrements en double en supprimant tous les Docker enregistrements d’images.
	sn_itom_pattern.k8s_create_schedule_enabled	Marqueur de fonctionnalité qui peut être activé/désactivé sous les propriétés système, qui est responsable du contrôle de l’exécution du modèle. Lorsqu’elle est activée, elle crée des calendriers de découverte malgré la nouvelle valeur de propriété.	Booléen	faux
	sn_itom_k8s_run_cloud_discovery	Lorsqu’elle est activée, cette propriété exécute les schémas k8s dans le cloud et découvre les grappes k8s sans créer de calendriers automatiques.	Booléen	faux
Serveur MID	sn_itom_pattern.k8s_midserver	[Par défaut] Exemple : nom de Serveur MID valide	Chaîne
	sn_itom_pattern.k8s_<service_account_id>_midserver	[basé sur le niveau du compte de service] Exemple : nom de Serveur MID valide	Chaîne
	sn_itom_pattern.k8s_<service_account_id>_<clustername>_midserver	[Basé sur le nom de grappe] Exemple : nom de Serveur MID valide	Chaîne
	sn_itom_pattern.kubernetes_collect_volume	Lorsque la propriété est définie sur Vrai, les données du volume Kubernetes [cmdb_ci_kubernetes_volume] sont renseignées.	Chaîne	faux
Alias d'informations d'identification	sn_itom_pattern.k8s_ cred_alias	[Par défaut] Exemple : nom de l’alias d’informations d’identification	Chaîne
	sn_itom_pattern.k8s_<service_account_id>_alias	[basé sur le niveau du compte de service] Exemple : nom d’alias d’informations d’identification valide.	Chaîne
	sn_itom_pattern.k8s_<service_account_id>_<clustername>_alias	[Basé sur le nom de grappe] Exemple : nom d’alias d’informations d’identification valide.	Chaîne
Prometheus Url	sn_itom_pattern.k8s_ prometheusUrl	[Par défaut] Exemple : URL Prometheus valide	Chaîne
	sn_itom_pattern.k8s_<service_account_id>_prometheusUrl	[basé sur le niveau du compte de service] Exemple : URL Prometheus valide	Chaîne
	sn_itom_pattern.k8s_<service_account_id>_<clustername>_prometheusUrl	[Basé sur le nom de grappe] Exemple : URL Prometheus valide	Chaîne
	sn_itom_pattern.k8s_ exécution	[Exécution du calendrier de découverte pris en charge : quotidien, sur demande, jours de la semaine, week-ends, dernier jour du mois, fin de trimestre calendaire] Exemple : quotidien	Chaîne
	sn_itom_pattern.k8s_batch_count	[Indique le nombre de calendriers à exécuter par lots – défini par défaut sur 5] Exemple : 5 (nombre de calendriers à exécuter par lots)	Entier	5
	sn_itom_pattern.k8s_schedule_batch_delay	[Conserve la trace de la différence de temps entre deux lots que la valeur contient en secondes] Exemple : 300 (en secondes)	Entier
	sn_itom_pattern.k8s_run_time	[Conserve la trace de l’heure actuelle pour un lot] Si cette propriété est définie, vous pouvez utiliser la même chose ou vous pouvez utiliser notre synchronisation dynamique, qui sera 5 minutes après la synchronisation actuelle du système. Valeurs contenues au format HH :MM :SS Exemple : 10:11:12 (HH :MM :SS)	Chaîne

Remarque :

<service_account_id> s’agit du nom de l’ID de compte sous Comptes de service dans le cloud. Pour plus d’informations, voir : Créer des calendriers pour la détection des ressources dans le cloud dans Découverte dans le cloud

Kubernetes Détection sans informations d’identification ou au milieu de la grappe

Conditions préalables à Kubernetes la détection sans informations d’identification :

Déployez l’élément conteneurisé Serveur MID dans la Kubernetes grappe. La configuration Kubernetes des informations d’identification n’est pas nécessaire, car la Serveur MID grappe interne Kubernetes détecte automatiquement le serveur d’API et s’authentifie.

Tableau 3. Configuration des attributs de modèle d’exécution pour la découverte sans informations d’identification
Champ	Description
URL	Entrez l’une des valeurs suivantes dans le champ URL : https://cluster Ou https://kubernetes.default.svc
espace de noms	Espaces de noms transmis par le système dans la configuration de Découverte Kubernetes . Saisissez l'une des valeurs suivantes : Espace de noms individuel : entrez l’espace de noms puis « kube-system ». Par exemple : `dev,kube-system` Valeur par défaut. Entrée :`default,kube-system` Espaces de noms multipile : entrez les espaces de noms, utilisez une virgule (,) pour séparer les valeurs, puis entrez « kube-system ». Par exemple : `automatisation, application, test, kube-system` Tous les espaces de noms : utilisez un astérisque (*) pour entrer tous les espaces de noms.
cluster_name	Saisissez un nom unique.

Données collectées par Découverte lors d'une détection horizontale


Table et champ	Description
Kubernetes Grappe [cmdb_ci_kubernetes_cluster]
Nom	Le nom du leader kube-controller-manager.
K8s_uid	UID de l’espace de noms kube-system [versions prises en charge : 1.0.92 et versions ultérieures]
ip_address	Identificateur du host_ip du Kubernetes serveur api.
port	Identificateur du port du Kubernetes serveur API.
espace de noms	Cette valeur affiche les espaces de noms transmis par le système dans la configuration de Découverte Kubernetes .
event_timestamp	Horodatage du dernier événement créé sur cette Kubernetes grappe au moment de la découverte.
Kubernetes Nœud [cmdb_ci_kubernetes_node]	L’aspect virtuel du Kubernetes nœud. Les données relatives à l’aspect physique du nœud sont stockées sous Linux le Kubernetes serveur.
nom	Le nom du Kubernetes nœud. Le format ne peut être que le nom de l'ordinateur ou le nom complet composé du nom et du nom d'hôte : `<name>.<hostname>` .
k8s_uid	Identificateur de l’UUID Kubernetes du nœud.
grappe	Nom de la grappe qui contient cette ressource.
operational_status	État opérationnel du Kubernetes nœud.
Kubernetes Service [cmdb_ci_kubernetes_service]
nom	Le nom du Kubernetes service.
sélecteur	Une liste séparée par des virgules des sélecteurs d’étiquettes spécifiés dans la Kubernetes configuration qui sont utilisés pour sélectionner les pods cibles.
espace de noms	Espace Kubernetes de noms auquel ce Kubernetes service appartient.
k8s_uid	UUID Kubernetes de service.
grappe	Nom de la grappe qui contient cette ressource.
Kubernetes Pod [cmdb_ci_kubernetes_pod]
nom	Nom du Kubernetes pod.
k8s_uid	UUID Kubernetes du pod.
resourceVersion	Version de la ressource du Kubernetes pod.
espace de noms	Espace Kubernetes de noms auquel ce Kubernetes pod appartient.
grappe	Nom de la grappe qui contient cette ressource.
État	État Kubernetes du pod : En attente, En cours d’exécution, Réussi , Échec et Inconnu.
Kubernetes Cronjob [cmdb_ci_kubernetes_cronjob]
nom	Nom du Kubernetes cronjob
espace de noms	Espace Kubernetes de noms auquel ce Kubernetes pod appartient.
k8s_uid	L’UUID Kubernetes cronjob.
grappe	Nom de la grappe qui contient cette ressource.
Kubernetes Tâche [cmdb_ci_kubernetes_job]
nom	Le nom de la Kubernetes tâche
espace de noms	Espace Kubernetes de noms auquel cette Kubernetes tâche appartient.
k8s_uid	UUID de la Kubernetes tâche
grappe	Le nom de la grappe qui contient Kubernetes la tâche.
Kubernetes Daemonset [cmdb_ci_kubernetes_daemonset]
nom	Nom du Kubernetes démonset.
espace de noms	Espace Kubernetes de noms auquel ce Kubernetes démonét appartient.
k8s_uid	UUID Kubernetes du démonset.
grappe	Nom de la grappe qui contient cette ressource.
pods_avail	Nombre de pods disponibles.
pods_failed	Nombre de pods en phase d’échec.
pods_running	Nombre de pods dans la phase En cours d’exécution.
pods_succeeded	Nombre de pods dans la phase Réussi.
pods_waiting	Nombre de pods dans la phase d’attente.
Kubernetes Entrée [cmdb_ci_kubernetes_ingress]
nom	Nom de l’entrée Kubernetes
espace de noms	Espace Kubernetes de noms auquel cette Kubernetes entrée appartient.
k8s_uid	UID Kubernetes d’entrée
grappe	Nom de la grappe qui contient cette ressource.
Kubernetes Déploiement [cmdb_ci_kubernetes_deployment] Kubernetes Jeu de répliques [cmdb_ci_kubernetes_replicaset] Kubernetes Contrôleur de réplication [cmdb_ci_kubernetes_replicationcontroller] Kubernetes Statefulset [cmdb_ci_kubernetes_statefulset]
nom	Nom de cette ressource
espace de noms	Espace Kubernetes de noms auquel cette ressource appartient.
K8s_uid	UID Kubernetes de cette ressource
grappe	Nom de la grappe qui contient cette ressource.
total_replicas	Nombre de réplications dans cette ressource
desired_replicas	Nombre de répliques dans la phase souhaitée
available_replicas	Nombre de répliques disponibles
unavailable_replicas	Nombre de réplications en phase indisponible
updated_replicas	Nombre de réplications mises à jour
Conteneur Docker [cmdb_ci_docker_container]	Le composant qui exécute l'image Docker.
container_id	L’identificateur unique du Kubernetes conteneur Docker Dans les cas où des enregistrements en double sont créés, les tâches de déduplication s’affichent une fois Découverte exécutée. Pour plus d’informations sur la résolution de ces tâches, consultez l’article Rendre l’identificateur de conteneur Docker indépendant [KB1443042] dans la section ServiceNow® Base de connaissances.
espace de noms	Espace Kubernetes de noms auquel ce Kubernetes conteneur Docker appartient
Image de Docker [cmdb_ci_docker_image]	Package exécutable d’une application et de ses logiciels connexes qui peuvent être instanciés par un conteneur Docker
image_id	L’identificateur de l’image de Docker Kubernetes
nom	Le nom de l’image Kubernetes Docker.
image_url	L'URL pour le téléchargement de l'image Docker.
espace de noms	Espace Kubernetes de noms auquel appartient cette Kubernetes image Docker.
Serveur Linux [cmdb_ci_linux_server]	Le serveur qui héberge le Kubernetes nœud.
nom	Nom du serveur Linux qui alimente le Kubernetes nœud.
hostname	Le nom d'hôte du serveur Linux.
os	Le système d'exploitation déployé sur ce serveur Linux.
kernel_release	La version du système d'exploitation du noyau Linux déployée sur ce serveur Linux.
ram	La taille de la RAM installée sur ce serveur Linux.
ip_address	L'adresse IP du serveur Linux.
Valeur clé [cmdb_key_value]	Cet élément de configuration contient Kubernetes des étiquettes. Les étiquettes sont des paires clé/valeur qui sont associées à des objets, tels que des pods.
clé	La clé du paramètre du pod ou Kubernetes du KubernetesKey Value service.
valide	Valeur du Kubernetes paramètre de pod ou Kubernetes de service Key Value .
Kubernetes Volume [cmdb_ci_kubernetes_volume]
k8s_uid	UUID Kubernetes de volume.
mount_path	Chemin d’accès à ce Kubernetes volume.
nom	Nom du Kubernetes volume.
espace de noms	Espace Kubernetes de noms auquel ce Kubernetes volume appartient.
grappe	Nom de la grappe qui contient cette ressource.
volume_id	ID du Kubernetes volume.
OpenShift Configuration déployée [cmdb_ci_openshift_dep_conf]
nom	Nom de la configuration de déploiement OpenShift .
espace de noms	Le nom de l'espace de noms contenant la configuration du déploiement.
k8s_uid	UUID Kubernetes de volume.
URL	URL de la OpenShift configuration déployée.
OpenShift Configuration de la version [cmdb_ci_openshift_build_conf]
nom	Nom de la configuration de version OpenShift .
espace de noms	Nom de l’espace OpenShift de noms contenant la configuration de la build.
k8s	UUID Kubernetes de volume.
URL	URL de la configuration de la OpenShift build.
OpenShift Image Source2 [cmdb_ci_openshift_source_2_image]
nom	Le nom de l'image source OpenShift.
à	Image connexe.
parent_id	ID de l’image OpenShift source.
OpenShift Acheminement [cmdb_ci_openshift_route]
nom	Nom de l’itinéraire OpenShift .
espace de noms	Nom de l’espace de noms contenant l’itinéraire OpenShift .
k8s_uid	UUID Kubernetes de volume.
URL	URL de l’itinéraire OpenShift .
hôte	Hôte cible de l’itinéraire OpenShift .
port	Port cible de l’itinéraire OpenShift .
OpenShift Groupe [cmdb_ci_openshift_group]
nom	Le nom du OpenShift groupe.
k8s_uid	UUID Kubernetes de volume.
URL	URL du OpenShift groupe.
OpenShift Utilisateur [cmdb_ci_openshift_user]
nom	Le nom de l’utilisateur OpenShift .
k8s_uid	UUID Kubernetes de volume.
URL	L’URL de l’utilisateur OpenShift .
full_name	Le nom complet de l’utilisateur OpenShift .
OpenShift Projet [cmdb_ci_openshift_project]
nom	Le nom du OpenShift projet.
k8s_uid	UUID Kubernetes de volume.
URL	URL du OpenShift projet.
OpenShift Image [cmdb_ci_openshift_images]
nom	Nom de l’image OpenShift .
k8s_uid	UUID Kubernetes de volume.
URL	URL de l’image OpenShift .
docker_image_metadata_id	L'ID de l'image Docker.
docker_image_metadata_parent_id	L'ID parent de l'image.
arch	Architecture de l'image.
size	La taille de l'image.
hostname	Le nom d'hôte associé à l'image.
OpenShift Flux d’images [cmdb_ci_openshift_images_stream]
nom	Nom du OpenShift flux d’images.
k8s_uid	UUID Kubernetes de volume.
URL	URL du flux d’imagesOpenShift.
espace de noms	Nom de l’espace de noms contenant le OpenShift flux d’images.
OpenShift Référentiel d’images Docker [cmdb_ci_openshift_docker_images_repository]
nom	Le nom du référentiel d’images OpenShift Docker.
parent_id	L'ID du système parent.
Espace de noms [cmdb_ci_kubernetes_namespace]
nom	Le nom de l’espace de noms Kubernetes .
État	Phases Kubernetes de l’espace de noms : Actif ou Fin d’exécution.

Ces données sont collectées par la section d'extension Collect Container Repository.


Table et champ	Description
Référentiel du conteneur [cmdb_ci_container_repository]
Nom [name]	Le nom du référentiel de conteneur.
Entrée du référentiel du conteneur [cmdb_ci_container_repository_entry]
Nom [name]	Le nom de l'entrée du référentiel du conteneur.
Catégorie [category]	Catégorie de l'entrée du référentiel du conteneur.

Le graphique illustre les CI qui font partie de la Kubernetes découverte.

Remarque :

cette carte Vue des dépendances a été simplifiée pour plus de clarté. Vos Kubernetes déploiements peuvent contenir beaucoup plus de CI.

Composants du déploiement Kubernetes — Figure 1. Composants du Kubernetes déploiement

Composants du déploiement Kubernetes, y compris OpenShift — Figure 2. Composants du Kubernetes déploiement, y compris OpenShift

Relations CI collectées par le modèle Kubernetes

Ces relations sont créées par Kubernetes modèle :


CI	Relation	CI
Kubernetes Grappe [cmdb_ci_kubernetes_cluster]	Contient::Contenu par	Kubernetes Service [cmdb_ci_kubernetes_service]
	Contient::Contenu par	Kubernetes Pod [cmdb_ci_kubernetes_pod]
	Contient::Contenu par	Kubernetes Entrée [cmdb_ci_kubernetes_ingress]
	Contient::Contenu par	Kubernetes Espace de noms [cmdb_ci_kubernetes_namespace]
	Contient::Contenu par	[cmdb_ci_openshift_source_2_image]
	Contient::Contenu par	OpenShift Groupe [cmdb_ci_openshift_group]
	Contient::Contenu par	OpenShift Utilisateur [cmdb_ci_openshift_user]
	Contient::Contenu par	OpenShift Projet [cmdb_ci_openshift_project]
	Contient::Contenu par	OpenShift Image [cmdb_ci_openshift_images]
	Contient::Contenu par	OpenShift Référentiel d’images Docker [cmdb_ci_openshift_docker_images_repository]
	Cluster of::Cluster	Kubernetes Nœud [cmdb_ci_kubernetes_node]
	Manages::Managed by	Serveur Linux [cmdb_ci_linux_server]
	Contenu par::Contient	Groupe de ressources [cmdb_ci_resource_group]
Kubernetes Pod [cmdb_ci_kubernetes_pod]	Contient::Contenu par	Conteneur Docker [cmdb_ci_docker_container]
	Contient :: Contenu par	Image de Docker [cmdb_ci_docker_image]
	Contient::Contenu par	Kubernetes Volume [cmdb_ci_kubernetes_volume]
Kubernetes Charge de travail [cmdb_ci_kubernetes_workload]	Hébergé sur::Hôtes	Kubernetes Grappe [cmdb_ci_kubernetes_cluster]
Service Kubernetes [cmdb_ci_kubernetes_service]	Fournit ::P fourni par	Kubernetes Charge de travail [cmdb_ci_kubernetes_workload]
Déploiement Kubernetes [cmdb_ci_kubernetes_deployment]	Possède ::Appartient à	Kubernetes Jeu de répliques [cmdb_ci_kubernetes_replicaset]
Kubernetes Jeu de répliques [cmdb_ci_kubernetes_replicaset]	iInstantiates : instancié par	Kubernetes Pod [cmdb_ci_kubernetes_pod]
Kubernetes Charge de travail [cmdb_ci_kubernetes_workload]	Provided By::Provides To	Kubernetes Service [cmdb_ci_kubernetes_service]
Kubernetes Déploiement [cmdb_ci_kubernetes_deployment]	Hébergé sur::Hôtes	Kubernetes Grappe [cmdb_ci_kubernetes_cluster]
Kubernetes Daemonset [cmdb_ci_kubernetes_daemonset]	Hébergé sur::Hôtes	Kubernetes Grappe [cmdb_ci_kubernetes_cluster]
Kubernetes Statefulset [cmdb_ci_kubernetes_statefulset]	Hébergé sur::Hôtes	Kubernetes Grappe [cmdb_ci_kubernetes_cluster]
Kubernetes Espace de noms [cmdb_ci_kubernetes_namespace]	Contient::Contenu par	OpenShift Configuration déployée [cmdb_ci_openshift_dep_conf]
	Contient::Contenu par	OpenShift Configuration de la version [cmdb_ci_openshift_build_conf]
	Contient::Contenu par	OpenShift Acheminement [cmdb_ci_openshift_route]
	Contient::Contenu par	OpenShift Flux d’images [cmdb_ci_openshift_images_stream]
Image de Docker [cmdb_ci_docker_image]	Instantiates::Instantiated by	Conteneur Docker [cmdb_ci_docker_container]
Serveur Linux [cmdb_ci_linux_server]	Contient::Contenu par	Kubernetes Pod [cmdb_ci_kubernetes_pod]
	Runs::Runs on	Conteneur Docker [cmdb_ci_docker_container]
	Hosts::Hosted on	Kubernetes Nœud [cmdb_ci_kubernetes_node]
OpenShift Configuration de déploiement [cmdb_ci_openshift_dep_conf]	Contient::Contenu par	[cmdb_ci_config_file_tracked]

La section d'extension Collect Container Repository du modèle Kubernetes identifie les relations suivantes.


CI	Relation	CI
Image de Docker [cmdb_ci_docker_image]	Mis en service à partir de::Mis en service	Entrée du référentiel du conteneur [cmdb_ci_container_repository_entry]
Entrée du référentiel du conteneur [cmdb_ci_container_repository_entry]	Hébergé sur::Hôtes	Référentiel du conteneur [cmdb_ci_container_repository]

Relations CI collectées par l’extension Istio Service Mesh

Prérequis pour l’extension Istio Service Mesh :

Assurez-vous que les composants Istio Service Mesh et Prometheus sont configurés sur la Kubernetes grappe.
Assurez-vous que Prometheus détecte les informations de connexion de service à l’aide de la commande queryistio_requests_total .
Assurez-vous que les services d’application sont connectés et vérifiez le flux de trafic de service à service dans le graphique Kiali.

Pour plus d’informations sur l’application Bookinfo, voir : https://istio.io/latest/docs/examples/bookinfo/


CI	Relation	CI
Kubernetes Service [cmdb_ci_kubernetes_servi ce]	Se connecte à ::Connecté par	Kubernetes Service [cmdb_ci_kubernetes_service]

Relations CI collectées par le modèle d’événement Kubernetes

Les relations suivantes sont créées pour prendre en charge la découverte d’événements Kubernetes :


CI	Relation	CI
Kubernetes Grappe [cmdb_ci_kubernetes_cluster]	Contient::Contenu par	Kubernetes Service [cmdb_ci_kubernetes_servi ce]
	Contient::Contenu par	Kubernetes Pod [cmdb_ci_kubernetes_pod]
	Cluster of::Cluster	Kubernetes Nœud [cmdb_ci_kubernetes_node]
	Manages::Managed by	[cmdb_ci_linux_server]
Kubernetes Pod [cmdb_ci_kubernetes_pod]	Contient::Contenu par	Conteneur Docker [cmdb_ci_docker_container]
	Contient :: Contenu par	Image de Docker [cmdb_ci_docker_image]
	Contient::Contenu par	Kubernetes Volume [cmdb_ci_kubernetes_volume]
Image de Docker [cmdb_ci_docker_image]	Instantiates::Instantiated by	Conteneur Docker [cmdb_ci_docker_container]
Serveur Linux [cmdb_ci_linux_server]	Contient::Contenu par	Kubernetes Pod [cmdb_ci_kubernetes_pod]
	Runs::Runs on	Conteneur Docker [cmdb_ci_docker_container]
	Hosts::Hosted on	Kubernetes Nœud [cmdb_ci_kubernetes_node]

Données collectées par Mappage des services lors de la détection basée sur les balises

Mappage des services utilise la détection basée sur les balises pour créer des cartes de service d’application incluant les Kubernetes composants. Mappage des services est livré avec les relations CI préconfigurées suivantes utilisées pour la détection basée sur les balises. Ces relations CI sont disponibles à partir de la version 1.0.68 sur ServiceNow Store.


CI	Relation	CI
Service Kubernetes [cmdb_ci_kubernetes_service]	Contenu par::Contient	Grappe Kubernetes [cmdb_ci_kubernetes_cluster]
Projet OpenShift [cmdb_ci_openshift_project]	Contenu par::Contient	Grappe Kubernetes [cmdb_ci_kubernetes_cluster]
Pod Kubernetes [cmdb_ci_kubernetes_pod]	Contenu par::Contient	Grappe Kubernetes [cmdb_ci_kubernetes_cluster]
Pod Kubernetes [cmdb_ci_kubernetes_pod]	Grappe::Grappe de	Service Kubernetes [cmdb_ci_kubernetes_service]
Espace de noms Kubernetes [cmdb_ci_kubernetes_namespace]	Contient::Contenu par	Configuration déployée OpenShift [cmdb_ci_openshift_dep_conf]
Espace de noms Kubernetes [cmdb_ci_kubernetes_namespace]	Contient::Contenu par	Configuration de la version OpenShift [cmdb_ci_openshift_build_conf]
Espace de noms Kubernetes [cmdb_ci_kubernetes_namespace]	Contient::Contenu par	Route OpenShift [cmdb_ci_openshift_route]
Espace de noms Kubernetes [cmdb_ci_kubernetes_namespace]	Contient::Contenu par	Flux d'images OpenShift [cmdb_ci_openshift_images_stream]

Tableau de bord de Kubernetes

Une fois Découverte la Kubernetes détection des composants du déploiement terminée, vous pouvez accéder à Espaces de travail > Espace de travail de l'administrateur de Découverte > Aperçus et utilisez le Explorateur Kubernetes tableau de bord pour afficher les environnements et les Kubernetes ressources de votre organisation. Pour utiliser le tableau de bord amélioréKubernetes, vérifiez que vous disposez Espace de travail de l'administrateur de Découverte de la version 1.3.1 (Store août 2024). Pour plus d'informations sur Explorateur Kubernetes, consultez Explorateur Kubernetes.

Dépannage

Si le processus de mappage ne se déroule pas comme prévu, suivez les suggestions ci-après.


Symptôme	Cause	Solution
Échec de la détection. Le message de détection fait état d'une erreur liée au délai d'expiration de REST.	De nombreux CI envoient la réponse d'appel REST dans le déploiement. Le Serveur MID ne peut pas traiter la réponse d'appel REST sans dépasser la limite de temps contrôlée par le paramètre mid.sa.cloud.request_timeout.	Par défaut, le paramètre mid.sa.cloud.request_timeout est défini sur 30 000 millisecondes. Augmentez la valeur de ce paramètre sur le Serveur MID pertinent et relancez la détection. Remarque : Si la liste connexe Paramètres de configuration pour le Serveur MID pertinent n'affiche pas ce paramètre, vous devrez peut-être l'ajouter.
Concepteur de modèle échoue lors d'une session de débogage. Le message de Concepteur de modèle fait état d'une erreur liée au délai d'expiration.	Concepteur de modèle échoue en raison d'un délai d'expiration pendant le débogage du modèle (et non pendant la détection).	Par défaut, le paramètre sa.debugger.max_timeout est défini sur 240 secondes. Augmentez la valeur de ce paramètre sur le Serveur MID pertinent.

Pour exécuter le Kubernetes modèle en mode de débogage, reportez-vous à KB0832567 pour des informations opérationnelles.