使用脚本在 IBM Cloud Kubernetes 集群上设置 MobileFirst Application Center

bmx-kubernetes 文件夹

包含使用 IBM Cloud Container Service 部署到 Kubernetes 集群所需的定制文件和脚本。

Dockerfile-mfp-appcenter

• Dockerfile-mfp-appcenter：包含构建 MobileFirst Application Center 映像所需的所有命令的文本文档。
• scripts 文件夹：此文件夹包含 args 文件夹，其中包含一组配置文件。 它还包含登录 IBM Cloud 时所需的脚本，可构建 MobileFirst Application Center 映像，以及用于在 IBM Cloud 上推送与运行此映像。 您可以选择以交互方式运行这些脚本，或者通过对配置文件进行预配置的方式来运行脚本（如后文所述）。 除可定制的 args/*.properties 文件外，请勿修改该文件夹中的任何元素。 要获取脚本用法帮助，请使用 -h 或 --help 命令行参数（例如，scriptname.sh --help）。
• usr-mfp-appcenter 文件夹：
  • bin 文件夹：包含将在容器启动时执行的脚本文件 (mfp-appcenter-init)。 您可以添加自己的定制代码以执行这些代码。
  • config 文件夹：包含 MobileFirst Application Center 所使用的服务器配置片段（密钥库、服务器属性、用户注册表）。
  • keystore.xml - 用于 SSL 加密的安全证书存储库的配置。 必须在 ./usr/security 文件夹中引用列出的文件。
  • ltpa.xml - 定义 LTPA 密钥及其密码的配置文件。
  • appcentersqldb.xml - 用于连接到 DB2 或 dashDB 数据库的 JDBC 数据源定义。
  • registry.xml - 用户注册表配置。 basicRegistry - 将基于 XML 的基本用户注册表配置作为缺省值提供。 可以为 basicRegistry 配置用户名和密码，或者也可以配置 ldapRegistry。
  • tracespec.xml - 用于启用调试和记录级别的跟踪规范。
• jre-security 文件夹：您可以通过将 JRE 安全相关文件（信任库、策略 JAR 文件等）放置在本文件夹中来更新这些文件。 将此文件夹中的文件复制到容器中的 JAVA_HOME/jre/lib/security/ 文件夹。
• security 文件夹：用于存储密钥存储库、信任库和 LTPA 密钥文件 (ltpa.keys)。
• env 文件夹：包含用于服务器初始化 (server.env) 和定制 JVM 选项 (jvm.options) 的环境属性。



单击以获取受支持的服务器环境属性的列表

属性	缺省值	描述
APPCENTER_SERVER_HTTPPORT	9080*	用于客户机 HTTP 请求的端口。 使用 -1 来禁用此端口。
APPCENTER_SERVER_HTTPSPORT	9443*	通过 SSL (HTTPS) 保护的客户机 HTTP 请求所使用的端口。 使用 -1 来禁用此端口。
APPCENTER_ROOT	applicationcenter	MobileFirst Application Center Administration Services 在其中可用的上下文根。
APPCENTER_CONSOLE_ROOT	appcenterconsole	提供 MobileFirst Application Center 控制台的上下文根。
APPCENTER_ADMIN_GROUP	appcenteradmingroup	已分配预定义角色 appcenteradmin 的用户组的名称。
APPCENTER_USER_GROUP	appcenterusergroup	已分配预定义角色 appcenteruser 的用户组的名称。


关闭此节
• dependencies 文件夹：包含 Mobile Foundation 运行时和 IBM Java JRE 8。
• mfpf-libs folder 文件夹：包含 MobileFirst 产品组件库和 CLI。

关闭此节

args 文件夹包含一组配置文件，其中包含运行脚本所需的自变量。 在以下文件中填充自变量值：

initenv.properties

• IBM_CLOUD_API_URL - 要执行部署的地理位置或区域。
  

  例如：api.ng.bluemix.net 表示美国，api.eu-de.bluemix.net 表示德国，api.au-syd.bluemix.net 表示悉尼

• IBM_CLOUD_ACCOUNT_ID - 您的帐户标识，该标识为字母数字值，例如，a1b1b111d11e1a11d1fa1cc999999999
  使用 bx target 命令可获取帐户标识。
• IBM_CLOUD_USER - IBM Cloud 用户名（电子邮件）。
• IBM_CLOUD_PASSWORD - IBM Cloud 密码。
• IBM_CLOUD_ORG - IBM Cloud 组织名称。
• IBM_CLOUD_SPACE - IBM Cloud 空间（如上文所述）。

prepareappcenterdbs.properties

MobileFirst Application Center 需要外部 DB2 on cloud 实例。

注：您还可以使用自己的 DB2 数据库。 IBM Cloud Kubernetes 集群应配置为连接到此数据库。

在设置 DB2 实例后，请提供所需自变量：

• DB_TYPE - dashDB（使用 DB2 on Cloud 时）或 DB2（使用自己的 DB2 数据库时）。
• 如果您使用自己的 DB2 数据库（即，DB_TYPE=DB2），请提供以下信息。
  • DB2_HOST - 您的 DB2 设置的主机名。
  • DB2_DATABASE - 数据库的名称。
  • DB2_PORT - 将用于连接到数据库的端口。
  • DB2_USERNAME - DB2 数据库用户（此用户应具备在提供的模式中创建表的权限，或者如果不存在模式，那么此用户应可创建模式）
  • DB2_PASSWORD - DB2 用户密码。
• 如果使用 DB2 on Cloud（即，DB_TYPE=dashDB），请提供以下信息。
  • APPCENTER_DB_SRV_NAME - 用于存储 appcenter 数据的 dashDB 服务实例名称。
• APPCENTER_SCHEMA_NAME - appcenter 数据的模式名称。 缺省名称为 APPCNTR。

注：如果许多用户或多个 MobileFirst Application Center 部署共享 DB2 数据库服务实例，请确保提供唯一的模式名称。

prepareappcenter.properties

• SERVER_IMAGE_TAG - 映像标记。 应采用以下格式：registry-url/namespace/image:tag。

例如：registry.ng.bluemix.net/myuniquenamespace/myappcenter:v1
如果尚未创建 Docker 注册表名称空间，请使用以下任一命令创建注册表名称空间：


• bx cr namespace-add myuniquenamespace
• bx cr namespace-list

以下指示信息演示了如何使用配置文件来运行脚本。 如果选择以非交互方式来运行，那么还提供了命令行自变量的列表：

1. initenv.sh - 登录 IBM Cloud
   运行 initenv.sh 脚本以创建环境，用于在 IBM Containers 上构建和运行 MobileFirst Application Center： 交互方式

   ./initenv.sh

   非交互方式

   ./initenv.sh args/initenv.properties

2. prepareappcenterdbs.sh - 准备 MobileFirst Application Center 数据库
   prepareappcenterdbs.sh 脚本用于通过 DB2 数据库服务配置 MobileFirst Application Center。 在步骤 1 中登录到的组织和空间内提供了 DB2 服务的服务实例。请运行： 交互方式

   ./prepareappcenterdbs.sh

   非交互方式

   ./prepareappcenterdbs.sh args/prepareappcenterdbs.properties

3. initenv.sh（可选）- 登录 IBM Cloud
   仅当在除提供 DB2 服务实例的组织和空间以外的其他组织和空间内需要创建容器时，才需要执行此步骤。 如果情况如此，请使用必须在其中创建和启动新组织和空间的容器来更新 initenv.properties，然后重新运行 initenv.sh 脚本：

   ./initenv.sh args/initenv.properties

4. prepareappcenter.sh - 准备 MobileFirst Application Center 映像
   运行 prepareappcenter.sh 脚本以构建 MobileFirst Application Center 映像，并将其推送到 IBM Cloud 存储库。 要查看 IBM Cloud 存储库中的所有可用映像，请运行：bx cr image-list
   此列表包含映像名称、创建日期和标识。
   交互方式

   ./prepareappcenter.sh

   非交互方式

   ./prepareappcenter.sh args/prepareappcenter.properties

5. 使用 IBM Cloud Container Service 在 Kubernetes 集群的 Docker 容器上部署 MobileFirst Application Center。
   1. 将终端上下文设置为您的集群
      bx cs cluster-config my-cluster
      要了解集群名称，请运行以下命令：
      bx cs clusters
      在输出中，指向配置文件的路径显示为用于设置环境变量的命令，例如：
      export KUBECONFIG=/Users/ibm/.bluemix/plugins/container-service/clusters/my-cluster/kube-config-prod-dal12-my-cluster.yml
      将 my-cluster 替换为您的集群名称后，复制粘贴以上命令以在您的终端内设置环境变量，然后按 Enter 键。
   2. 要获取入口域，请运行以下命令：
      bx cs cluster-get my-cluster
      记下“入口域”。 如果需要配置 TLS，请记下入口密钥。
   3. 创建 Kubernetes 部署
      编辑 yaml 文件 args/mfp-deployment-appcenter.yaml，并填写详细信息。 在执行 kubectl 命令之前，所有变量都必须替换为各自的值。
      ./args/mfp-deployment-appcenter.yaml 包含以下部署：
      • MobileFirst Application Center 的 kubernetes 部署，包含 1 个实例（副本），内存为 1024MB 且具有单核 CPU。
      • MobileFirst Application Center 的 kubernetes 服务。
      • 整个设置的入口，包含 MobileFirst Application Center 的所有 REST 端点。
      • configMap，用于使环境变量在 MobileFirst Application Center 实例中可用。
      在 YAML 文件中必须编辑以下值：
      
      1. 显示的不同 my-cluster.us-south.containers.mybluemix.net，含入口域的输出（来自上述 bx cs cluster-get 命令的输出）。
      2. registry.ng.bluemix.net/repository/mfpappcenter:latest - 使用您在 prepareappcenter.sh 中所使用的名称来上传映像。
      执行以下命令：
      kubectl create -f ./args/mfp-deployment-appcenter.yaml

      注：
      已提供以下模板 yaml 文件：
      

      • mfp-deployment-appcenter.yaml：使用 HTTP 部署 MobileFirst Application Center。
      • mfp-deployment-appcenter-with-tls.yaml：使用 HTTPS 部署 MobileFirst Application Center。

      创建后，要使用 Kubernetes 仪表板，请执行以下命令：
      kubectl proxy
      在浏览器中打开 localhost:8001/ui。