第 3 章 为 Java 应用程序配置 JBoss EAP for OpenShift 镜像
用于 OpenShift 的 JBoss EAP 映像已预配置为 Java 应用的基本用途。不过,您可以在镜像内配置 JBoss EAP 实例。推荐的方法是使用 OpenShift S2I 流程,以及应用模板参数和环境变量。
当容器重启或终止时,运行中的容器上所做的任何配置更改都将丢失。
这包括使用传统 JBoss EAP 安装中包含的脚本进行的任何配置更改,如 add-user.sh
或管理 CLI。
强烈建议您使用 OpenShift S2I 流程以及应用模板参数和环境变量,在 JBoss EAP for OpenShift 镜像内对 JBoss EAP 实例进行任何配置更改。
3.1. 用于 OpenShift S2I 流程的 JBoss EAP 如何工作
说明 JBoss EAP 的 S2I 进程的流程图:
如果源代码存储库中存在
pom.xml
文件,S2I 构建器镜像将启动 Maven 构建流程。Maven 构建使用$MAVEN_ARGS
的内容。如果源代码存储库中不存在
pom.xml
文件,S2I 构建器镜像将启动二进制类型构建。要添加自定义 Maven 参数或选项,请使用
$MAVEN_ARGS_APPEND
。$MAVEN_ARGS_APPEND
变量将选项附加到$MAVEN_ARGS
。默认情况下,OpenShift 配置文件使用 Maven
软件包
目标,其中包括用于跳过测试的系统属性(-DskipTests
)和启用红帽 GA 存储库(-Dcom.redhat.xpaas.repo
)。Maven 构建成功的结果复制到 OpenShift 镜像 JBoss
EAP 中的 EAP_HOME/standalone/deployments/
目录中。这包括$ARTIFACT_DIR
环境变量指定的源存储库中的所有 JAR、WAR 和 EAR 文件。ARTIFACT_DIR
的默认值是 Maven 目标目录。注意要在 JBoss EAP 上的代理后面将 Maven 用于 OpenShift 镜像,请设置
$HTTP_PROXY_HOST
和$HTTP_PROXY_PORT
环境变量。另外,您还可以设置$HTTP_PROXY_USERNAME
、$HTTP_PROXY_PASSWORD
和$HTTP_PROXY_NONPROXYHOSTS
变量。-
模块
源存储库目录中的所有文件复制到 JBossEAP for OpenShift 镜像的 EAP_HOME/modules/
目录中。 -
configuration
源存储库目录中的所有文件复制到 JBossEAP for OpenShift 镜像中的 EAP_HOME/standalone/configuration/
目录中。如果要使用自定义 JBoss EAP 配置文件,请将文件命名为standalone-openshift.xml
。
其它资源
- 如需有关二进制类型构建的更多信息,请参阅 OpenShift 4.2 文档上的 Binary(本地)源。
- 如需有关如何指示 S2I 进程使用自定义 Maven 工件存储库镜像的其他指导,请参阅 Artifact Repository Mirrors。