使用 Helm 在 IBM Cloud Kubernetes 集群上设置 Mobile Foundation

概述

遵循以下指示信息以使用 Helm 图表在 IBM Cloud Kubernetes 集群 (IKS) 上配置 MobileFirst Server 实例和 MobileFirst Analytics 实例：

• 设置 IBM Cloud Kubernetes 集群。
• 使用 IBM Cloud CLI 设置您的主计算机。
• 下载用于 IBM Cloud Private 的 IBM Mobile Foundation Passport Advantage 归档（PPA 归档）。
• 在 IBM Cloud Kubernetes 集群中装入 PPA 归档。
• 最后，您将配置和安装 MobileFirst Analytics（可选）和 MobileFirst Server。

跳转至：

• 先决条件
• 下载 IBM Mobile Foundation Passport Advantage 归档
• 装入 IBM Mobile Foundation Passport Advantage 归档
• 安装和配置 IBM Mobile Foundation Helm Chart
• 验证安装
• 样本应用程序
• 升级 Helm Chart 和发行版
• 卸载

先决条件

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

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

• IBM Cloud CLI
• Kubernetes CLI
• IBM Cloud 容器注册表插件
• IBM Cloud 容器服务插件

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

下载 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 Kubernetes 集群：

1. 使用 IBM Cloud 插件登录到集群。

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

   例如，

    ibmcloud login -a https://ip:port
   

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

2. 使用以下命令登录至 IBM Cloud Container 注册表并初始化容器服务：

    ibmcloud cr login
    ibmcloud cs init
   

3. 使用以下命令设置部署区域（例如，us-south）

    ibmcloud cr region-set
   

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

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

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

helm 图表存储在客户机中或存储在本地（与存储在 IBM Cloud Private helm 存储库中的 ICP helm 图表不同）。可以在 ppa-import/charts 目录中找到图表。

安装和配置 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 Kubernetes 集群上的 MobileFirst Analytics 中使用的环境变量。

MobileFirst Server 的环境变量

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

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

安装 Helm 图表

安装 MobileFirst Analytics

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

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

遵循以下步骤以在 IBM Cloud Kubernetes 集群上安装和配置 IBM MobileFirst Analytics。

1. 要配置 Kubernetes 集群，请执行如下命令：

    ibmcloud cs cluster-config <iks-cluster-name>
   

2. 使用以下命令获取缺省 helm 图表值。 ```bash helm inspect values > values.yaml

    MobileFirst Analytics 的示例：
    ```bash
    helm inspect values ibm-mfpf-analytics-prod-1.0.17.tgz > values.yaml
   

3. 修改 values.yaml 以添加相应的值来部署 helm 图表。确保添加 ingress.hostname 详细信息、缩放等，然后保存 values.yaml。

4. 要部署 helm 图表，请运行以下命令：

    helm install -n <iks-cluster-name> -f values.yaml <mfp-analytics-helm-chart.tgz>
   

   用于部署分析服务器的示例：

    helm install -n mfpanalyticsonkubecluster -f analytics-values.yaml ./ibm-mfpf-analytics-prod-1.0.17.tgz
   

安装 MobileFirst Server

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

遵循以下步骤以在 IBM Cloud Kubernetes 集群上安装和配置 IBM MobileFirst Server。

1. 配置 Kube 集群：

    ibmcloud cs cluster-config <iks-cluster-name>
   

2. 使用以下命令获取缺省 helm 图表值：

    helm inspect values <mfp-server-helm-chart.tgz>  > values.yaml
   

   MobileFirst Server 的示例：

    helm inspect values ibm-mfpf-server-prod-1.0.17.tgz > values.yaml
   

3. 修改 values.yaml 以添加相应的值来部署 helm 图表。确保添加数据库详细信息、入口、缩放等，然后保存 values.yaml。

4. 要部署 helm 图表，请运行以下命令。

    helm install -n <iks-cluster-name> -f values.yaml <mfp-server-helm-chart.tgz>
   

   用于部署服务器的示例：

    helm install -n mfpserveronkubecluster -f server-values.yaml ./ibm-mfpf-server-prod-1.0.17.tgz
   

注：要安装 AppCenter，请使用相应的 helm 图表（例如，ibm-mfpf-appcenter-prod-1.0.17.tgz）执行上述步骤。

验证安装

在安装和配置 MobileFirst Analytics（可选）和 MobileFirst Server 后，您可以通过使用 IBM Cloud CLI、Kubernetes CLI 和 helm 命令来验证已部署的 pod 的安装和状态。

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

在 IBM Cloud 门户网站上的 IBM Cloud Kubernetes 集群页面中，用户可以使用启动按钮来打开 Kubernetes 控制台，以管理集群工件。

访问 控制台

成功部署后，注释将在终端上显示为输出。您可以直接运行命令以通过 NodePort 获取控制台 URL。

例如，对于 Mobile Foundation 服务器，注释将显示如下：

The Notes displayed as follows as the result of the helm deployment
Get the Server URL by running these commands:
1. For http endpoint:
 export NODE_PORT=$(kubectl get --namespace default -o jsonpath=“{.spec.ports[0].nodePort}” services monitor-mfp-ibm-mfpf-server-prod)
 export NODE_IP=$(kubectl get nodes --namespace default -o jsonpath=“{.items[0].status.addresses[0].address}“)
 echo http://$NODE_IP:$NODE_PORT/mfpconsole
2. For https endpoint:
 export NODE_PORT=$(kubectl get --namespace default -o jsonpath=“{.spec.ports[1].nodePort}” services monitor-mfp-ibm-mfpf-server-prod)
 export NODE_IP=$(kubectl get nodes --namespace default -o jsonpath=“{.items[0].status.addresses[0].address}“)
 echo https://$NODE_IP:$NODE_PORT/mfpconsole

通过类似的安装方法，您可以使用 <protocol>://<ip_address>:<node_port>/analytics/console 访问 IBM MobileFirst Analytics Console，使用 <protocol>://<ip_address>:<node_port>/appcenter/console访问 IBM Mobile Foundation Application Center 除了用于访问控制台的 NodePort 方法之外，也可以通过入口主机访问服务。

执行下面的步骤来访问控制台：

1. 转至 IBM Cloud 仪表板。
2. 选择已在其上部署 Analytics/Server/AppCenter 的 Kubernetes 集群，以打开概述页面。
3. 查找入口子域以获取入口主机名，然后按照如下所述访问控制台。
   • 使用以下信息访问 IBM Mobile Foundation Operational Console： <protocol>://<ingress-hostname>/mfpconsole
   • 使用以下信息访问 IBM Mobile Foundation Analytics Console： <protocol>://<ingress-hostname>/analytics/console
   • 使用以下信息访问 IBM Mobile Foundation Application Center Console： <protocol>://<ingress-hostname>/appcenter/console

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

示例应用程序

请参阅 教程以部署样本适配器和在 IBM Cloud Kubernetes 集群中运行的 IBM 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.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 Server 和 MobileFirst Analytics，请使用 Helm CLI。 使用以下命令来完全删除已安装的图表和关联的部署：

helm delete --purge <release_name>

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