在 IBM Cloud Private 上设置 MobileFirst Application Center

概述

IBM MobileFirst Application Center 可用作企业应用程序商店，可在组织内的不同团队成员之间共享信息。 Application Center 的概念类似于 Apple 的公共 App Store 或 Android 的 Play Store，只是它仅以组织内专用为目标。 通过使用 Application Center，同一组织内的用户可以从充当移动应用程序存储库的单个位置将应用程序下载到移动设备。 有关 MobileFirst Application Center 的更多信息，请参阅 MobileFirst Application Center 文档。

跳转至：

• 先决条件
• 下载 IBM MobileFirst Application Center Passport Advantage 归档
• 在 IBM Cloud Private 中装入 IBM MobileFirst Application Center PPA 归档
• MobileFirst Application Center 的环境变量
• 安装和配置 MobileFirst Application Center
• 验证安装
• 访问 MobileFirst Application Center
• 升级 Helm Chart 和发行版
• 卸载
• 参考

先决条件

您必须具有 IBM Cloud Private 帐户，并且必须遵循 IBM Cloud Private 中的文档来设置 Kubernetes 集群。

您需要预先配置的数据库以在 IBM Cloud Private 中安装和配置 MobileFirst Application Center Charts。 您将需要提供数据库信息以配置 MobileFirst Application Center helm chart。 将在此数据库中创建 MobileFirst Application Center 所需的表。

受支持的数据库：DB2。

要管理容器和映像，需要在 IBM Cloud Private 设置期间在主机上安装以下工具：

• Docker
• IBM Cloud CLI (bx)
• IBM Cloud Private (ICP) plugin for IBM Cloud CLI (bx pr)
• Kubernetes CLI (kubectl)
• Helm (helm)

下载 IBM MobileFirst Application Center Passport Advantage 归档

此处提供 MobileFirst Application Center 的 Passport Advantage (PPA) 归档。 Mobile Foundation 的 PPA 归档将包含以下 Mobile Foundation 组件的 Docker 映像和 Helm Chart：

• MobileFirst Server
• MobileFirst Analytics
• MobileFirst Application Center

可从 IBM Fix Central 获取 MobileFirst Application Center 的临时修订。

在 IBM Cloud Private 中装入 IBM MobileFirst Application Center PPA 归档

在装入 Mobile Foundation 的 PPA 归档之前，必须设置 Docker。 请参阅此处的指示信息。

遵循以下指定的步骤以将 PPA 归档装入到 IBM Cloud Private 集群：

1. 使用 IBM Cloud ICP 插件 (bx pr) 登录到集群。

   请参阅 IBM Cloud Private 文档中的 CLI 命令参考。

   例如，

    bx pr login -a https://<ip>:<port>
   

   （可选）如果您打算跳过 SSL 验证，请在上述命令中使用标记 --skip-ssl-validation。 使用此选项将提示输入集群端点的 username 和 password。 在成功登录后，继续以下步骤。

2. 使用以下命令装入 Mobile Foundation 的 PPA 归档：

    bx pr load-ppa-archive --archive <archive_name> [--clustername <cluster_name>] [--namespace <namespace>]
   

   Mobile Foundation 的 archive_name 是从 IBM Passport Advantage 下载的 PPA 归档的名称。

   如果已执行先前步骤并将集群端点设置为 bx pr 的缺省值，那么可忽略 --clustername。

3. 在装入 PPA 归档后，同步存储库，这确保在目录中列出 Helm Chart。 您可以在 IBM Cloud Private 管理控制台中执行此操作。
   
   • 选择管理 > 存储库。
   • 单击同步存储库。
4. 然后，您可以在 IBM Cloud Private 管理控制台中查看 Docker 映像和 Helm Chart。
   要查看 Docker 映像，请执行以下操作：
   • 选择平台 > 映像。
   • 在目录中显示 Helm Chart。

在完成上述步骤后，您将看到在 ICP 目录中显示已上载版本的 Helm Chart。 MobileFirst Application Center 在目录中显示为 ibm-mfpf-appcenter-prod。

MobileFirst Application Center 的环境变量

下表提供在 IBM Cloud Private 上的 MobileFirst Application Center 中使用的环境变量。

安装和配置 MobileFirst Application Center

在安装和配置 MobileFirst Application Center 之前，您应具有以下内容：

• [必需] 已配置且可供使用的 DB2 数据库。 您将需要数据库信息以配置 MobileFirst Server helm。 MobileFirst Server 需要将在此数据库中创建（如果不存在）的模式和表。

• [可选] 使用密钥库和信任库的密钥。 您可以通过使用自己的密钥库和信任库来创建密钥，从而为部署提供自己的密钥库和信任库。

  在安装之前，请执行以下步骤：

  • 使用 keystore.jks、keystore-password.txt、truststore.jks 和 truststore-password.txt 创建密钥，并在字段 keystores.keystoresSecretName 中提供密钥名称。

  • 将文件 keystore.jks 及其密码保留在名为 keystore-password.txt 的文件中，并将 truststore.jks 及其密码保留在名为 truststore-password.jks 的文件中。

  • 转至命令行并执行：

    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
    

    注：文件名应与提及的名称相同，例如，keystore.jks、keystore-password.txt、truststore.jks 和 truststore-password.txt。

  • 在 keystoresSecretName 中提供密钥名称以覆盖缺省密钥库。

  有关更多信息，请参阅配置 MobileFirst Server 密钥库。

遵循以下步骤以从 IBM Cloud Private 管理控制台安装和配置 IBM MobileFirst Application Center。

1. 转至管理控制台中的目录。
2. 选择 ibm-mfpf-appcenter-prod helm chart。
3. 单击配置。
4. 提供环境变量。 请参阅 MobileFirst Application Center 的环境变量以获取更多信息。
5. 单击安装。

验证安装

在安装和配置 MobileFirst Analytics（可选）和 MobileFirst Server 后，您可以通过执行以下步骤来验证已部署的 pod 的安装和状态：

在 IBM Cloud Private 管理控制台中， 选择工作负载 > Helm 发行版。 单击您的安装的发行版名称。

访问 MobileFirst Application Center

成功安装 MobileFirst Application Center Helm Chart 后，可使用以下方式从浏览器访问 MobileFirst Application Center 控制台：<protocol>://<external_ip>:<port>/appcenterconsole。

协议可以为 http 或 https。 另请注意，在 NodePort 部署中，端口将为 NodePort。 要获取已安装的 MobileFirst Application Center Charts 的 ip_address 和 NodePort，请执行以下步骤：

1. 在 IBM Cloud Private 管理控制台中，选择工作负载 > Helm 发行版。
2. 单击 helm chart 安装的发行版名称。
3. 请参阅注释部分。

注：要访问 MobileFirst Application Center 移动式客户机，请从 Passport Advantage 下载 Application Center 软件包。 了解更多信息。

升级 Helm Chart 和发行版

请参阅升级捆绑产品以获取有关如何升级 helm chart/发行版的指示信息。

Helm 发行版升级的样本场景

1. 要使用 values.yaml 的值更改升级 helm 发行版，请使用 helm upgrade 命令以及 –set 标志。 您可以多次指定 –set 标志。 优先级将赋予命令行中指定的最右侧设置。

     helm upgrade --set <name>=<value> --set <name>=<value> <existing-helm-release-name> <path of new helm chart>
   

2. 要通过在文件中提供值来升级 helm 发行版，请使用 helm upgrade 命令以及 -f 标志。 您可以多次使用 –values 或 -f 标志。 优先级将赋予命令行中指定的最右侧文件。 在以下示例中，如果 myvalues.yaml 和 override.yaml 都包含名为 Test 的键，那么 override.yaml 中设置的值优先。

     helm upgrade -f myvalues.yaml -f override.yaml <existing-helm-release-name> <path of new helm chart>
   

3. 要通过复用最后一个发行版中的值并覆盖其中部分值来升级 helm 发行版，可以使用如下命令：

     helm upgrade --reuse-values --set <name>=<value> --set <name>=<value> <existing-helm-release-name> <path of new helm chart>
   

卸载

要卸载 MobileFirst Application Center，请使用 Helm CLI。 使用以下命令来完全删除已安装的图表和关联的部署：

helm delete --purge <release_name>

release_name 是已部署的 Helm Chart 的发行版名称。

参考

请参阅此处以获取有关 MobileFirst Application Center 的更多信息。