在 IBM Cloud Private 上设置 MobileFirst Server

improve this page | report issue

概述

遵循以下指示信息以在 IBM Cloud Private 上配置 MobileFirst Server 实例和 MobileFirst Analytics 实例:

  • 设置 IBM Cloud Private Kubernetes 集群。
  • 使用所需工具(Docker、IBM Cloud CLI (bx)、IBM Cloud Private (icp) Plugin for IBM Cloud CLI (bx pr)、Kubernetes CLI (kubectl) 和 Helm CLI (helm))来设置主计算机。
  • 下载用于 IBM Cloud Private 的 IBM Mobile Foundation Passport Advantage 归档(PPA 归档)。
  • 在 IBM Cloud Private 集群中装入 PPA 归档。
  • 最后,您将配置和安装 MobileFirst Analytics(可选)和 MobileFirst Server。

跳转至:

先决条件

您应该具有 IBM Cloud Private 帐户,并且必须遵循 IBM Cloud Private 集群安装中的文档设置 Kubernetes 集群。

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

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

要使用 CLI 访问 IBM Cloud Private 集群,应配置 kubectl 客户机。 了解更多信息

下载 IBM Mobile Foundation Passport Advantage 归档

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

  • MobileFirst Server
  • MobileFirst Analytics
  • MobileFirst Application Center

装入 IBM Mobile Foundation Passport Advantage 归档

在装入 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。 使用此选项将提示输入集群端点的 usernamepassword。 在成功登录后,继续以下步骤。

  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 Server 作为 ibm-mfpf-server-prod 列出,并且 MobileFirst Analytics 作为 ibm-mfpf-analytics-prod 列出。

安装和配置 IBM Mobile Foundation Helm Chart

在安装和配置 MobileFirst Server 之前,您应具有以下内容:

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

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

    在安装之前,请执行以下步骤:

    • 使用 keystore.jkskeystore-password.txttruststore.jkstruststore-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.jkskeystore-password.txttruststore.jkstruststore-password.txt

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

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

MobileFirst Analytics 的环境变量

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

限定符 参数 定义 允许值
arch   工作程序节点架构 应将此图表部署至的工作程序节点架构。
当前仅支持 AMD64 平台。
image pullPolicy 映像拉取策略 缺省值为 IfNotPresent
  tag Docker 映像标记 请参阅 Docker 标记描述
  name Docker 映像名称 Operational Analytics Docker 映像的名称。
scaling replicaCount 需要创建的 Operational Analytics 实例 (pod) 数量 正整数
缺省值为 2
mobileFirstAnalyticsConsole user Operational Analytics 的用户名 缺省值为 admin
  password Operational Analytics 的密码 缺省值为 admin
analyticsConfiguration clusterName Analytics 集群的名称 缺省值为 mobilefirst
  analyticsDataDirectory 存储分析数据的路径。 它还将与在容器内安装持久卷声明的路径相同 缺省为 /analyticsData
  numberOfShards Analytics 的 Elasticsearch 分片数量 正整数
缺省值为 2
  replicasPerShard 针对 Analytics 每个分片要维护的 Elasticsearch 副本数量 正整数
缺省值为 2
keystores keystoresSecretName 请参阅安装和配置 IBM Mobile Foundation Helm Chart,其中描述使用密钥库及其密码创建密钥的步骤。  
jndiConfigurations mfpfProperties JNDI 属性,为定制 Operational Analytics 而指定 提供逗号分隔的名称值对。
resources limits.cpu 描述允许的最大 CPU 量 缺省值为 2000m
请阅读 CPU 的含义
  limits.memory 描述允许的最大内存量 缺省值为 4096Mi
请阅读内存的含义
  requests.cpu 描述所需的最小 CPU 量。 如果未指定,那么缺省为 limits(如果已指定)或实现定义的值 缺省值为 1000m
  requests.memory 描述所需的最小内存量。 如果未指定,那么内存量缺省为 limits(如果已指定)或实现定义的值 缺省值为 2048Mi
persistence existingClaimName 现有持久卷声明 (PVC) 的名称  
logs consoleFormat 指定容器日志输出格式。 缺省值为 json
  consoleLogLevel 控制转至容器日志的消息的详细程度。 缺省值为 info
  consoleSource 指定写入容器日志的源。针对多个源,请使用逗号分隔的列表。 缺省值为 message, trace, accessLog, ffdc

MobileFirst Server 的环境变量

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

限定符 参数 定义 允许值
arch   工作程序节点架构 应将此图表部署至的工作程序节点架构。
当前仅支持 AMD64 平台。
image pullPolicy 映像拉取策略 缺省为 IfNotPresent
  tag Docker 映像标记 请参阅 Docker 标记描述
  name Docker 映像名称 Server Docker 映像的名称。
scaling replicaCount 需要创建的 Server 实例 (pod) 数量 正整数
缺省值为 3
mobileFirstOperationsConsole user Server 的用户名 缺省值为 admin
  password Server 用户的密码 缺省值为 admin
existingDB2Details db2Host 需要配置 Server 表的 DB2 数据库的 IP 地址或主机 当前仅支持 DB2。
  db2Port 设置 DB2 数据库的端口  
  db2Database 在 BD2 中预先配置以供使用的数据库名称  
  db2Username 用于访问 BD2 数据库的 DB2 用户名 用户应有权创建表和创建模式(如果尚不存在)。
  db2Password 提供的数据库的 DB2 密码  
  db2Schema 要创建的服务器 DB2 模式  
  db2ConnectionIsSSL DB2 连接类型 指定数据库连接必须为 http 还是 https。 缺省值为 false (http)。
确保还为相同连接方式配置 DB2 端口。
existingMobileFirstAnalytics analyticsEndPoint 分析服务器的 URL 例如:http://9.9.9.9:30400
请勿指定控制台路径,将在部署期间添加此路径。
       
  analyticsAdminUser 分析管理员用户的用户名  
  analyticsAdminPassword 分析管理员用户的密码  
keystores keystoresSecretName 请参阅安装和配置 IBM Mobile Foundation Helm Chart,其中描述使用密钥库及其密码创建密钥的步骤。  
jndiConfigurations mfpfProperties 用于定制部署的 Server JNDI 属性 逗号分隔的名称值对。
resources limits.cpu 描述允许的最大 CPU 量 缺省值为 2000m
请阅读 CPU 的含义
  limits.memory 描述允许的最大内存量 缺省值为 4096Mi
请阅读内存的含义
  requests.cpu 描述所需的最小 CPU 量。 如果未指定,那么缺省为 limits(如果已指定)或实现定义的值。 缺省值为 1000m
  requests.memory 描述所需的最小内存量。 如果未指定,那么缺省为 limits(如果已指定)或者实现定义的值 缺省值为 2048Mi
logs consoleFormat 指定容器日志输出格式。 缺省值为 json
  consoleLogLevel 控制转至容器日志的消息的详细程度。 缺省值为 info
  consoleSource 指定写入容器日志的源。针对多个源,请使用逗号分隔的列表。 缺省值为 message, trace, accessLog, ffdc

有关使用 Kibana 分析 日志的教程,请参阅此处

从 ICP 目录安装 Helm Chart

安装 MobileFirst Analytics

MobileFirst Analytics 的安装为可选。 如果想要在 MobileFirst Server 中启用分析,那么应首先配置并安装 MobileFirst Analytics,然后再安装 MobileFirst Server。

在开始安装 MobileFirst Analytics Chart 之前,配置持久卷。 提供持久卷以配置 MobileFirst Analytics。 遵循 IBM Cloud Private 文档中详述的步骤以创建持久卷

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

  1. 转至管理控制台中的目录
  2. 选择 ibm-mfpf-analytics-prod helm chart。
  3. 单击配置
  4. 提供环境变量。 请参阅 MobileFirst Analytics 的环境变量以获取更多信息。
  5. 接受许可证协议
  6. 单击安装

安装 MobileFirst Server

在开始安装 MobileFirst Server 之前,确保您已预先配置 DB2 数据库。

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

  1. 转至管理控制台中的目录
  2. 选择 ibm-mfpf-server-prod helm chart。
  3. 单击配置
  4. 提供环境变量。 请参阅 MobileFirst Server 的环境变量以获取更多信息。
  5. 接受许可证协议
  6. 单击安装

验证安装

在安装和配置 MobileFirst Analytics(可选)和 MobileFirst Server 后,您可以通过执行以下步骤来验证已部署的 pod 的安装和状态:

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

访问 控制台

在成功安装后,您可以使用以下方式访问 IBM 操作控制台:<protocol>://<ip_address>:<port>/mfpconsole。 可使用以下方式访问 IBM MobileFirst Analytics 控制台:<protocol>://<ip_address>:<port>/analytics/console

协议可以为 httphttps。 另请注意,在 NodePort 部署中,端口将为 NodePort。 要获取已安装的 Charts 的 ip_address 和 NodePort,请执行以下步骤:

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

注:端口 9600 在 Kubernetes 服务中内部公开,且供 Analytics 实例用作传输端口。

示例应用程序

请参阅 教程以部署样本适配器和在 IBM Cloud Private 中运行的 MobileFirst Server 上运行样本应用程序。

升级 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.yamloverride.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 Server 和 MobileFirst Analytics,请使用 Helm CLI。 使用以下命令来完全删除已安装的图表和关联的部署:

helm delete --purge <release_name>

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

Last modified on October 11, 2018