MobileFirst Application Center 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-mfp-appcenter

• Dockerfile-mfp-appcenter: Textdokument mit allen Befehlen, die für das Erstellen des MobileFirst-Application-Center-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 das MobileFirst Application Center 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-mfp-appcenter:
  • Ordner bin: Enthält die Scriptdatei (mfp-appcenter-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 Application Center 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
  • appcentersqldb.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
APPCENTER_SERVER_HTTPPORT	9080*	Port für Client-HTTP-Anforderungen. Mit -1 können Sie diesen Port inaktivieren.
APPCENTER_SERVER_HTTPSPORT	9443*	Port für Client-HTTP-Anforderungen, die mit SSL (HTTPS) geschützt werden. Mit -1 können Sie diesen Port inaktivieren.
APPCENTER_ROOT	applicationcenter	Kontextstammverzeichnis, in dem die Verwaltungsservices für das MobileFirst Application Center verfügbar gemacht werden
APPCENTER_CONSOLE_ROOT	appcenterconsole	Kontextstammverzeichnis, in dem die MobileFirst-Application-Center-Konsole verfügbar gemacht wird
APPCENTER_ADMIN_GROUP	appcenteradmingroup	Name der Benutzergruppe, der die vordefinierte Rolle appcenteradmin zugeordnet ist
APPCENTER_USER_GROUP	appcenterusergroup	Name der Benutzergruppe, der die vordefinierte Rolle appcenteruser zugeordnet ist


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)

prepareappcenterdbs.properties

Das MobileFirst Application Center 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:
  • APPCENTER_DB_SRV_NAME - Name Ihrer dashDB-Serviceinstanz für das Speichern von Application-Center-Daten
• APPCENTER_SCHEMA_NAME - Name Ihres Schemas für Application-Center-Daten. Der Standardwert ist APPCNTR.

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

prepareappcenter.properties

• SERVER_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/myappcenter: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 MobileFirst Application Center in IBM Containern zu erstellen: Interaktiver Modus

   ./initenv.sh

   Nicht interaktiver Modus

   ./initenv.sh args/initenv.properties

2. prepareappcenterdbs.sh - Erstellung der MobileFirst-Application-Center-Datenbank
   Das Script prepareappcenterdbs.sh wird verwendet, um Ihren MobileFirst Application Center 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

   ./prepareappcenterdbs.sh

   Nicht interaktiver Modus

   ./prepareappcenterdbs.sh args/prepareappcenterdbs.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. prepareappcenter.sh - Erstellung eines MobileFirst-Application-Center-Image
   Führen Sie das Script prepareappcenter.sh aus, um das MobileFirst-Application-Center-Image zu erstellen und per Push-Operation in Ihr IBM Cloud-Repository zu stellen. 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

   ./prepareappcenter.sh

   Nicht interaktiver Modus

   ./prepareappcenter.sh args/prepareappcenter.properties

5. Implementieren Sie das MobileFirst Application Center 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. 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).
   3. Erstellen Sie die Kubernetes-Implementierungen.
      Bearbeiten Sie die yaml-Datei args/mfp-deployment-appcenter.yaml. Tragen Sie alle Details ein. Alle Variablen müssen vor Ausführung des Befehls kubectl durch die entsprechenden Werte ersetzt werden.
      ./args/mfp-deployment-appcenter.yaml enthält die Implementierung für Folgendes:
      • Kubernetes-Implementierung für das MobileFirst Application Center, bestehend aus einer Instanz (1 Replikat), mit einem Hauptspeicher von 1024 MB und einer CPU mit einem Kern
      • Kubernetes-Service für MobileFirst Application Center
      • Zugang für das gesamte Setup mit allen REST-Endpunkten für das MobileFirst Application Center
      • Konfigurationsübersicht (configMap), um die Umgebungsvariablen in der MobileFirst-Application-Center-Instanz 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/mfpappcenter:latest - Verwenden Sie zum Hochladen des Image die gleichen Namen wie in prepareappcenter.sh.
      Führen Sie den folgenden Befehl aus:
      kubectl create -f ./args/mfp-deployment-appcenter.yaml

      Hinweis:
      Folgende YAML-Schablonendateien werden bereitgestellt:
      

      • mfp-deployment-appcenter.yaml: Implementiert das MobileFirst Application Center mit HTTP.
      • mfp-deployment-appcenter-with-tls.yaml: Implementiert das MobileFirst Application Center mit HTTPS.

      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.