7.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

   Copy to Clipboard Toggle word wrap
   注意

   在受管域中，使用 --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 位置。

   示例： jboss-web.xml 文件中的 <overlay> 元素

   <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>

   Copy to Clipboard Toggle word wrap

   如果 jboss-descriptor-property-replacement 设为 true，则您可以在 <overlay> 元素 中指定系统属性，这是 descriptor 属性的默认值。

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap
   注意

   & 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 将同时应用该操作。该操作将按顺序应用到 group-D 中的服务器，而 group-E 中的所有服务器将同时处理该操作。如果 group-D 中超过 20% 的服务器无法应用该操作，它将在整个组中回滚。如果 group-E 中的任何服务器都无法应用此操作，它将在该组间回滚。

1. 使用 rollout-plan 管理 CLI 命令来存储推出计划。有关格式的更多信息，请参阅 Rollout Plan Syntax。

   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}

   Copy to Clipboard Toggle word wrap

   这会创建以下部署计划：

   "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
   }

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap