在 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 Mobile Foundation Passport Advantage 归档
- 装入 IBM Mobile Foundation Passport Advantage 归档
- 安装和配置 IBM Mobile Foundation Helm Chart
- 验证安装
- 样本应用程序
- 升级 Helm Chart 和发行版
- 卸载
先决条件
您应该具有 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 集群：
- 使用 IBM Cloud ICP 插件 (
bx pr) 登录到集群。请参阅 IBM Cloud Private 文档中的 CLI 命令参考。
例如，
bx pr login -a https://ip:port（可选）如果您打算跳过 SSL 验证，请在上述命令中使用标记
--skip-ssl-validation。 使用此选项将提示输入集群端点的username和password。 在成功登录后，继续以下步骤。 - 使用以下命令装入 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。 - 在装入 PPA 归档后，同步存储库，确保在目录中列出 Helm Chart。 您可以在 IBM Cloud Private 管理控制台中执行此操作。
- 选择管理 > 存储库。
- 单击同步存储库。
- 在 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.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 密钥库。
-
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。
- 转至管理控制台中的目录。
- 选择 ibm-mfpf-analytics-prod helm chart。
- 单击配置。
- 提供环境变量。 请参阅 MobileFirst Analytics 的环境变量以获取更多信息。
- 接受许可证协议。
- 单击安装。
安装 MobileFirst Server
在开始安装 MobileFirst Server 之前，确保您已预先配置 DB2 数据库。
遵循以下步骤以从 IBM Cloud Private 管理控制台安装和配置 IBM MobileFirst Server。
- 转至管理控制台中的目录。
- 选择 ibm-mfpf-server-prod helm chart。
- 单击配置。
- 提供环境变量。 请参阅 MobileFirst Server 的环境变量以获取更多信息。
- 接受许可证协议。
- 单击安装。
验证安装
在安装和配置 MobileFirst Analytics（可选）和 MobileFirst Server 后，您可以通过执行以下步骤来验证已部署的 pod 的安装和状态：
在 IBM Cloud Private 管理控制台中， 选择工作负载 > Helm 发行版。 单击您的安装的发行版名称。
访问 控制台
在成功安装后，您可以使用以下方式访问 IBM 操作控制台：<protocol>://<ip_address>:<port>/mfpconsole。
可使用以下方式访问 IBM MobileFirst Analytics 控制台：<protocol>://<ip_address>:<port>/analytics/console。
协议可以为 http 或 https。 另请注意，在 NodePort 部署中，端口将为 NodePort。 要获取已安装的 Charts 的 ip_address 和 NodePort，请执行以下步骤：
- 在 IBM Cloud Private 管理控制台中，选择工作负载 > Helm 发行版。
- 单击 helm chart 安装的发行版名称。
- 请参阅注释部分。
注：端口 9600 在 Kubernetes 服务中内部公开，且供 Analytics 实例用作传输端口。
示例应用程序
请参阅 教程以部署样本适配器和在 IBM Cloud Private 中运行的 MobileFirst Server 上运行样本应用程序。
升级 Helm Chart 和发行版
请参阅升级捆绑产品以获取有关如何升级 helm chart/发行版的指示信息。
Helm 发行版升级的样本场景
- 要使用
values.yaml的值更改升级 helm 发行版，请使用helm upgrade命令以及 –set 标志。 您可以多次指定 –set 标志。 优先级将赋予命令行中指定的最右侧设置。helm upgrade --set <name>=<value> --set <name>=<value> <existing-helm-release-name> <path of new helm chart> - 要通过在文件中提供值来升级 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> - 要通过复用最后一个发行版中的值并覆盖其中部分值来升级 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 的发行版名称。
▲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.