11.11. 在 OpenShift 上使用应用程序中的 ConfigMap

流程

1. 在项目的根目录下，创建名为 scripts 的目录。例如：

   $ mkdir scripts

   Copy to Clipboard Toggle word wrap

2. 创建 cli.properties 文件，并将文件保存到 /scripts 目录中。在此文件中定义 config.path 和 config.ordinal 系统属性。例如：

   config.path=/etc/config
   config.ordinal=200

   Copy to Clipboard Toggle word wrap

3. 创建一个 CLI 脚本，如 mp-config.cli，并将它保存在可引导 JAR 的可访问目录中，如 /scripts 目录。以下示例显示了 mp-config.cli 脚本的内容：

   # config map
   
   /subsystem=microprofile-config-smallrye/config-source=os-map:add(dir={path=${config.path}}, ordinal=${config.ordinal})

   Copy to Clipboard Toggle word wrap

   mp-config.cli CLI 脚本会创建一个新的 ConfigSource，该脚本将从属性文件检索到的 ordinal 和 path 值。

4. 将脚本保存到 /scripts 目录中，该目录位于项目的根目录。

5. 在现有插件 <configuration> 元素 中添加以下 配置提取：

   <cli-sessions>
       <cli-session>
           <properties-file>
               scripts/cli.properties
           </properties-file>
           <script-files>
               <script>scripts/mp-config.cli</script>
           </script-files>
       </cli-session>
   </cli-sessions>

   Copy to Clipboard Toggle word wrap

6. 打包应用程序：

   $ mvn package

   Copy to Clipboard Toggle word wrap
7. 使用 oc login 命令登录到您的 OpenShift 实例。

8. 可选： 如果您之前还没有创建 target/openshift 子目录，则必须发出以下命令来创建 suddirectory：

   $ mkdir target/openshift

   Copy to Clipboard Toggle word wrap

9. 将打包的应用复制到创建的子目录中。

   $ cp target/microprofile-config-bootable.jar target/openshift

   Copy to Clipboard Toggle word wrap

10. 使用 target/openshift 子目录作为二进制输入来构建应用程序：

    $ oc start-build microprofile-config-app --from-dir target/openshift

    Copy to Clipboard Toggle word wrap
    注意

    OpenShift 将一组 CLI 脚本命令应用到可引导 JAR 配置文件，为云环境启用它。您可以通过在 Maven 项目 /target 目录中打开 bootable-jar-build-artifacts/generated-cli-script.txt 文件来访问此脚本。

11. 创建 ConfigMap。例如：

    $ oc create configmap microprofile-config-map --from-literal=name="Name comes from Openshift ConfigMap"

    Copy to Clipboard Toggle word wrap

12. 使用 dc 将 ConfigMap 挂载到应用。例如：

    $ oc set volume deployments/microprofile-config-app --add --name=config-volume \
    --mount-path=/etc/config \
    --type=configmap \
    --configmap-name=microprofile-config-map

    Copy to Clipboard Toggle word wrap

    执行 oc set volume 命令后，应用程序将使用新的配置设置重新部署。

13. 测试输出：

    $ curl http://$(oc get route microprofile-config-app --template='{{ .spec.host }}')/config/json

    Copy to Clipboard Toggle word wrap

    以下是预期的输出：

    {"result":"Hello Name comes from Openshift ConfigMap"}

    Copy to Clipboard Toggle word wrap