Erkennung von Pivotal Cloud Foundry

Die ServiceNow Discovery Anwendungsfunde Pivotal Cloud Foundry(PCF) Komponenten der Version 3, die verwenden Pivotal Cloud Foundry Muster. Um einige dieser Ressourcen zu erkennen, muss aktualisiert werden Muster für Discovery und Service-Mapping Anwendung aus dem ServiceNow Store.

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

Die Discovery von PCF V3-Komponenten wird unterstützt, wenn Muster für Discovery und Service-Mapping Plugin 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 Foundry Anmeldeinformationen.

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	Name der Anmeldeinformationen Beispiel: pcf_user-Anmeldeinformationen
   Aktiv	Option zum Aktivieren dieser Anmeldeinformationen für die Erkennung. Aktivieren Sie dieses Kontrollkästchen, um die Erkennung zu aktivieren.
   Betrifft	Anmeldeinformationen, die Sie auf Alle MID Server in Ihrem Netzwerk oder auf einen oder mehrere Spezielle MID Server anwenden oder nicht anwenden möchten. Wählen Sie Spezielle MID Server aus.
   Reihenfolge	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 eine große Anzahl von Anmeldeinformationen verwendet wird oder wenn die Sicherheit Anwender nach drei fehlgeschlagenen Anmeldeversuchen sperrt. Wenn alle Anmeldeinformationen dieselbe oder keine Nummer für die Reihenfolge haben, geht die Instanz die Anmeldeinformationen in zufälliger Reihenfolge durch. Der Standardwert ist 100.
   Benutzername	Name des Benutzers dieser Anmeldeinformationen. Vermeiden Sie führende oder nachgestellte Leerzeichen in Benutzernamen. Eine Warnung wird angezeigt, wenn die Plattform führende oder nachfolgende Leerzeichen im Anwendernamen erkennt. Ein Beispiel ist pcf_user. Verwenden Sie die client_id, die zum Generieren des JWT-Tokens verwendet wird.
   Passwort	Passwort des Benutzers dieser Anmeldeinformationen. Verwenden Sie das client_secret, das zum Generieren des JWT-Tokens verwendet wird.
   Anmeldeinformationsalias	Alternativer Name für diese Anmeldeinformationen. Ein Beispiel ist cf Wenn dieses Feld geschlossen ist, wählen Sie das Entsperrsymbol, um das Feld zu entsperren.

5. Wählen Sie Aktualisieren.

JSON-Web-Token-Anmeldeinformationen

Führen Sie die folgenden Schritte zur Tokenvalidierung aus, um das JSON-Web-Token (JWT) zu überprüfen.

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 Server-API des Benutzerkontos und der Authentifizierung (UAA) aus, und überprüfen Sie die Ergebnisse:

   curl -s -k https://ip_address:port/oauth/token -X; POST -H ”Content-Type: 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 im enthalten sind ServiceNow Repository sind korrekt, andernfalls mit Schritt 2 fortfahren.

2. Führen Sie das folgende cURL-Skript für die Pivotal Cloud Foundry-API aus:

   Curl https://ip_address:port/v3/spaces -k -V -H „Accept: Application/JSON“ -H „Authorization: Bearer<INSERT TOKEN HERE>“

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

Anmeldeinformationen für V3-API-Elemente

Gewähren Sie einem leseberechtigten Benutzer die Berechtigung zur Verwendung der folgenden API-Elemente.

• –/v3/Organizations
• –/v3/spaces
• –/v3/Domänen
• –/v3/Routen
• –/v3/Organization_Quoten
• –/v3/space_Quoten
• –/v3/Apps
• -/v3/Service_Offerings
• -/v3/Service_Plans
• -/v3/Service_instances
• -/v3/Tröpfchen

Hinweis:

Die Pivotal Cloud Foundry Das Muster unterstützt auch die PCF V2-APIs.

Discovery-Zeitplan ohne Server erstellen

1. Navigieren zu Discovery > Discovery-Zeitplänean.
2. Wählen Sie Neu.
3. Füllen Sie die Felder im Formular aus:

   Tabelle : 1. Formular „Discovery-Zeitplan“

   Feld	Beschreibung
   Name	Geben Sie einen eindeutigen und beschreibenden Namen für diesen Discovery-Zeitplan ein, z. B. pcf.
   Erkennen	Wählen Sie als Erkennungstyp ohne Server aus.
   MID-Server	MID Servers, für die die Anmeldeinformationen gelten. Geben Sie den erforderlichen MID-Server an, z. B. Discovery_Server.
   Aktiv	Option zum Aktivieren dieser Anmeldeinformationen für die Erkennung. Aktivieren Sie dieses Kontrollkästchen, um die Erkennung zu aktivieren.
   Anmeldeinformationsalias	Alternativer Name für diese Anmeldeinformationen. Verwenden Sie den Alias, der sich auf bezieht Pivotal Cloud Foundry Anmeldeinformationen, die Sie zuvor erstellt haben.

4. Klicken Sie mit der rechten Maustaste auf den Header des Formulars „Discovery-Zeitplan“, und wählen Sie Speichern aus.

   

5. Wählen Sie die Registerkarte Ausführungsmuster ohne Server.
6. Wählen Sie Neu.
7. Füllen Sie die Felder im Formular 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 CloudFoundry aus.
   Proxyhost	Vollqualifizierter Domänenname des Computers, auf dem Sie den Proxy-Server installieren. Geben Sie Global an.
   Aktiv	Kontrollkästchen, um diesen Zeitplan für die Erkennung zu aktivieren. Aktivieren Sie das 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 Ausführungsmuster ohne Server wie in der Produktdokumentation beschrieben.
    Konfigurieren Sie die für erforderlichen Parameter Pivotal Cloud Foundry Muster wie folgt:

    Tabelle : 3. Startprogrammparameter für Discovery-Muster

    Parameter	Beschreibung
    Organisation	Name der Organisation, die erkannt werden muss, oder aller, deren Eingabe „*“ ist.
    CredentialAlias	Alternativer Name für diese Anmeldeinformationen. Verwenden Sie den Alias, der sich auf bezieht Pivotal Cloud Foundry Anmeldeinformationen, 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. Führen Sie eine Aktualisierung durch.
12. Um die Discovery zu starten, navigieren Sie zu serverlos Discovery Definition und wählen Sie aus Entdecken Sie Jetzt .

EVAL-Abschlussfunktionen

Verwenden Sie die folgenden EVAL-Abschlussfunktionen, um alle Organisationen mit „,“ als Trennzeichen zu verketten.

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 EVAL Abschlussfunktionen, die 1 zurückgeben, 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 EVAL Abschlussfunktion, um 1 zurückzugeben, wenn der Betriebsstatus „gestartet“ ist, und 2, wenn er nicht gestartet wird.

var rtrn = '';
var currentAppStatus = ${apps[].state};
var status = currentAppStatus.toLowerCase();
if(status == "started"){
   rtrn = "1";  
}
else {   
   rtrn = "2";   
}

CloudFoundry Get Call

Der benutzerdefinierte Vorgang „CloudFoundry Get Call“ behandelt die Generierung von Token. Er 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 URL_CF verwendet, um die im Feld Ressource definierten API-Aufrufe zu erstellen. Der benutzerdefinierte Vorgang behandelt auch die Paginierung, wenn die Antwort mehr als eine Seite umfasst.

CloudFoundry Get Call analysiert die Eingabe JSON, um die Tabellen und Variablen auszufüllen.

Von Discovery während der horizontalen Erkennung erfasste Daten

Tabelle : 4. Erfasste 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 Kommata „,“ getrennt.
PCF-Organisation [cmdb_ci_pcf_Organization]
Name	Organisationsname
URL	Eindeutige Organisations-URL
pcf_guid	Organisations-UID in CF
operational_status	Organisationsstatus
PCF-Bereich [cmdb_ci_pcf_space]
Name	Platzname
URL	Eindeutige Speicherplatz-URL
pcf_guid	Platz-UID in CF
PCF-Anwendung [cmdb_ci_pcf_appl]
Name	Anwendungsname
URL	Eindeutige Anwendungs-URL
pcf_guid	Eindeutige Anwendungs-UID in CF
PCF-Route [cmdb_ci_pcf_Route]
Name	Routenname
URL	Eindeutige Routen-URL
pcf_guid	Routen-UID in CF
port	Routenport
Typ	Routentyp
PCF-Kontingent [cmdb_ci_pcf_Kontingent]
Name	Kontingentname
URL	Eindeutige Kontingent-URL
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 Platzserviceinstanz
URL	Eindeutige Platzserviceinstanz-URL
pcf_guid	UID-Platzserviceinstanz in CF
PCF-Serviceplan [cmdb_ci_pcf_Service_Plan]
name	Name der Serviceplaninstanz
URL	Eindeutige Serviceplan-URL
pcf_guid	UID-Platzserviceinstanz 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, „operativ“
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 sollen die Pivotal Cloud Foundry-Erkennung unterstützen.

CI	Beziehung	CI
PCF-Bereich [cmdb_ci_pcf_space]
cmdb_ci_pcf_space	Enthält::Enthalten in	cmdb_ci_pcf_organization
PCF-Anwendung [cmdb_ci_pcf_appl]
cmdb_ci_pcf_appl	Enthält::Enthalten in	cmdb_ci_pcf_space
PCF-Route [cmdb_ci_pcf_Route]
cmdb_ci_pcf_route	Enthält::Enthalten in	cmdb_ci_pcf_foundation
PCF-Kontingent [cmdb_ci_pcf_Kontingent]
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
	Eigentümer von::Eigentum von	cmdb_ci_pcf_organization
	Enthält::Enthalten in	cmdb_ci_pcf_foundation
PCF-Bereichsinstanz [cmdb_ci_pcf_space_instance]
cmdb_ci_pcf_space_instance	Enthält::Enthalten in	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 in	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