8.7. CLI 脚本

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

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

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

注意

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

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

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

Expand

表 8.2. CLI 脚本属性
参数	Description
`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`。

注意