Détection de Pivotal Cloud Foundry

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 9 minutes de lecture
  • L’application ServiceNow Découverte recherche Pivotal Cloud Foundry les composants (PCF) version 3 à l’aide du Pivotal Cloud Foundry modèle. La détection de certaines de ces ressources peut nécessiter une mise à jour vers la dernière version de l’application Schémas de découverte et de mappage des services à partir du ServiceNow Store.

    Vous pouvez utiliser ce modèle sur la ServiceNow AI Platform version de départ de Kingston.

    La découverte des composants PCF V3 est prise en charge lorsque le module d’extension Schémas de découverte et de mappage des services version 1.0.99, mars 2023 est installé. Le schéma continue de prendre en charge la découverte de composants PCF V2.

    Demander des applications dans l'App Store

    Visitez le ServiceNow Store pour afficher toutes les applications disponibles et pour obtenir des informations sur la soumission de demandes à la boutique. Pour obtenir des informations sur les notes de publication cumulatives pour toutes les applications publiées, consultez les ServiceNow Store notes de publication relatives à l'historique des versions.

    Prérequis

    Informations d'identification Pivotal Cloud Foundry
    Créez les informations d’identification Pivotal Cloud Foundry .
    1. Accédez à la Découverte > Informations d'identification.
    2. Sélectionnez Nouveau.
    3. Sélectionnez les informations d’identification CloudFoundry.
    4. Renseignez les champs suivants du formulaire :
      Champ Description
      Nom Nom des informations d’identification. Par exemple, pcf_user informations d’identification
      Actives Option permettant d’activer ces informations d’identification pour la découverte. Cochez cette case pour activer la découverte.
      Concerne Informations d’identification que vous souhaitez ou non appliquer à tous les serveurs MID de votre réseau, ou à un ou plusieurs serveurs MID spécifiques. Sélectionner des serveurs MID spécifiques.
      Ordre Ordre dans lequel la plateforme teste ces informations d’identification lorsqu’elle tente de se connecter aux appareils. Un nombre plus faible indique que les informations d’identification semblent plus haut dans la liste. Établissez l’ordre des informations d’identification lors de l’utilisation d’un grand nombre d’informations d’identification ou lorsque la sécurité verrouille les utilisateurs après trois tentatives de connexion infructueuses. Si toutes les informations d’identification ont le même numéro d’ordre, ou aucun, l’instance teste les informations d’identification dans un ordre aléatoire. La valeur par défaut est 100.
      Nom d'utilisateur Nom de l’utilisateur de ces informations d’identification. Évitez les espaces de début ou de fin dans les noms d’utilisateur. Un avertissement s’affiche si la plateforme détecte des espaces de début ou de fin dans le nom d’utilisateur. Un exemple est pcf_user. Utilisez la client_id utilisée pour générer le jeton JWT.
      Mot de passe Mot de passe de l’utilisateur de ces informations d’identification. Utilisez la client_secret utilisée pour générer le jeton JWT.
      Alias d'identification Autre nom pour ces informations d’identification. Par exemple, cf

      Si ce champ est fermé, sélectionnez l’icône de déverrouillage pour déverrouiller le champ.

    5. Sélectionnez Mettre à jour.
    JSON Informations d’identification de jeton Web
    Pour vérifier le JSON jeton Web (JWT), procédez comme suit.

    Le format du jeton JWT est : https://docs.cloudfoundry.org/api/uaa/version/4.27.0/index.html#jwt-bearer-token-grant

    1. Exécutez le script cURL suivant sur l’API du serveur UAA (User Account and Authentication) et vérifiez les résultats :

      curl -s -k https ://ip_address :port/oauth/token -X ; POST -H « Type-de-contenu : application/x-www-form-urlencoded » -H « Accepter : application/json » -d « client_id=<INSERT_USER_HERE>&client_secret=<INSERT_PASS_HERE>&grant_type=client_credentials&token_format=jwt&response_type=token »

      Si cette commande ne génère pas de jeton, vérifiez que les informations d’identification dans le référentiel sont correctes, sinon passez à l’étape ServiceNow 2.

    2. Exécutez le script cURL suivant sur Pivotal Cloud Foundry l’API :

      curl https ://ip_address :port/v3/spaces -k -v -H « Accepter : application/json » -H « Autorisation : porteur<INSÉRER LE JETON ICI> »

      Si cette commande ne récupère pas les informations des espaces PCF, vérifiez les informations d’identification dans le référentiel des informations d’identification ServiceNow .

    Informations d’identification pour les éléments d’API V3
    Autorisez un utilisateur en lecture seule à utiliser les éléments d’API suivants :
    • –/v3/organisations
    • –/v3/espaces
    • –/v3/domaines
    • –/v3/routes
    • –/v3/organization_quotas
    • –/v3/space_quotas
    • –/v3/apps
    • -/v3/service_offerings
    • -/v3/service_plans
    • -/v3/service_instances
    • -/v3/gouttelettes
    Remarque :
    Le Pivotal Cloud Foundry modèle prend également en charge les API PCF V2.
    Créer un calendrier sans Découverte serveur
    1. Accédez à la Découverte > Calendriers de découverte.
    2. Sélectionnez Nouveau.
    3. Renseignez les champs suivants du formulaire :
      Tableau 1. Découverte Formulaire de calendrier
      Champ Description
      Nom Saisissez un nom unique et descriptif pour ce Découverte calendrier, par exemple : pcf
      Détecter Pour le type Détecter, sélectionnez Serverlesss
      Serveur MID Serveurs MID auxquelles les informations d’identification s’appliquent. Spécifiez les éléments requis Serveur MID, par exemple Discovery_Server
      Actives Option permettant d’activer ces informations d’identification pour la découverte. Cochez cette case pour activer la découverte.
      Alias d'identification Autre nom pour ces informations d’identification. Utilisez l’alias associé aux informations d’identification Pivotal Cloud Foundry que vous avez créées précédemment.
    4. Cliquez avec le Découverte bouton droit sur l’en-tête du formulaire Calendrier, puis sélectionnez Enregistrer.

      Schéma d’exécution sans serveur

    5. Sélectionnez l'onglet Modèles d'exécution sans serveur.
    6. Sélectionnez Nouveau.
    7. Renseignez les champs suivants du formulaire :
      Tableau 2. Formulaire de schéma d’exécution sans serveur
      Champ Description
      Nom Saisissez un nom unique et descriptif pour ce schéma d’exécution sans serveur, par exemple, pcf1
      Modèle Sélectionnez CloudFoundry.
      Hôte proxy Nom de domaine complet de l’ordinateur sur lequel vous installez le serveur proxy. Spécifiez global.
      Actives Case à cocher pour activer ce calendrier pour la découverte. Cochez cette case.
    8. Cliquez avec le bouton droit sur l’en-tête du formulaire Schémas d’exécution sans serveur et sélectionnez Enregistrer.
    9. Sélectionnez l’onglet Schémas d’exécution sans serveur
    10. Créez et définissez le modèle d’exécution sans serveur tel que décrit dans la documentation du produit.
      Configurez les paramètres requis par le Pivotal Cloud Foundry modèle comme suit :
      Tableau 3. Découverte Paramètres du lanceur de schéma
      Paramètre Description
      Organisation Nom de l’organisation qui doit être détectée, ou toutes où l’entrée est « * ».
      Alias d’informations d’identification Autre nom pour ces informations d’identification. Utilisez l’alias associé aux informations d’identification Pivotal Cloud Foundry que vous avez créées précédemment.
      URL_CF URL de l’API du contrôleur du cloud utilisé pour récupérer les informations à partir de .Pivotal Cloud Foundry
      URL_CF_AUTH API de serveur UAA​utiliséee pour générer le jeton. Saisissez la valeur au format suivant : https://uaa.sys.dev.phx.pcf.example.com/oauth/token
    11. Mettre à jour.
    12. Pour démarrer la découverte, accédez à la définition de Serverless Découverte et sélectionnez Découvrir maintenant.
    EVAL Fonctions de fermeture

    Utilisez les fonctions de fermeture suivantes EVAL pour concaténer toutes les organisations avec « , » comme séparateur.

    var rtrn = ’’;
    var organizations = ${organizations[*].name};
    var beforeReturn = ’’;
    var separator = ’’;
    for (var i = 0; i < organizations.size(); i++)   
    	{
    	beforeReturn += separator + organizations.get(i);  
    	separator = ',';   
    	}
    rtrn = beforeReturn;
    

    Utilisez les fonctions de fermeture suivantes EVAL pour renvoyer 1 si l’état opérationnel est actif et 2 s’il n’est pas actif.

    var rtrn = '';
    var currentOrgStatus = ${organizations[].operational_status};
    var status = currentOrgStatus.toLowerCase();
    if(status == "active"){  
       rtrn = "1";  
    }
    else { 
       rtrn = "2";
    }
    

    Utilisez la fonction de fermeture suivante EVAL pour renvoyer 1 si l’état opérationnel est démarré et 2 s’il ne l’est pas.

    var rtrn = '';
    var currentAppStatus = ${apps[].state};
    var status = currentAppStatus.toLowerCase();
    if(status == "started"){
       rtrn = "1";  
    }
    else {   
       rtrn = "2";   
    }
    
    Obtenir un appel CloudFoundry
    L’opération personnalisée CloudFoundry Get Call gère la génération de jetons. Elle utilise les informations d’identification et URL_CF_AUTH variable de contexte pour générer un jeton utilisé pour créer des appels d’API.

    Lorsqu’un jeton est généré, le URL_CF est utilisé pour créer les appels d’API définis dans le champ Ressource . L’opération personnalisée gère également la pagination lorsque la réponse comporte plusieurs pages.

    CloudFoundry Get Call analyse l’entrée JSON pour renseigner les tables et les variables.

    Opération personnalisée CloudFoundry

    Pivotal Cloud Foundry Section d’extension BOSH

    Le Pivotal Cloud Foundry BOSH est une section d’extension Pivotal Cloud Foundry du modèle.

    L’extension est disponible sur le ServiceNow® Store pour la version 1.6.0 de Schémas de découverte et de mappage des services juin 2023.
    Exigences pour Pivotal Cloud Foundry BOSH
    Remarque :
    Les exigences suivantes ne concernent que la section d’extension BOSH.
    L’URL d’authentification Opsman doit être fournie en tant que paramètre de modèle avec le nom URL_OPSMAN_AUTH. Par exemple : https://< point d’entrée Opsman >/uaa/oauth/token
    Les informations d’identification ajoutées doivent être autorisées à exécuter les API suivantes :
    • /uaa/oauth/jeton
    • /api/v0/deployed/products
    Remarque :
    Des API personnalisées sont ajoutées en tant qu’étape d’API Tanzu Opsman Get au modèle.

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

    Tableau 4. Informations collectées
    Champ Description
    CI principal : Fondation PCF [cmdb_ci_pcf_foundation]
    Nom Pivotal Cloud Foundry Nom de l’entrée de grappe

    <nom>-<hostCf :<portCf>

    ip_address Pivotal Cloud Foundry IP de l’hôte.
    port Pivotal Cloud Foundry port de service.
    short_description Pivotal Cloud Foundry Numéro de version du service.
    Organisation Liste des organisations, gérée par la grappe PCF. Les entrées sont séparées par un séparateur « , » séparé par une virgule.
    Organisation PCF [cmdb_ci_pcf_organization]
    Nom Nom de l'organisation
    URL URL unique à l’organisation
    pcf_guid UID d’organisation dans CF
    operational_status État de l’organisation
    Espace PCF [cmdb_ci_pcf_space]
    Nom Nom de l'espace
    URL URL unique de l’espace
    pcf_guid UID d’espace dans CF
    Application PCF [cmdb_ci_pcf_appl]
    Nom Nom de l'application
    URL URL unique de l’application
    pcf_guid UID d’application dans CF
    Acheminement PCF [cmdb_ci_pcf_route]
    Nom Nom de routage
    URL URL unique de l’itinéraire
    pcf_guid UID de routage dans CF
    port Port de routage
    type Type de routage
    Quota PCF [cmdb_ci_pcf_quota]
    Nom Nom du quota
    URL Quota unique URL
    pcf_guid UID de quota dans CF
    Domaine PCF [cmdb_ci_pcf_domain]
    nom Nom du domaine
    URL URL unique du domaine
    pcf_guid UID de domaine dans CF
    Instance d’espace PCF [cmdb_ci_pcf_space_instance]
    nom Nom de l’instance de service d’espace
    URL URL unique de l’instance de service d’espace
    pcf_guid UID de l’instance de service spatial dans CF
    Plan de service PCF [cmdb_ci_pcf_service_plan]
    nom Nom de l’instance du plan de service
    URL Service plan unique URL
    pcf_guid UID de l’instance de service spatial dans CF
    Service PCF [cmdb_ci_pcf_service]
    nom Nom de service
    URL Service unique URL
    pcf_guid UID de service dans CF
    Gouttelette PCF [cmdb_ci_pcf_droplet]
    nom URL de ressource
    pcf_guid ID de gouttelette
    URL Droplet URL
    install_status État d’installation : 1, « installé »
    operational_status Statut opérationnel : 1, « opérationnel »
    Valeur clé [cmdb_key_value]
    key Clé de la balise de ressource
    Remarque :
    Ces données ne sont collectées que pour les appels d’API V3.
    valide Valeur de la balise de ressource.
    Remarque :
    Ces données ne sont collectées que pour les appels d’API V3.
    Tableau 5. Données découvertes par la section d’extension Pivotal Cloud Foundry BOSH
    Champ Description

    Déploiement BOSH (cmdb_ci_bosh_deployment)

    Nom Le nom d’installation de la ressource.
    object_id L’ID du produit déployé.
    install_status Codé en dur à la valeur : 1= installé.
    operational_status Codé en dur à la valeur : 1= opérationnel.
    deployment_version Version du produit déployé.
    deployment_type Type du produit déployé.

    Relations CI

    Ces relations sont créées pour faciliter Pivotal Cloud Foundry la découverte.

    CI Relation CI
    Espace PCF [cmdb_ci_pcf_space]
    cmdb_ci_pcf_space Contient ::Contenu par cmdb_ci_pcf_organization
    Application PCF [cmdb_ci_pcf_appl]
    cmdb_ci_pcf_appl Contient ::Contenu par cmdb_ci_pcf_space
    Acheminement PCF [cmdb_ci_pcf_route]
    cmdb_ci_pcf_route Contient ::Contenu par cmdb_ci_pcf_foundation
    Quota PCF [cmdb_ci_pcf_quota]
    cmdb_ci_pcf_quota Utilisations ::Utilisé par cmdb_ci_pcf_space

    cmdb_ci_pcf_organization

    Domaine PCF [cmdb_ci_pcf_domain]
    cmdb_ci_pcf_domain Utilisations ::Utilisé par cmdb_ci_pcf_route
    Possède ::Appartient à cmdb_ci_pcf_organization
    Contient ::Contenu par cmdb_ci_pcf_foundation
    Instance d’espace PCF [cmdb_ci_pcf_space_instance]
    cmdb_ci_pcf_space_instance Contient ::Contenu par cmdb_ci_pcf_space
    Plan de service PCF [cmdb_ci_pcf_service_plan]
    cmdb_ci_pcf_service_plan Utilisations ::Utilisé par cmdb_ci_pcf_space_instance
    Service PCF [cmdb_ci_pcf_service]
    cmdb_ci_pcf_service Utilisations ::Utilisé par cmdb_ci_pcf_service_plan
    Gouttelette PCF [cmdb_ci_pcf_droplet]
    cmdb_ci_pcf_appl Contient ::Contenu par cmdb_ci_pcf_droplet
    Valeur clé [cmdb_key_value]
    cmdb_key_value Référence uniquement.

    Par exemple : configuration_item

    cmdb_ci_pcf_droplet
    cmdb_key_value Référence uniquement.

    Par exemple : configuration_item

    cmdb_ci_pcf_organization
    cmdb_key_value Référence uniquement.

    Par exemple : configuration_item

    cmdb_ci_pcf_space
    cmdb_key_value Référence uniquement.

    Par exemple : configuration_item

    cmdb_ci_pcf_domain
    cmdb_key_value Référence uniquement.

    Par exemple : configuration_item

    cmdb_ci_pcf_route
    cmdb_key_value Référence uniquement.

    Par exemple : configuration_item

    cmdb_ci_pcf_appl
    cmdb_key_value Référence uniquement.

    Par exemple : configuration_item

    cmdb_ci_pcf_service
    cmdb_key_value Référence uniquement.

    Par exemple : configuration_item

    cmdb_ci_pcf_service_plan
    cmdb_key_value Référence uniquement.

    Par exemple : configuration_item

    cmdb_ci_pcf_space_instance

    Pivotal Cloud Foundry Relations BOSH

    Ces relations sont créées pour prendre en charge Pivotal Cloud Foundry la découverte de section d’extension BOSH.

    CI Relation CI

    Grappe CloudFoundry [cmdb_ci_pcf_foundation]

    Contient ::Contenu par

    Déploiement BOSH [cmdb_ci_bosh_deployment]