11.7. 构建时执行的 CLI 脚本


您可以创建 CLI 脚本,以在可引导 JAR 打包期间配置服务器。

CLI 脚本是一个文本文件,其中包含可用于应用其他服务器配置的 CLI 命令序列。例如,您可以创建一个脚本来添加新的日志记录器到 logging 子系统。

您还可以在 CLI 脚本中指定更复杂的操作。例如,您可以将安全管理操作分组到单个命令中,以便为管理 HTTP 端点启用 HTTP 身份验证。

注意

在将应用程序打包为可引导 JAR 之前,您必须在插件 配置的 <cli-session > 元素中定义 CLI 脚本。这样可确保服务器配置设置在打包可引导 JAR 后保留。

虽然您可以组合预定义的 Galleon 层来配置部署应用程序的服务器,但存在限制。例如,在打包可引导 JAR 时,您无法使用 Galleon 层启用 HTTPS undertow 侦听器。反之,您必须使用 CLI 脚本。

您必须在 pom.xml 文件的 &lt ;cli-session& gt; 元素中定义 CLI 脚本。下表显示了 CLI 会话属性的类型:

Expand
表 11.2. CLI 脚本属性
参数描述

script-files

脚本文件的路径列表。

properties-file

可选属性,用于指定属性文件的路径。此文件列出了脚本可以使用 ${my.prop} 语法来引用的 Java 属性。以下示例将 public inet-address 设置为 all.addresses 的值:/interface=public:write-attribute (name=inet-address,value=${all.addresses})

resolve-expressions

包含布尔值的可选属性。指明在向服务器发送操作请求前是否解析系统属性或表达式。默认值为 true

注意
  • CLI 脚本会按照 pom.xml 文件的 &lt ;cli-session > 元素定义的顺序启动。
  • JBoss EAP JAR Maven 插件为每个 CLI 会话启动嵌入式服务器。因此,您的 CLI 脚本不必启动或停止嵌入式服务器。
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2026 Red Hat
返回顶部