7.6. 自定义部署行为

您可以为 JBoss EAP 定义自定义位置，以存储已部署的内容。

为单机服务器定义自定义目录

默认情况下，单机服务器部署的内容存储在 EAP_HOME/standalone/data/content 目录中。可以通过在启动服务器时传递 -Djboss.server.deploy.dir 参数来更改此位置。

$ EAP_HOME/bin/standalone.sh -Djboss.server.deploy.dir=/path/to/new_deployed_content

在 JBoss EAP 实例中，所选位置应当是唯一的。

为受管域定义自定义目录

默认情况下，受管域部署的内容存储在 EAP_HOME/domain/data/content 目录中。可以通过在启动域时传递 -Djboss.domain.deployment.dir 参数来更改此位置。

$ EAP_HOME/bin/domain.sh -Djboss.domain.deployment.dir=/path/to/new_deployed_content

在 JBoss EAP 实例中，所选位置应当是唯一的。

JBoss EAP 在服务器启动时提供精细的控制部署顺序。可以指定多个 EAR 文件中应用的部署顺序以及重启后顺序的持久性。

您可以使用 jboss-all.xml 部署描述符来声明顶级部署之间的依赖关系。

例如，如果您的 app.ear 依赖于 Framework .ear，则您可以创建一个 app.ear/META-INF/jboss-all.xml 文件，如下所示。

<jboss xmlns="urn:jboss:1.0">
  <jboss-deployment-dependencies xmlns="urn:jboss:deployment-dependencies:1.0">
    <dependency name="framework.ear" />
  </jboss-deployment-dependencies>
</jboss>

这可确保在 app.ear 之前部署 Framework.ear。

部署 覆盖 可用于将内容覆盖到现有的部署中，而无需物理修改部署存档的内容。它允许您覆盖部署描述符、库 JAR 文件、类、Jkarta 服务器页面，以及运行时的其他文件，而无需重新构建存档。

如果您需要为需要不同配置或设置的不同环境调整部署，这将非常有用。例如，当将部署从开发到测试、到暂存再移到生产环境时，您可能需要交换部署描述符，修改静态 Web 资源以更改应用的品牌，或者根据目标环境将 JAR 库替换为不同的版本。对于需要更改配置但因为策略或安全限制而无法修改或破解归档的安装，此功能也非常有用。

在定义部署覆盖时，您将指定将替换部署存档中的 文件的文件系统中的 文件。您还必须指定哪些部署应受到部署覆盖的影响。必须重新部署任何受影响的部署，才能使更改生效。

有关完整使用详情，请执行 deployment-overlay --help。

关于 Rollout 计划

在受管域中，针对域或主机资源的操作可能会影响多个服务器。此类操作可能包括详细介绍操作应用到服务器的顺序的推出计划，以及详细描述是否可以在部分服务器上成功执行该操作的策略。如果没有指定推出计划，则会 使用默认的推出部署计划。

以下是涉及五个服务器组的推出计划示例：操作可以按序列、序列 或 并发组应用到服务器组。Rollout Plan Syntax 中对语法进行了更为详细的说明。

{"my-rollout-plan" => {"rollout-plan" => {
    "in-series" => [
        {"concurrent-groups" => {
            "group-A" => {
                "max-failure-percentage" => "20",
                "rolling-to-servers" => "true"
            },
            "group-B" => undefined
        }},
        {"server-group" => {"group-C" => {
            "rolling-to-servers" => "false",
            "max-failed-servers" => "1"
        }}},
        {"concurrent-groups" => {
            "group-D" => {
                "max-failure-percentage" => "20",
                "rolling-to-servers" => "true"
            },
            "group-E" => undefined
        }}
    ],
    "rollback-across-groups" => "true"
}}}

查看上面的示例，将操作应用到域中的服务器时要分三个阶段完成。如果任何服务器组的策略触发在服务器组中回滚该操作，则所有其他服务器组也将回滚。

rollout Plan Syntax

您可以通过以下任一方式指定推出部署计划。

虽然每种方法都有不同的初始命令，但这两种方法都使用 rollout 操作标头来定义推出计划。这使用以下语法：

rollout (id=PLAN_NAME | SERVER_GROUP_LIST) [rollback-across-groups]

使用 Rollout 计划部署

您可以通过将推出(rollout) 设置 传递到 headers 参数，将部署计划的完整详情直接提供给 deploy 命令。有关格式的更多信息，请参阅 Rollout Plan Syntax。

以下管理 CLI 命令利用为串行部署指定 rolling -to-servers=true 的部署计划将应用部署到 main- server-group 服务器组：

deploy /path/to/test-application.war --server-groups=main-server-group --headers={rollout main-server-group(rolling-to-servers=true)}

使用 Stored Rollout 计划部署

由于推出计划可能比较复杂，您可以选择存储推出计划的详细信息。这可让您在您要使用部署计划名称时引用推出计划的名称，而不必每次都需要部署计划的完整详情。

删除 Stored Rollout Plan

您可以通过指定要删除的 rollout-plan 管理 CLI 命令，移除存储的推出部署计划。

rollout-plan remove --name=my-rollout-plan

默认 Rollout Plan

所有影响多个服务器的操作都将通过推出计划来执行。如果没有在操作请求中指定推出部署计划，则会生成默认的推出部署计划。计划将具有以下特征：