Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

8.13. S2I

镜像包含 S2I 脚本和 Maven。

目前仅支持 Maven 作为构建工具，用于应在 OpenShift 上的基于 JBoss EAP 的容器（或相关/子镜像）上部署的应用。

目前只支持 WAR 部署。

8.13.1. 自定义配置
复制链接

可以为镜像添加自定义配置文件。放入 configuration/ 目录中的所有文件将复制到 EAP_HOME/standalone/configuration/。例如，若要覆盖镜像中使用的默认配置，只需将自定义 standalone-openshift.xml 添加到 configuration/ 目录中：请参阅此类 部署的示例。

8.13.1.1. 自定义模块
复制链接

可以添加自定义模块。模块/ 目录中的所有文件将复制到 EAP_HOME/modules/。请参阅此类 部署的示例。

8.13.2. deployment Artifacts
复制链接

默认情况下，将部署来自源 目标 目录中的工件。要从不同目录部署，请在 BuildConfig 定义中设置 ARTIFACT_DIR 环境变量。ARTIFACT_DIR 是一个以逗号分隔的列表。例如：ART IFACT_DIR=app1/target,app2/target,app3/target

8.13.3. 工件存储库镜像
复制链接

Maven 中的存储库包含各种类型的构建构件和依赖项，如所有项目 JAR、库 JAR、插件或其他特定于项目的工件。它还指定执行 S2I 构建时从哪里下载工件的位置。除了使用中央存储库外，组织通常要部署本地自定义镜像存储库。

使用镜像的好处包括：

  • 同步镜像的可用性，在地理上更加接近，速度更快。
  • 能够更好地控制存储库内容。
  • 有可能在不同团队（开发人员、CI）之间共享构件，而无需依赖公共服务器和存储库。
  • 缩短构建时间.

通常，存储库管理器可以作为镜像的本地缓存。假设存储库管理器已在 https://10.0.0.1:8443/repository/internal/ 外部部署并可访问，S2I 构建可以通过向应用程序的构建配置提供 MAVEN_MIRROR_URL 环境变量来使用此管理器：

  1. 识别要对其应用 MAVEN_MIRROR_URL 变量的构建配置名称。 

    oc get bc -o name
buildconfig/eap
    Copy to Clipboard Toggle word wrap

  2. 使用 MAVEN_MIRROR_URL 环境变量更新 eap 的构建配置。 

    oc env bc/eap MAVEN_MIRROR_URL="https://10.0.0.1:8443/repository/internal/"
buildconfig "eap" updated
    Copy to Clipboard Toggle word wrap

  3. 验证 设置。 

    oc env bc/eap --list
# buildconfigs eap
MAVEN_MIRROR_URL=https://10.0.0.1:8443/repository/internal/
    Copy to Clipboard Toggle word wrap
  4. 计划应用的新构建。
注意

在应用构建期间，您会注意到 Maven 依赖项是从存储库管理器（而非默认的公共存储库）中提取的。另外，构建完成后，您会看到镜像已填充构建期间检索和使用的所有依赖项。

8.13.3.1. Secure Artifact Repository Mirror URL
复制链接

为通过 Maven 存储库防止"man-in-the-middle"攻击，JBoss EAP 需要将安全 URL 用于工件存储库镜像 URL。

URL 应指定一个安全 http("https")和安全端口。

默认情况下，如果您指定了不安全的 URL，则会返回一个错误。您可以使用属性 -Dinsecure.repositories=WARN 来覆盖此行为。

8.13.4. 脚本
复制链接

run
此脚本使用 openshift-launch.sh 脚本，通过 standalone-openshift.xml 配置配置和启动 JBoss EAP。
assemble
此脚本使用 Maven 构建来源，创建软件包(WAR)，并将它移到 EAP_HOME/standalone/deployments 目录。

8.13.5. 自定义脚本
复制链接

您可以在启动 pod 之前添加自定义脚本，在 JBoss EAP 启动之前运行。

您可以添加在启动 pod 时有效的任何脚本，包括 CLI 脚本。

从镜像启动 JBoss EAP 时有两个选项可用于包括脚本：

  • 将要以 postconfigure.sh 执行的 configmap 挂载
  • 在指定的安装目录中添加 install.sh 脚本

8.13.5.1. 挂载 configmap 来执行自定义脚本
复制链接

如果要在运行时将自定义脚本挂载到现有镜像（换句话说，是已构建的镜像），请挂载 configmap。

挂载 configmap：

  1. 创建一个包含您要包含在 postconfigure.sh 中的内容的 configmap。

    例如，在项目根目录中创建一个名为 extensions 的目录，以包含脚本 postconfigure.sh 和 extensions.cli 并运行以下命令： 

    $ oc create configmap jboss-cli --from-file=postconfigure.sh=extensions/postconfigure.sh --from-file=extensions.cli=extensions/extensions.cli
    Copy to Clipboard Toggle word wrap

  2. 通过部署控制器(dc)将 configmap 挂载到容器集中。 

    $ oc set volume dc/eap-app --add --name=jboss-cli -m /opt/eap/extensions -t configmap --configmap-name=jboss-cli --default-mode='0755' --overwrite
    Copy to Clipboard Toggle word wrap

postconfigure.sh示例

#!/usr/bin/env bash
set -x
echo "Executing postconfigure.sh"
$JBOSS_HOME/bin/jboss-cli.sh --file=$JBOSS_HOME/extensions/extensions.cli
Copy to Clipboard Toggle word wrap

extensions.cli示例

embed-server --std-out=echo  --server-config=standalone-openshift.xml
:whoami
quit
Copy to Clipboard Toggle word wrap

8.13.5.2. 使用 install.sh 执行自定义脚本
复制链接

如果要在构建时包含 脚本作为镜像的一部分，请使用 install.sh。

使用 install.sh 执行自定义脚本：

  1. 在 s2i 构建期间要使用的项目的 git 存储库中，创建一个名为 .s2i 的目录。

  2. 在 s2i 目录中，添加包含以下内容的名为 environment 的文件： 

    $ cat .s2i/environment
CUSTOM_INSTALL_DIRECTORIES=extensions
    Copy to Clipboard Toggle word wrap
  3. 创建名为 扩展名 的目录。

  4. 在 扩展 目录中，创建包含以下内容的 postconfigure.sh 文件（将占位符代码替换为您的环境的适当代码）： 

    $ cat extensions/postconfigure.sh
#!/usr/bin/env bash
echo "Executing patch.cli"
$JBOSS_HOME/bin/jboss-cli.sh --file=$JBOSS_HOME/extensions/some-cli-example.cli
    Copy to Clipboard Toggle word wrap

  5. 在扩展目录中，创建类似于以下内容的文件 install.sh（用适合您的环境替换占位符代码）： 

    $ cat extensions/install.sh
#!/usr/bin/env bash
set -x
echo "Running $PWD/install.sh"
injected_dir=$1
# copy any needed files into the target build.
cp -rf ${injected_dir} $JBOSS_HOME/extensions
    Copy to Clipboard Toggle word wrap

8.13.6. 环境变量
复制链接

您可以通过向 s2i build 命令提供环境变量来影响构建的执行方式。可以提供的环境变量有：

Expand
表 8.8. s2i 环境变量
变量名称描述

ARTIFACT_DIR

此目录中的 .war、. ear 和.jar 文件将复制到 deployments/ 目录中。

示例值： target

ENABLE_GENERATE_DEFAULT_DATASOURCE

可选。当带有值 true 时，服务器会被置备为 default 数据源。否则，默认数据源不包含在内。

GALLEON_PROVISION_DEFAULT_FAT_SERVER

可选。如果值为 true，并且未设置 galleon 层，则调配了一个默认的 JBoss EAP 服务器。

GALLEON_PROVISION_LAYERS

可选。指示 S2I 进程调配指定的层。该值是一个要调配的以逗号分隔的层列表，包括一个基础层和任意数量的 decorator 层。

示例值： jaxrs、sso

HTTP_PROXY_HOST

用于 Maven 的 HTTP 代理的主机名或 IP 地址。

示例值：192. 168.1.1

HTTP_PROXY_PORT

Maven 使用的 HTTP 代理的 TCP 端口。

示例值：80 80

HTTP_PROXY_USERNAME

如果提供了 HTTP_PROXY_PASSWORD，请将凭证用于 HTTP 代理。

示例值： myusername

HTTP_PROXY_PASSWORD

如果提供了 HTTP_PROXY_USERNAME，请对 HTTP 代理使用凭据。

示例值： mypassword

HTTP_PROXY_NONPROXYHOSTS

如果提供，配置的 HTTP 代理将忽略这些主机。

示例值： some.example.org|*.example.net

MAVEN_ARGS

覆盖构建期间提供给 Maven 的参数。

示例值： -e -Popenshift -DskipTests -Dcom.redhat.xpaas.repo.redhatga 软件包

MAVEN_ARGS_APPEND

在构建期间将用户参数附加到 Maven。

示例值： -Dfoo=bar

MAVEN_MIRROR_URL

要配置的 Maven Mirror/repository Manager 的 URL。

示例值： https://10.0.0.1:8443/repository/internal/

请注意，指定的 URL 应该安全。详情请查看 第 8.13.3.1 节 “Secure Artifact Repository Mirror URL”。

MAVEN_CLEAR_REPO

（可选）在构建后清除本地 Maven 存储库。

如果镜像中的服务器与本地缓存高度耦合，则不会删除缓存并打印警告。

示例值： true

APP_DATADIR

如果定义，则在复制数据文件的源中的目录。

示例值： mydata

DATA_DIR

镜像中复制 $APP_DATADIR 数据的目录。

示例值： EAP_HOME/data

注意
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat