Pivotal Cloud Foundry Discovery

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 6 Minuten Lesedauer

    • Die ServiceNow DiscoveryAnwendungsfunde Pivotal Cloud Foundry(PCF) Version 3-Komponenten, die verwenden Pivotal Cloud FoundryMuster. Um einige dieser Ressourcen zu erkennen, muss aktualisiert werden Muster für Discovery und Service-MappingAnwendung von ServiceNow Store.

    Sie können dieses Muster für verwenden Now Platform Kingston-Version wird gestartet .

    Die Discovery von PCF V3-Komponenten wird unterstützt, wenn Muster für Discovery und Service-MappingPlugin-Version 1,0.99, März 2023 ist installiert. Das Muster unterstützt weiterhin die Discovery von PCF V2-Komponenten.

    Apps im Store anfordern

    Besuchen Sie die ServiceNow Store-Website, um alle verfügbaren Apps anzuzeigen und Informationen zum Senden von Anforderungen an den Store zu erhalten. Kumulative Informationen zum Release für alle veröffentlichten Apps finden Sie in den Release-Hinweisen zum ServiceNow Store-Versionsverlauf.

    Voraussetzungen

    Pivotal Cloud Foundry Anmeldeinformationen
    Erstellen Sie Pivotal Cloud FoundryAnmeldeinformationen.
    1. Navigieren zu Discovery > Anmeldeinformationenan.
    2. Wählen Sie Neu.
    3. Wählen Sie Aus CloudFoundry-Anmeldeinformationen .
    4. Füllen Sie die Felder des Formulars aus.
      Feld Beschreibung
      Name Anmeldeinformationsname. Beispiel: pcf_user-Anmeldeinformationen
      Aktiv Option zum Aktivieren dieser Anmeldeinformationen für die Discovery. Aktivieren Sie dieses Kontrollkästchen, um die Discovery zu aktivieren.
      Beschreibung Anmeldeinformationen, auf die Sie sich bewerben möchten oder nicht Alle MID-Server In Ihrem Netzwerk oder in einem oder mehreren Bestimmte MID-Server . Wählen Sie Aus Bestimmte MID-Server .
      Bestellung Reihenfolge, in der die Plattform diese Anmeldeinformationen versucht, während sie versucht, sich bei Geräten anzumelden. Eine kleinere Zahl gibt an, dass die Anmeldeinformationen in der Liste höher erscheinen. Legen Sie die Anmeldeinformationsreihenfolge fest, wenn Sie eine große Anzahl von Anmeldeinformationen verwenden oder Anwender nach drei fehlgeschlagenen Anmeldungsversuchen aus der Sicherheit aussperrt werden. Wenn alle Anmeldeinformationen dieselbe Ordnungsnummer haben oder keine haben, versucht die Instanz die Anmeldeinformationen in zufälliger Reihenfolge. Der Standardwert ist 100.
      Anwendername Name des Anwenders dieser Anmeldeinformationen. Vermeiden Sie führende oder nachfolgende Leerzeichen in Anwendernamen. Eine Warnung wird angezeigt, wenn die Plattform führende oder nachfolgende Leerzeichen im Anwendernamen erkennt. Ein Beispiel ist pcf_user . Verwenden Sie Client_ID Das zum Generieren des JWT-Tokens verwendet wird.
      Passwort Passwort für den Anwender dieser Anmeldeinformationen. Verwenden Sie Client_Secret Das zum Generieren des JWT-Tokens verwendet wird.
      Anmeldeinformationsalias Alternativer Name für diese Anmeldeinformationen. Beispiel: CF

      Wenn dieses Feld geschlossen ist, wählen Sie das Entsperrungssymbol aus, um das Feld zu entsperren.
    5. Wählen Sie Aktualisieren.
    JSON Webtoken-Anmeldeinformationen
    Um zu verifizieren JSONWebtoken (JWT): Führen Sie die folgenden Token-Validierungsschritte aus.

    Das Format des JWT-Tokens ist: https://docs.cloudfoundry.org/api/uaa/version/4.27.0/index.html#jwt-bearer-token-grant

    1. Führen Sie das folgende Curl-Skript für die UAA-Server-API (Anwenderaccount und Authentifizierung) aus, und überprüfen Sie die Ergebnisse:

      Curl -s -k https://ip_address:port/oauth/token -X; POST -H “Inhaltstyp: Application/x-www-Form-urlencoded” -H “Accept: Application/JSON” -d “Client_ID=<INSERT_USER_HERE>&Client_Secret=<INSERT_PASS_HERE>&Grant_type=Client_credentials&Token_Format=jwt&response_type=Token”

      Wenn dieser Befehl kein Token generiert, überprüfen Sie, ob die Anmeldeinformationen in ServiceNowRepository sind korrekt, andernfalls zu Schritt 2 wechseln.

    2. Führen Sie das folgende Curl-Skript für aus Pivotal Cloud FoundryAPI:

      Curl https://ip_address:port/v3/spaces -k -V -H „Akzeptieren: Anwendung/JSON“ -H „Autorisierung: Bearer<HIER EINFÜGEN>“

      Wenn dieser Befehl die PCF-Bereichsinformationen nicht abruft, überprüfen Sie die Anmeldeinformationen auf ServiceNowAnmeldeinformationen-Repository.

    Anmeldeinformationen für V3-API-Elemente
    Geben Sie einen schreibgeschützten Anwender mit der Berechtigung zur Verwendung der folgenden API-Elemente an:
    • –/v3/Organisationen
    • –/v3/spaces
    • –/v3/Domänen
    • –/v3/Routen
    • –/v3/Organization_Quoten
    • –/v3/space_Quoten
    • –/v3/Apps
    • -/v3/Service_offers
    • -/v3/Service_Plans
    • -/v3/Service_instances
    • -/v3/Droplets
    Hinweis:
    Die Pivotal Cloud FoundryMuster unterstützt auch die PCF V2-APIs.
    Erstellen Sie einen serverlosen DiscoveryZeitplan
    1. Navigieren zu Discovery > Discovery-Zeitplänean.
    2. Wählen Sie Neu.
    3. Füllen Sie die Felder des Formulars aus.
      Tabelle : 1. Discovery Zeitplanformular
      Feld Beschreibung
      Name Geben Sie einen eindeutigen und beschreibenden Namen dafür ein DiscoveryZeitplan, z. B. PCF
      Erkannt Wählen Sie für den Erkennungstyp aus Serverlesss
      MID-Server MID Servers Für die die Anmeldeinformationen gelten. Geben Sie das erforderliche an MID-Server, Beispiel: Discovery_Server
      Aktiv Option zum Aktivieren dieser Anmeldeinformationen für die Discovery. Aktivieren Sie dieses Kontrollkästchen, um die Discovery zu aktivieren.
      Anmeldeinformationsalias Alternativer Name für diese Anmeldeinformationen. Verwenden Sie den Alias, der sich auf bezieht Pivotal Cloud FoundryAnmeldeinformationen, die Sie zuvor erstellt haben.
    4. Klicken Sie mit der rechten Maustaste auf den Header von DiscoveryZeitplanformular, und wählen Sie aus Speichern .

      Serverloses Ausführungsmuster

    5. Wählen Sie die Registerkarte serverlose Ausführungsmuster aus.
    6. Wählen Sie Neu.
    7. Füllen Sie die Felder des Formulars aus.
      Tabelle : 2. Formular „Ausführungsmuster ohne Server“
      Feld Beschreibung
      Name Geben Sie einen eindeutigen und beschreibenden Namen für dieses serverlose Ausführungsmuster ein, z. B. Pcf1
      Muster Wählen Sie Aus CloudFoundry .
      Proxyhost Vollqualifizierter Domänenname des Computers, auf dem Sie den Proxy-Server installieren. Geben Sie An Global .
      Aktiv Kontrollkästchen zum Aktivieren dieses Zeitplans für die Discovery. Aktivieren Sie dieses Kontrollkästchen.
    8. Klicken Sie mit der rechten Maustaste auf den Header des Formulars „Serverlose Ausführungsmuster“, und wählen Sie aus Speichern .
    9. Wählen Sie die Registerkarte serverlose Ausführungsmuster aus
    10. Erstellen und definieren Sie das serverlose Ausführungsmuster, wie in der Produktdokumentation beschrieben.
      Konfigurieren Sie die für erforderlichen Parameter Pivotal Cloud FoundryMuster wie folgt:
      Tabelle : 3. Discovery Muster-Startprogramm-Parameter
      Parameter Beschreibung
      Organisation Name der Organisation, die erkannt werden muss, oder aller, bei denen die Eingabe „*“ ist.
      Anmeldeinformationsalias Alternativer Name für diese Anmeldeinformationen. Verwenden Sie den Alias, der sich auf bezieht Pivotal Cloud FoundryAnmeldeinformationen, die Sie zuvor erstellt haben.
      URL_CF API-URL des Cloud-Controllers, der zum Abrufen der Informationen von verwendet wird Pivotal Cloud Foundry.
      URL_CF_AUTH UAA-Server-API​, die zum Generieren des Tokens verwendet wird. Geben Sie den Wert im folgenden Format ein: https://uaa.sys.dev.phx.pcf.example.com/oauth/token
    11. Aktualisieren .
    12. Navigieren Sie zum Starten der Discovery zu serverlos DiscoveryDefinition und auswählen Jetzt Erkennen .
    EVAL Abschlussfunktionen

    Verwenden Sie Folgendes EVALAbschlussfunktionen zum Verketten aller Organisationen mit „,“ als Trennzeichen.

    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;

    Verwenden Sie Folgendes EVALAbschlussfunktionen, um 1 zurückzugeben, wenn der Betriebsstatus „aktiv“ ist, und 2, wenn er nicht aktiv ist.

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

    Verwenden Sie Folgendes EVALAbschlussfunktion, um 1 zurückzugeben, wenn der Betriebsstatus „gestartet“ ist, und 2, wenn er nicht gestartet wurde.

    var rtrn = '';
var currentAppStatus = ${apps[].state};
var status = currentAppStatus.toLowerCase();
if(status == "started"){
   rtrn = "1";  
}
else {   
   rtrn = "2";   
}
    CloudFoundry – Anruf abrufen
    Der anwenderdefinierte Vorgang „CloudFoundry – Aufruf abrufen“ verarbeitet die Generierung von Token. Verwendet die Anmeldeinformationen und die Kontextvariable URL_CF_AUTH, um ein Token zu generieren, das zum Erstellen von API-Aufrufen verwendet wird.

    Wenn ein Token generiert wird, wird die URL_CF verwendet, um die in definierten API-Aufrufe zu erstellen Ressource Feld. Der anwenderdefinierte Vorgang verarbeitet auch die Paginierung, bei der die Antwort mehr als eine Seite enthält.

    CloudFoundry – Aufruf zum Abrufen analysiert die Eingabe JSONZum Ausfüllen der Tabellen und Variablen.

    Anwenderdefinierter Cloud-Foundry-Vorgang

    Daten erfasst von DiscoveryWährend der horizontalen Discovery

    Tabelle : 4. Gesammelte Informationen
    Feld Beschreibung
    Haupt-CI: PCF-Grundlage [cmdb_ci_pcf_foundation]
    Name Pivotal Cloud Foundry Name des Clustereintrags

    <name>-<hostCf:<portCf>
    ip_address Pivotal Cloud Foundry Host-IP.
    port Pivotal Cloud Foundry Service-Port.
    short_description Pivotal Cloud Foundry Service-Build-Nummer.
    Organisation Organisationsliste, verwaltet vom PCF-Cluster. Die Einträge werden durch ein Kommatrennzeichen „,“ getrennt.
    PCF-Organisation [cmdb_ci_pcf_organization]
    Name Organisationsname
    URL Eindeutige URL der Organisation
    pcf_GUID Organisations-UID in CF
    operational_status Organisationsstatus
    PCF-Bereich [cmdb_ci_pcf_space]
    Name Platzname
    URL Eindeutige Platz-URL
    pcf_GUID Raum-UID in CF
    PCF-Anwendung [cmdb_ci_pcf_appl]
    Name Anwendungsname
    URL Eindeutige URL der Anwendung
    pcf_GUID Anwendungs-UID in CF
    PCF-Route [cmdb_ci_pcf_route]
    Name Routenname
    URL Eindeutige URL weiterleiten
    pcf_GUID Routen-UID in CF
    port Routenport
    Typ Routentyp
    PCF-Quote [cmdb_ci_pcf_quota]
    Name Kontingentname
    URL Eindeutige URL der Quote
    pcf_GUID Kontingent-UID in CF
    PCF-Domäne [cmdb_ci_pcf_domain]
    name Domänenname
    URL Eindeutige Domänen-URL
    pcf_GUID Domänen-UID in CF
    PCF-Bereichsinstanz [cmdb_ci_pcf_space_instance]
    name Name der Bereichsserviceinstanz
    URL Eindeutige URL der Bereichsserviceinstanz
    pcf_GUID Bereichsserviceinstanz-UID in CF
    PCF-Serviceplan [cmdb_ci_pcf_service_plan]
    name Name der Serviceplaninstanz
    URL Serviceplan – eindeutige URL
    pcf_GUID Bereichsserviceinstanz-UID in CF
    PCF-Service [cmdb_ci_pcf_service]
    name Servicename
    URL Eindeutige Service-URL
    pcf_GUID Service-UID in CF
    PCF-Droplet [cmdb_ci_pcf_droplet]
    name Ressourcen-URL
    pcf_GUID Droplet-ID
    URL Droplet-URL
    install_status Installationsstatus: 1, „installiert“
    operational_status Betriebsstatus: 1, „betriebsbereit“
    Schlüsselwert [cmdb_key_value]
    key Ressourcen-Tag-Schlüssel
    Hinweis:
    Diese Daten werden nur für V3-API-Aufrufe erfasst.
    Wert Ressourcen-Tag-Wert.
    Hinweis:
    Diese Daten werden nur für V3-API-Aufrufe erfasst.

    CI-Beziehungen

    Diese Beziehungen werden zur Unterstützung erstellt Pivotal Cloud FoundryDiscovery.

    CI Beziehung CI
    PCF-Bereich [cmdb_ci_pcf_space]
    cmdb_ci_pcf_space Enthält::enthalten von cmdb_ci_pcf_organization
    PCF-Anwendung [cmdb_ci_pcf_appl]
    cmdb_ci_pcf_appl Enthält::enthalten von cmdb_ci_pcf_space
    PCF-Route [cmdb_ci_pcf_route]
    cmdb_ci_pcf_route Enthält::enthalten von cmdb_ci_pcf_foundation
    PCF-Quote [cmdb_ci_pcf_quota]
    cmdb_ci_pcf_quota Verwendet::verwendet von cmdb_ci_pcf_space

    cmdb_ci_pcf_organization
    PCF-Domäne [cmdb_ci_pcf_domain]
    cmdb_ci_pcf_domain Verwendet::verwendet von cmdb_ci_pcf_route
    Besitzt::im Besitz von cmdb_ci_pcf_organization
    Enthält::enthalten von cmdb_ci_pcf_foundation
    PCF-Bereichsinstanz [cmdb_ci_pcf_space_instance]
    cmdb_ci_pcf_space_instance Enthält::enthalten von cmdb_ci_pcf_space
    PCF-Serviceplan [cmdb_ci_pcf_service_plan]
    cmdb_ci_pcf_service_plan Verwendet::verwendet von cmdb_ci_pcf_space_instance
    PCF-Service [cmdb_ci_pcf_service]
    cmdb_ci_pcf_service Verwendet::verwendet von cmdb_ci_pcf_service_plan
    PCF-Droplet [cmdb_ci_pcf_droplet]
    cmdb_ci_pcf_appl Enthält::enthalten von cmdb_ci_pcf_droplet
    Schlüsselwert [cmdb_key_value]
    cmdb_key_value Nur Referenz.

    Beispiel: Configuration_item

    		 cmdb_ci_pcf_droplet
    cmdb_key_value Nur Referenz.

    Beispiel: Configuration_item

    		 cmdb_ci_pcf_organization
    cmdb_key_value Nur Referenz.

    Beispiel: Configuration_item

    		 cmdb_ci_pcf_space
    cmdb_key_value Nur Referenz.

    Beispiel: Configuration_item

    		 cmdb_ci_pcf_domain
    cmdb_key_value Nur Referenz.

    Beispiel: Configuration_item

    		 cmdb_ci_pcf_route
    cmdb_key_value Nur Referenz.

    Beispiel: Configuration_item

    		 cmdb_ci_pcf_appl
    cmdb_key_value Nur Referenz.

    Beispiel: Configuration_item

    		 cmdb_ci_pcf_service
    cmdb_key_value Nur Referenz.

    Beispiel: Configuration_item

    		 cmdb_ci_pcf_service_plan
    cmdb_key_value Nur Referenz.

    Beispiel: Configuration_item

    		 cmdb_ci_pcf_space_instance