6.6. 自定义部署行为

流程

1. 使用 deployment-overlay add management CLI 命令添加部署覆盖：

   deployment-overlay add --name=new-deployment-overlay --content=WEB-INF/web.xml=/path/to/other/web.xml --deployments=test-application.war --redeploy-affected

   注意

   在受管域中，使用--server-groups 指定适用的 服务器组，或者用-- all-server-groups 指定所有服务器组。

2. 创建部署覆盖后，您可以在现有覆盖中添加内容，将覆盖链接到部署或删除覆盖。

3. 可选：您可以使用 <overlay> 元素指定指向包含静态 Web 资源（如 HTML、镜像或视频）的外部目录的 覆盖 配置。

   & lt;overlay > 元素指定覆盖 Web 应用程序静态文件的静态文件，类似于 JAR 覆盖过程。此元素位于应用程序文件 jboss-web.xml 中。使用这个元素配置，您不需要重新打包应用。

   以下示例显示了 < overlay> 元素中 的系统属性替换，其中 {example.path.to.overlay} 定义 /PATH/TO/STATIC/WEB/CONTENT 位置。

   示例：& lt;overlay > 元素在 jboss-web.xml 文件中

   <jboss-web xmlns="http://www.jboss.com/xml/ns/javaee"
              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
              xsi:schemaLocation="http://www.jboss.com/xml/ns/javaee http://www.jboss.org/j2ee/schema/jboss-web_10_0.xsd"
              version="10.0">
           <overlay>{example.path.to.overlay}</overlay>
   </jboss-web>

   如果 jboss-descriptor-property-replacement 设为 true，您可以在 < overlay > 项中指定一个系统属性，这是描述符属性的默认值。

   要配置 jboss-descriptor-property-replacement，请使用以下管理 CLI 命令：

   /subsystem=ee:write-attribute(name=jboss-descriptor-property-replacement,value=true)

   该命令在 JBoss EAP 配置中的 ee 子系统中添加以下 XML 内容：

   <subsystem xmlns="urn:jboss:domain:ee:4.0">
       <jboss-descriptor-property-replacement>true</jboss-descriptor-property-replacement>
   </subsystem>

   注意

   & lt;overlay > 元素不会覆盖 EAP 项目中已存在的部署文件。如果多个 <overlay > 元素包含同一文件，则优先级顺序会根据应用程序 jboss-web.xml 文件中的 overlay 元素序列来决定。

1. 服务器组 group-A 和 group-B 将同时应用该操作。该操作将应用于系列中的 group-A 中的服务器，而 group-B 中的所有服务器将同时处理该操作。如果 group-A 中超过 20% 的服务器无法应用该操作，它将在整个组中回滚。如果 group-B 中的任何服务器都无法应用该操作，它将在这个组中回滚。
2. group-A 和 group-B 中的所有服务器完成后，该操作将应用到 group-C 中的服务器。这些服务器将同时处理该操作。如果 group-C 中有多个服务器无法应用该操作，它将在这个组中回滚。
3. group-C 中的所有服务器完成后，服务器组 group-D 和 group-E 将同时应用该操作。该操作将应用于 组-D 中的服务器，而 group-E 中的所有服务器将同时处理该操作。如果 group-D 中超过 20% 的服务器无法应用该操作，它将在这个组中回滚。如果 group-E 中的任何服务器都无法应用该操作，它将在这个组中回滚。

流程

1. 使用 rollout-plan management CLI 命令存储推出部署计划。有关格式的更多信息，请参阅 Rollout 计划语法。

   rollout-plan add --name=my-rollout-plan --content={rollout main-server-group(rolling-to-servers=false,max-failed-servers=1),other-server-group(rolling-to-servers=true,max-failure-percentage=20) rollback-across-groups=true}

   这会创建以下部署计划。

   "rollout-plan" => {
       "in-series" => [
           {"server-group" => {"main-server-group" => {
               "rolling-to-servers" => false,
               "max-failed-servers" => 1
           }}},
           {"server-group" => {"other-server-group" => {
               "rolling-to-servers" => true,
               "max-failure-percentage" => 20
           }}}
       ],
       "rollback-across-groups" => true
   }

2. 指定部署应用程序时存储的 rollout 计划名称。

   以下管理 CLI 命令使用 my-rollout-plan 存储的 rollout 计划将应用程序部署到所有服务器组。

   deploy /path/to/test-application.war --all-server-groups --headers={rollout id=my-rollout-plan}