MobileFirst Server mit Scripts in einem IBM Cloud-Kubernetes-Cluster einrichten

Ordner bmx-kubernetes

Dieser Ordner enthält die Anpassungsdateien und Scripts für die Implementierung eines Kubernetes-Clusters mit dem Container-Service von IBM Cloud.

Dockerfile-mfpf-analytics und Dockerfile-mfpf-server

• Dockerfile-mfpf-server: Textdokument mit allen Befehlen, die für das Erstellen des MobileFirst-Server-Image erforderlich sind.
• Dockerfile-mfpf-analytics: Textdokument mit allen Befehlen, die für das Erstellen des MobileFirst-Analytics-Image erforderlich sind.
• Ordner scripts: Dieser Ordner enthält den Ordner args mit einer Reihe von Konfigurationsdateien. Er enthält außerdem die erforderlichen Scripts für die Anmeldung bei IBM Cloud, die Erstellung eines Image für MobileFirst Server bzw. MobileFirst Analytics und die Push-Übertragung und Ausführung des Image in IBM Cloud. Sie können diese Scripts interaktiv ausführen oder die Konfigurationsdateien wie weiter unten erläutert für die Ausführung der Scripts vorkonfigurieren. Anders als bei den anpassbaren Dateien args/*.properties dürfen Sie in diesem Ordner keine Elemente modifizieren. Verwenden Sie das Befehlszeilenargument -h oder --help, um einen Hilfetext zur Scriptsyntax abzurufen (z. B. Scriptname.sh --help).
• Ordner usr-mfpf-server und usr-mfpf-analytics:
  • Ordner bin: Enthält die Scriptdatei (mfp-init), die beim Start des Containers ausgeführt wird. Sie können eigenen Code hinzufügen, der ausgeführt werden soll.
  • Ordner config: Für MobileFirst Server bzw. MobileFirst Analytics verwendete Serverkonfigurationsfragmente (Keystore, Servereigenschaften, Benutzerregistry)
  • keystore.xml: Konfiguration des Repositorys mit Sicherheitszertifikaten für die SSL-Verschlüsselung. Im Ordner ./usr/security muss auf die aufgelisteten Dateien verwiesen werden.
  • ltpa.xml: Konfigurationsdatei mit der Definition des LTPA-Schlüssels und des zugehörigen Kennworts
  • mfpfproperties.xml - Konfigurationseigenschaften für MobileFirst Server und MobileFirst Analytics. Informieren Sie sich anhand der folgenden Dokumentationsabschnitte über die unterstützten Eigenschaften:
    • Liste der JNDI-Eigenschaften für den MobileFirst-Server-Verwaltungsservice
    • Liste der JNDI-Eigenschaften für die MobileFirst-Laufzeit
  • mfpfsqldb.xml: JDBC-Datenquellendefinition für die Verbindung zur Db2- oder dashDB-Datenbank
  • registry.xml: Benutzerregistrykonfiguration. Als Standardkonfiguration wird eine auf XML basierende Basisbenutzerregistrykonfiguration (basicRegistry) bereitgestellt. Sie können Namen und Kennwörter für basicRegistry konfigurieren oder ldapRegistry konfigurieren.
  • tracespec.xml: Tracespezifikation, um ein Debug zu ermöglichen, sowie Protokollierungsstufen
• Ordner jre-security: Sie können die sicherheitsrelevanten JRE-Dateien (Truststore, JAR-Richtliniendateien usw.) aktualisieren, indem Sie sie in diesen Ordner stellen. Die Dateien aus diesem Ordner werden in den Ordner JAVA_HOME/jre/lib/security/ des Containers kopiert.
• Ordner security: Wird verwendet, um die Keystore-Datei, die Truststore-Datei und die LTPA-Schlüsseldatei (ltpa.keys) zu speichern.
• Ordner env: Enthält die Umgebungseigenschaften für die Serverinitialisierung (server.env) sowie angepasste JVM-Optionen (jvm.options).



Für eine Liste unterstützter Serverumgebungseigenschaften hier klicken

Eigenschaft	Standardwert	Beschreibung
MFPF_SERVER_HTTPPORT	9080*	Port für Client-HTTP-Anforderungen. Mit -1 können Sie diesen Port inaktivieren.
MFPF_SERVER_HTTPSPORT	9443*	Port für Client-HTTP-Anforderungen, die mit SSL (HTTPS) geschützt werden. Mit -1 können Sie diesen Port inaktivieren.
MFPF_ADMIN_ROOT	mfpadmin	Kontextstammverzeichnis, in dem die MobileFirst-Server-Verwaltungsservices verfügbar gemacht werden
MFPF_CONSOLE_ROOT	mfpconsole	Kontextstammverzeichnis, in dem die MobileFirst Operations Console verfügbar gemacht wird
MFPF_ADMIN_GROUP	mfpadmingroup	Name der Benutzergruppe, der die vordefinierte Rolle mfpadmin zugeordnet ist
MFPF_DEPLOYER_GROUP	mfpdeployergroup	Name der Benutzergruppe, der die vordefinierte Rolle mfpdeployer zugeordnet ist
MFPF_MONITOR_GROUP	mfpmonitorgroup	Name der Benutzergruppe, der die vordefinierte Rolle mfpmonitor zugeordnet ist
MFPF_OPERATOR_GROUP	mfpoperatorgroup	Name der Benutzergruppe, der die vordefinierte Rolle mfpoperator zugeordnet ist
MFPF_SERVER_ADMIN_USER	WorklightRESTUser	Liberty-Serveradministrator für die MobileFirst-Server-Verwaltungsservices
MFPF_SERVER_ADMIN_PASSWORD	mfpadmin. Vor der Implementierung in einer Produktionsumgebung müssen Sie den Standardwert durch ein privates Kennwort ersetzen.	Kennwort des Liberty-Serveradministrators für die MobileFirst-Server-Verwaltungsservices


Abschnitt schließen

Für eine Liste unterstützter Analytics-Umgebungseigenschaften hier klicken

Eigenschaft	Standardwert	Beschreibung
ANALYTICS_SERVER_HTTP PORT	9080*	Port für Client-HTTP-Anforderungen. Mit -1 können Sie diesen Port inaktivieren.
ANALYTICS_SERVER_HTTPS PORT	9443*	Port für Client-HTTP-Anforderungen. Mit -1 können Sie diesen Port inaktivieren.
ANALYTICS_ADMIN_GROUP	analyticsadmingroup	Name der Benutzergruppe mit der vordefinierten Rolle worklightadmin


Abschnitt schließen
• Ordner dependencies: Enthält die Laufzeit der Mobile Foundation und IBM Java JRE 8
• Ordner mfpf-libs: Enthält die Bibliotheken für die MobileFirst-Produktkomponenten und die CLI

Abschnitt schließen

Der Ordner args enthält Konfigurationsdateien mit den Argumenten, die zum Ausführen der Scripts erforderlich sind. Tragen Sie die Argumentwerte in den folgenden Dateien ein:

initenv.properties

• IBM_CLOUD_API_URL - Zielgeografie oder -region für die Implementierung
  

  Beispiel: api.ng.bluemix.net für die USA oder api.eu-de.bluemix.net für Deutschland oder api.au-syd.bluemix.net für Sydney

• IBM_CLOUD_ACCOUNT_ID - Ihre Konto-ID in Form eines alphanumerischen Wertes wie a1b1b111d11e1a11d1fa1cc999999999
  Mit dem Befehl bx target können Sie die Konto-ID abrufen.
• IBM_CLOUD_USER - Ihr IBM Cloud-Benutzername (E-Mail-Adresse)
• IBM_CLOUD_PASSWORD - Ihr IBM Cloud-Kennwort
• IBM_CLOUD_ORG - Ihr IBM Cloud-Organisationsname
• IBM_CLOUD_SPACE - Ihr IBM Cloud-Bereich (wie oben erläutert)

prepareserverdbs.properties

Der Mobile Foundation Service erfordert eine externe Instanz von Db2 on Cloud.

Hinweis: Sie können auch Ihre eigene Db2-Datenbank verwenden. Der IBM Cloud-Kubernetes-Cluster muss für eine Verbindung zu der Datenbank konfiguriert werden.

Wenn Sie Ihre Db2-Instanz eingerichtet haben, geben Sie die folgenden erforderlichen Argumente an:

• DB_TYPE - dashDB (wenn Sie Db2 on Cloud verwenden) oder DB2 (wenn Sie Ihre eigene Db2-Datenbank verwenden)
• Bei Verwendung einer eigenen Db2-Datenbank (d. h. DB_TYPE=DB2) machen Sie folgende Angaben:
  • DB2_HOST - Hostname in Ihrem Db2-Setup
  • DB2_DATABASE - Name der Datenbank
  • DB2_PORT - Port für die Verbindung zur Datenbank
  • DB2_USERNAME - Db2-Datenbankbenutzer (der berechtigt sein muss, Tabellen im bereitgestellten Schema zu erstellen oder beim Fehlen eines Schemas ein Schema zu erstellen)
  • DB2_PASSWORD - Kennwort des Db2-Benutzers
• Wenn Sie Db2 on Cloud verwenden (d. h. DB_TYPE=dashDB), machen Sie folgende Angaben:
  • ADMIN_DB_SRV_NAME - Name Ihrer dashDB-Serviceinstanz für das Speichern von Verwaltungsdaten
  • RUNTIME_DB_SRV_NAME - Name Ihrer dashDB-Serviceinstanz für das Speichern von Laufzeitdaten. Der Standardwert ist der Name des Verwaltungsservice.
  • PUSH_DB_SRV_NAME - Name Ihrer dashDB-Serviceinstanz für das Speichern von Laufzeitdaten. Der Standardwert ist der Name des Verwaltungsservice.
• ADMIN_SCHEMA_NAME - Name Ihres Schemas für Verwaltungsdaten. Der Standardwert ist MFPDATA.
• RUNTIME_SCHEMA_NAME - Name Ihres Schemas für Laufzeitdaten. Der Standardwert ist MFPDATA.
• PUSH_SCHEMA_NAME - Name Ihres Schemas für Laufzeitdaten. Der Standardwert ist MFPDATA.

Hinweis: Wenn Ihr Db2-Datenbankservice von vielen Benutzern oder mehreren Mobile-Foundation-Implementierungen gemeinsam genutzt wird, stellen Sie sicher, dass eindeutige Schemanamen angegeben werden.

prepareserver.properties

• SERVER_IMAGE_TAG - Ein Tag für das Image. Der Tag sollte das Format registry-url/namespace/image:tag haben.
• ANALYTICS_IMAGE_TAG - Ein Tag für das Image. Der Tag sollte das Format registry-url/namespace/image:tag haben.

Beispiel: registry.ng.bluemix.net/myuniquenamespace/mymfpserver:v1
Wenn Sie noch keinen Docker-Registry-Namespace erstellt haben, erstellen Sie ihn mit einem der folgenden Befehle:


• bx cr namespace-add myuniquenamespace
• bx cr namespace-list

Die folgenden Anweisungen demonstrieren die Ausführung der Scripts unter Verwendung der Konfigurationsdateien. Eine Liste mit Befehlszeilenargumenten für einen nicht interaktiven Modus wird ebenfalls bereitgestellt.

1. initenv.sh – Anmeldung bei IBM Cloud
   Führen Sie das Script initenv.sh aus, um eine Umgebung für die Erstellung und Ausführung von Mobile Foundation in IBM Containern zu erstellen: Interaktiver Modus

   ./initenv.sh

   Nicht interaktiver Modus

   ./initenv.sh args/initenv.properties

2. prepareserverdbs.sh - Erstellung der MobileFirst-Server-Datenbank
   Das Script prepareserverdbs.sh wird verwendet, um Ihren MobileFirst Server mit dem Db2-Datenbankservice zu konfigurieren. Die Instanz des Db2-Service muss in der Organisation und dem Bereich verfügbar sein, bei denen Sie sich in Schritt 1 angemeldet haben. Führen Sie Folgendes aus: Interaktiver Modus

   ./prepareserverdbs.sh

   Nicht interaktiver Modus

   ./prepareserverdbs.sh args/prepareserverdbs.properties

3. initenv.sh (optional) – Anmeldung bei IBM Cloud
   Dieser Schritt ist nur erforderlich, wenn Sie Ihre Container in einer Organisation und einem Bereich ohne verfügbare Db2-Serviceinstanz erstellen müssen. Wenn das der Fall ist, aktualisieren Sie die Datei initenv.properties mit der neuen Organisation und dem neuen Bereich, in denen die Container erstellt (und gestartet) werden müssen. Führen Sie dann erneut das Script initenv.sh aus:

   ./initenv.sh args/initenv.properties

4. prepareserver.sh - Erstellung eines MobileFirst-Server-Image
   Führen Sie das Script prepareserver.sh aus, um ein MobileFirst-Server-Image und ein MobileFirst-Analytics-Image zu erstellen und per Push-Operation in Ihr IBM Cloud-Repository zu übertragen. Wenn Sie alle verfügbaren Images in Ihrem IBM Cloud-Repository anzeigen möchten, führen Sie bx cr image-list aus.
   Die Liste enthält den Image-Namen, das Erstellungsdatum und die ID.
   Interaktiver Modus

   ./prepareserver.sh

   Nicht interaktiver Modus

   ./prepareserver.sh args/prepareserver.properties

5. Implementieren Sie MobileFirst Server und MobileFirst Analytics in Docker-Containern eines Kubernetes-Clusters mit dem Container-Service von IBM Cloud.
   1. Legen Sie Ihren Cluster als Terminalkontext fest:
      bx cs cluster-config my-cluster
      Führen Sie den folgenden Befehl aus, um Ihren Clusternamen zu erfahren:
      bx cs clusters
      In der Ausgabe wird der Pfad zu Ihrer Konfigurationsdatei als Befehl zum Definieren einer Umgebungsvariablen angezeigt. Beispiel:
      export KUBECONFIG=/Users/ibm/.bluemix/plugins/container-service/clusters/my-cluster/kube-config-prod-dal12-my-cluster.yml
      Kopieren Sie den obigen Befehl. Ersetzen Sie my-cluster durch Ihren Clusternamen und fügen Sie den Befehl dann ein, um die Umgebungsvariable für Ihr Terminal festzulegen. Drücken Sie abschließend die Eingabetaste.
   2. [Mandatory for MobileFirst Analytics]: Erstellen Sie ein Persistent Volume Claim (eine Anforderung für einen persistenten Datenträger) zum persistenten Speichern von Analysedaten. Dieser Schritt muss nur einmal ausgeführt werden. Falls Sie bereits ein Persistent Volume Claim (Anforderung für einen persistenten Datenträger) erstellt hatten, können Sie diese Anforderung wiederverwenden. Bearbeiten Sie die yaml-Datei args/mfpf-persistent-volume-claim.yaml und führen Sie den Befehl aus. Alle Variablen müssen vor Ausführung des folgenden Befehls kubectl durch die entsprechenden Werte ersetzt werden.
      kubectl create -f ./args/mfpf-persistent-volume-claim.yaml
      Notieren Sie den Namen des Persistent Volume Claim. Sie müssen ihn in einem nachfolgenden Schritt angeben.
   3. Führen Sie den folgenden Befehl aus, um Ihre Ingress Domain (Zugangsdomäne) abzurufen:
      bx cs cluster-get my-cluster
      Notieren Sie Ihre Zugangsdomäne. Wenn Sie TLS konfigurieren müssen, notieren Sie den geheimen Zugangsschlüssel (Ingress Secret).
   4. Erstellen Sie die Kubernetes-Implementierungen.
      Bearbeiten Sie die yaml-Datei args/mfpf-deployment-all.yaml. Tragen Sie alle Details ein. Alle Variablen müssen vor Ausführung des Befehls kubectl durch die entsprechenden Werte ersetzt werden.
      ./args/mfpf-deployment-all.yaml enthält die Implementierung für Folgendes:
      • Kubernetes-Implementierung für MobileFirst Server, bestehend aus 3 Instanzen (Replikaten), mit einem Hauptspeicher von 1024 MB und einer CPU mit einem Kern
      • Kubernetes-Implementierung für MobileFirst Analytics, bestehend aus 2 Instanzen (Replikaten), mit einem Hauptspeicher von 1024 MB und einer CPU mit einem Kern
      • Kubernetes-Service für MobileFirst Server
      • Kubernetes-Service für MobileFirst Analytics
      • Zugang für das gesamte Setup mit allen REST-Endpunkten für MobileFirst Server und MobileFirst Analytics
      • Konfigurationsübersicht (configMap), um die Umgebungsvariablen in den Instanzen von MobileFirst Server und MobileFirst Analytics verfügbar zu machen
      In der YAML-Datei müssen folgende Werte bearbeitet werden:
      
      1. Verschiedene Vorkommen von my-cluster.us-south.containers.mybluemix.net mit der vom obigen Befehl bx cs cluster-get ausgegebenen Zugangsdomäne (Ingress Domain)
      2. registry.ng.bluemix.net/repository/mfpfanalytics:latest und registry.ng.bluemix.net/repository/mfpfserver:latest - Verwenden Sie zum Hochladen der Images die gleichen Namen wie in prepareserver.sh.
      3. claimName: mfppvc - Verwenden Sie für die Anforderung für einen persistenten Datenträger (Persistent Volume Claim) den Namen, den Sie bei der Erstellung der Anforderung angegeben haben.
         
      Führen Sie den folgenden Befehl aus:
      kubectl create -f ./args/mfpf-deployment-all.yaml

      Hinweis:
      Folgende YAML-Schablonendateien werden bereitgestellt:
      

      • mfpf-deployment-all.yaml: Implementiert MobileFirst Server und MobileFirst Analytics mit HTTP.
      • mfpf-deployment-all-tls.yaml: Implementiert MobileFirst Server und MobileFirst Analytics mit HTTPS.
      • mfpf-deployment-server.yaml: Implementiert MobileFirst Server mit HTTP.
      • mfpf-deployment-analytics.yaml: Implementiert MobileFirst Analytics mit HTTP.

      Nach der Erstellung müssen Sie den folgenden Befehl ausführen, um das Kubernetes-Dashboard verwenden zu können:
      kubectl proxy
      Öffnen Sie localhost:8001/ui in Ihrem Browser.