MobileFirst Application Center in IBM Cloud Private einrichten

improve this page | report issue

Übersicht

Das IBM MobileFirst Application Center kann als Store für Unternehmensanwendungen genutzt werden und bietet Teammitgliedern innerhalb einer Organisation die Möglichkeit des Informationsaustauschs. Das Konzept des Application Center ist mit dem des öffentlichen App Store von Apple oder des Play Store von Android vergleichbar, nur dass das Application Center ausschließlich zur privaten Nutzung innerhalb einer Organisation bestimmt ist. Mithilfe des Application Center können Benutzer innerhalb einer Organisation Anwendungen auf mobile Geräte herunterladen. Das Application Center dient dabei als Repository für mobile Anwendungen. Weitere Informationen zum MobileFirst Application Center finden Sie in der MobileFirst-Application-Center-Dokumentation.

Fahren Sie mit folgenden Abschnitten fort:

Voraussetzungen

Sie müssen über ein IBM Cloud-Private-Konto verfügen und den Kubernetes-Cluster gemäß der Dokumentation in IBM Cloud Private eingerichtet haben.

Sie benötigen eine vorkonfigurierte Datenbank, um MobileFirst-Application-Center-Charts in IBM Cloud Private installieren und konfigurieren zu können. Beim Konfigurieren des MobileFirst-Application-Center-Charts müssen Sie die Datenbankinformationen angeben. Die für das MobileFirst Application Center erforderlichen Tabellen werden in dieser Datenbank erstellt.

Unterstützte Datenbanken: DB2, Oracle, MySQL, PostgreSQL.

Für die Verwaltung von Containern und Images müssen Sie im Rahmen des IBM Cloud-Private-Setups die folgenden Tools auf Ihrer Hostmaschine installieren:

  • Docker
  • IBM Cloud-CLI (cloudctl)
  • Kubernetes-CLI (kubectl)
  • Helm (helm)

IBM Passport-Advantage-Archiv mit dem MobileFirst Application Center herunterladen

Das Passport-Advantage-Archiv mit dem MobileFirst Application Center ist hier verfügbar. Das Passport-Advantage-Archiv mit der Mobile Foundation enthält die Docker-Images und Helm-Charts für die folgenden Komponenten der Mobile Foundation:

  • MobileFirst Server
  • MobileFirst Analytics
  • MobileFirst Application Center

Vorläufige Fixes für das MobileFirst Application Center können über IBM Fix Central abgerufen werden.

IBM Passport-Advantage-Archiv mit dem MobileFirst Application Center in IBM Cloud Private laden

Bevor Sie das Passport-Advantage-Archiv mit der Mobile Foundation laden, müssen Sie Docker einrichten. Anweisungen finden Sie hier.

Führen Sie die nachstehenden Schritte aus, um das Passport-Advantage-Archiv in den IBM Cloud-Private-Cluster zu laden:

  1. Melden Sie sich mit dem IBM Cloud-ICP-Plug-in (cloudctl) beim Cluster an.

    Lesen Sie die CLI-Befehlsreferenz in der Dokumentation zu IBM Cloud Private.

    Beispiel:

     cloudctl login -a https://<IP-Adresse>:<Port>
    

    Falls Sie die SSL-Validierung übergehen möchten, können Sie im obigen Befehl die Option --skip-ssl-validation verwenden. Bei Verwendung dieser Option werden Sie zur Eingabe von Benutzername und Kennwort Ihres Clusterendpunkts aufgefordert. Fahren Sie nach erfolgreicher Anmeldung mit den nachstehenden Schritten fort.

  2. Laden Sie mit folgendem Befehl das Passport-Advantage-Archiv mit der Mobile Foundation:
     cloudctl load-ppa-archive --archive <Archivname> [--clustername <Clustername>] [--namespace <Namespace>]
    

    Der Archivname für die Mobile Foundation ist der Name des Archivs, den Sie über IBM Passport Advantage heruntergeladen haben.

    Sie können --clustername ignorieren, wenn Sie den vorherigen Schritt ausgeführt und den Clusterendpunkt zum Standard für cloudctl gemacht haben.

  3. Synchronisieren Sie nach dem Laden des Passport-Advantage-Archivs die Repositorys, um sicherzustellen, dass die Helm-Charts im Katalog aufgelistet werden. Diesen Schritt können Sie in der Managementkonsole von IBM Cloud Private ausführen.
    • Wählen Sie Admin > Repositories aus.
    • Klicken Sie auf Synch Repositories.
  4. Sie können die Docker-Images und Helm-Charts in der Managementkonsole von IBM Cloud Private anzeigen.
    Gehen Sie zum Anzeigen von Docker-Images wie folgt vor:
    • Wählen Sie Platform > Images aus.
    • Helm-Charts werden im Katalog (Catalog) angezeigt.

Nach Ausführung der obigen Schritte sehen Sie die hochgeladene Version der -Helm-Charts im ICP-Katalog. Das MobileFirst Application Center erscheint im Katalog als ibm-mfpf-appcenter-prod.

Umgebungsvariablen für das MobileFirst Application Center

In der folgenden Tabelle sind die im MobileFirst Application Center in IBM Cloud Private verwendeten Umgebungsvariablen angegeben.

Qualifikationsmerkmal Parameter Definition Zulässiger Wert
arch   Worker node architecture Worker-Knotenarchitektur, in der dieses Chart implementiert werden soll. Derzeit wird nur die Plattform AMD64 unterstützt.
image pullPolicy Richtlinie für Image-Übertragung per Pull-Operation Standardeinstellung: IfNotPresent
  name Docker image name Name des Docker-Image für das MobileFirst Application Center
  tag Docker image tag Siehe Docker tag description
mobileFirstAppCenterConsole user Benutzername für die MobileFirst-Application-Center-Konsole  
  password Kennwort für die MobileFirst-Application-Center-Konsole  
existingDB2Details appCenterDB2Host IP-Adresse des DB2-Servers, auf dem die MobileFirst-Application-Center-Datenbank konfiguriert wird  
  appCenterDB2Port Port der eingerichteten DB2-Datenbank  
  appCenterDB2Database Name der zu verwendenden Datenbank Die Datenbank muss zuvor erstellt worden sein.
  appCenterDB2Username DB2-Benutzername für den Zugriff auf die DB2-Datenbank Der Benutzer sollte Zugriff haben, um Tabellen zu erstellen und ein Schema zu erstellen, falls es noch nicht vorhanden ist.
  appCenterDB2Password DB2-Kennwort für die angegebene Datenbank  
  appCenterDB2Schema Zu erstellendes DB2-Schema für das Application Center  
  appCenterDB2ConnectionIsSSL DB2-Verbindungstyp Geben Sie an, ob Ihre Datenbankverbindung über http oder https erfolgen muss. Der Standardwert ist false (http). Stellen Sie sicher, dass der DB2-Port für denselben Verbindungsmodus konfiguriert ist.
keystores keystoresSecretName Unter Helm-Charts für die IBM Mobile Foundation installieren und konfigurieren sind die Schritte für die Erstellung des geheimen Schlüssels mit den Keystores und den zugehörigen Kennwörtern beschrieben.  
resources limits.cpu Maximal zulässige CPU-Kapazität Standardeinstellung: 1000m
Weitere Informationen finden Sie hier.
  limits.memory Maximal zulässige Speicherkapazität Standardeinstellung: 1024Mi
Weitere Informationen finden Sie hier.
resources.requests requests.cpu Beschreibt die erforderliche CPU-Mindestkapazität. Wenn keine Angabe gemacht wird, wird standardmäßig limits verwendet (falls angegeben) oder ein anderweitig für die Implementierung definierter Wert. Standardeinstellung: 1000m
  requests.memory Beschreibt die erforderliche Mindestspeicherkapazität. Wenn keine Angabe gemacht wird, wird standardmäßig limits verwendet (falls angegeben) oder der für die Implementierung definierte Wert. Standardeinstellung: 1024Mi

MobileFirst Application Center installieren und konfigurieren

Bevor Sie das MobileFirst Application Center installieren und konfigurieren, benötigen Sie Folgendes:

  • [Obligatorisch] eine konfigurierte und betriebsbereite DB2-Datenbank. Sie benötigen die Datenbankinformationen für die Konfiguration des MobileFirst-Server-Helm-Charts. MobileFirst Server erfordert ein Schema und Tabellen, die in dieser Datenbank erstellt werden (falls sie nicht vorhanden sind).

  • [Optional] einen geheimen Schlüssel mit Ihrem Keystore und Truststore. Sie können Ihren eigenen Keystore und Truststore für die Implementierung angeben, indem Sie mit Ihrem eigenen Keystore und Truststore einen geheimen Schlüssel erstellen.

    Führen Sie vor der Installation die folgenden Schritte aus:

    • Erstellen Sie mit den Dateien keystore.jks, keystore-password.txt, truststore.jks, truststore-password.txt einen geheimen Schlüssel und geben Sie im Feld keystores.keystoresSecretName den Namen des geheimen Schlüssels an.

    • Speichern Sie die Datei keystore.jks mit dem zugehörigen Kennwort in einer Datei mit dem Namen keystore-password.txt und die Datei truststore.jks mit dem zugehörigen Kennwort in einer Datei mit dem Namen truststore-password.jks.

    • Rufen Sie die Befehlszeile auf und führen Sie Folgendes aus:
      kubectl create secret generic mfpf-cert-secret --from-file keystore-password.txt --from-file truststore-password.txt --from-file keystore.jks --from-file truststore.jks
      

      Hinweis: Die Namen der Dateien sollten wie angegeben lauten, d. h. keystore.jks, keystore-password.txt, truststore.jks und truststore-password.txt.

    • Geben Sie den Namen des geheimen Schlüssels in keystoresSecretName an, um die Standard-Keystores außer Kraft zu setzen.

    Weitere Informationen finden Sie unter Keystore für MobileFirst Server konfigurieren.

Führen Sie die folgenden Schritte aus, um das IBM MobileFirst Application Center in der Managementkonsole von IBM Cloud Private zu installieren und zu konfigurieren.

  1. Navigieren Sie in der Managementkonsole zu Catalog.
  2. Wählen Sie das Helm-Chart ibm-mfpf-appcenter-prod aus.
  3. Klicken Sie auf Configure.
  4. Geben Sie die Umgebungsvariablen an. Weitere Informationen finden Sie unter Umgebungsvariablen für das MobileFirst Application Center.
  5. Klicken Sie auf Install.

Installation überprüfen

Nachdem Sie MobileFirst Analytics (optional) und MobileFirst Server installiert und konfiguriert haben, können Sie wie folgt Ihre Installation und den Status der implementierten Pods überprüfen:

Wählen Sie in der Managementkonsole von IBM Cloud Private Workloads > Helm Releases aus. Klicken Sie auf den Releasenamen für Ihre Installation.

Zugriff auf das MobileFirst Application Center

Nach der erfolgreichen Installation des Helm-Charts für das MobileFirst Application Center können Sie in einem Browser mit <Protokoll>://<externe_IP-Adresse>:<Port>/appcenterconsole auf die MobileFirst-Application-Center-Konsole zugreifen.

Das Protokoll kann http oder https sein. Beachten Sie außerdem, dass der Port im Falle einer NodePort-Implementierung NodePort lautet. Führen Sie die folgenden Schritte aus, um die IP-Adresse und den NodePort Ihres installierten MobileFirst-Application-Center-Charts zu erhalten:

  1. Wählen Sie in der Managementkonsole von IBM Cloud Private Workloads > Helm Releases aus.
  2. Klicken Sie auf den Releasenamen für Ihre Helm-Chart-Installation.
  3. Lesen Sie die Informationen im Abschnitt Hinweise.

Hinweis: Für den Zugriff auf den mobilen MobileFirst-Application-Center-Client müssen Sie das Application-Center-Paket über Passport Advantage herunterladen. Hier finden Sie weitere Informationen.

Upgrade für -Helm-Charts und -Releases

Unter Upgrading bundled products finden Sie Anweisungen zur Durchführung eines Upgrades für Helm-Charts bzw. Releases.

Beispielszenarien für Helm-Release-Upgrades

  1. Für das Upgrade eines Helm-Release mit einer Änderung der Werte von values.yaml können Sie den Befehl helm upgrade mit der Option –set verwenden. Sie können die Option – set mehrfach angeben. Priorität erhält die in der Befehlszeile ganz rechts angegebene Option “set”.
      helm upgrade --set <Name>=<Wert> --set <Name>=<Wert> <Name_des_vorhandenen_Helm-Release> <Pfad_des_neuen_Helm-Charts>
    
  2. Wenn Sie ein Upgrade für ein Helm-Release mit Angabe von Werten in einer Datei durchführen, verwenden Sie den Befehl helm upgrade mit der Option -f. Sie können die Option –values oder -f mehrfach verwenden. Priorität erhält die in der Befehlszeile ganz rechts angegebene Datei (Option “-f”). Wenn im folgenden Beispiel sowohl myvalues.yaml als auch override.yaml einen Schlüssel Test enthält, hat der in override.yaml festgelegte Wert Vorrang.
      helm upgrade -f myvalues.yaml -f override.yaml <Name_des_vorhandenen_Helm-Release> <Pfad_des_neuen_Helm-Charts>
    
  3. Wenn Sie ein Upgrade für ein Helm-Release durchführen und dabei die Werte des letzten Release wiederverwenden und einige der Werte überschreiben möchten, können Sie einen Befehl wie den folgenden verwenden:
      helm upgrade --reuse-values --set <Name>=<Wert> --set <Name>=<Wert> <Name_des_vorhandenen_Helm-Release> <Pfad_des_neuen_Helm-Charts>
    

Deinstallation

Verwenden Sie zum Deinstallieren des MobileFirst Application Center die Helm-CLI. Mit dem folgenden Befehl werden die installierten Charts und die zugehörigen Implementierungen vollständig gelöscht:

helm delete --purge <Releasename>

Hier steht Releasename für den implementierten Releasenamen des Helm-Charts.

Referenzinformationen

Weitere Informationen zum MobileFirst Application Center finden Sie hier.

Inclusive terminology note: The Mobile First Platform team is making changes to support the IBM® initiative to replace racially biased and other discriminatory language in our code and content with more inclusive language. While IBM values the use of inclusive language, terms that are outside of IBM's direct influence are sometimes required for the sake of maintaining user understanding. As other industry leaders join IBM in embracing the use of inclusive language, IBM will continue to update the documentation to reflect those changes.
Last modified on February 27, 2020