Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

Red Hat Ansible 认证的内容集合 Red Hat JBoss Web Server 发行注记

Red Hat JBoss Web Server 5.7

用于 Red Hat JBoss Web Server 5.7

Red Hat Customer Content Services

摘要

本发行注记包含有关 Red Hat Ansible Certified Content Collection for Red Hat JBoss Web Server 的重要信息。

前言
复制链接

Red Hat JBoss Web Server 的 Red Hat Ansible 认证内容集合是红帽提供的预打包的 Ansible 内容集合。您可以使用 Red Hat Ansible 认证的 Content Collection 来自动安装和配置 Red Hat JBoss Web Server 产品。您还可以在 playbook 中添加自定义任务，以便在与自动化产品安装或之后同时自动部署 JBoss Web Server 应用程序。

有关 Red Hat Ansible 认证内容集合的常规信息，请参阅 Ansible Automation Hub 中的 AnsibleCollection - redhat.jws 页面。Ansible Collection - redhat.jws 页面包含有关集合包含的角色的信息。您可以点角色名称来查看此角色的目的、任何要求或依赖项的详细信息，以及角色用于完成自动化任务的变量和默认设置列表。

如需有关 Ansible 概念或使用 Ansible 的更多信息，请参阅 Ansible 概念和优势。

Red Hat Ansible Certified Content Collection for Red Hat JBoss Web Server 由 产品支持 发布。如果您有与这个集合相关的问题或问题，请联系红帽客户 体验和参与 支持。

注意

本文档的其余部分将 Red Hat JBoss Web Server 的 Red Hat Ansible 认证内容集合称为 JBoss Web Server 集合。

提供有关 Red Hat JBoss Web Server 文档的反馈
复制链接

要报告错误或改进文档，请登录到 Red Hat JIRA 帐户并提交问题。如果您没有 Red Hat Jira 帐户，则会提示您创建一个帐户。

流程

  1. 单击以下链接 以创建 ticket。
  2. 在 Summary 中输入问题的简短描述。
  3. 在 Description 中提供问题或功能增强的详细描述。包括一个指向文档中问题的 URL。
  4. 点 Submit 创建问题，并将问题路由到适当的文档团队。

使开源包含更多
复制链接

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。我们从这四个术语开始：master、slave、黑名单和白名单。由于此项工作十分艰巨，这些更改将在即将推出的几个发行版本中逐步实施。详情请查看 CTO Chris Wright 的信息。

第 1 章 安装 JBoss Web 服务器集合
复制链接

作为使用 Ansible 自动部署 Red Hat JBoss Web Server 的第一步，您必须从 Ansible Automation Hub 下载并安装 JBoss Web Server 集合。JBoss Web Server 集合在 Ansible Automation Hub 中命名为 redhat.jws。在安装 JBoss Web 服务器集合前，您必须确保您的系统符合某些先决条件。您必须在系统中的 Ansible 控制节点上安装 JBoss Web Server 集合。

有关任何先决条件和安装集合的更多信息，请参阅安装 JBoss Web Server 集合。

第 2 章 这个版本中可用的功能
复制链接

JBoss Web 服务器集合的这个版本包括以下功能：

2.1. 最新发行版本中的新功能
复制链接

JBoss Web 服务器集合的最新版本提供以下新功能或已更改的功能：

JBoss Web 服务器集合的 2.1 发行版本要求您已在系统中的控制节点上安装了 ansible-core 软件包版本 2.16 或更高版本。您可以通过安装 Red Hat Ansible Automation Platform 2.x 来安装 ansible-core 软件包。如需更多信息，请参阅 Red Hat Ansible Automation Platform 安装指南。

2.1.2. 默认启用原生存档文件自动安装
复制链接

从 2.1 发行版本中，JBoss Web 服务器集合也被配置为默认安装指定产品版本的原生存档文件。jws_native 变量现在默认设置为 True。

这会替换在默认情况下 jws_native 变量被设置为 False 的早期版本中的行为。在这种情况下，除非您明确将 jws_native 变量设置改为 True，否则 JBoss Web 服务器集合不会安装原生存档文件。

注意

如果将 jws_native 变量设置为 False，JBoss Web Server 集合无法安装原生存档，这会导致需要安装原生存档文件的功能（如 SELinux 策略）出现问题。

从 2.1 版本以后，redhat.jws.jws 角色已预先配置了 become: true 指令，它会激活用户特权升级，以便在目标主机上执行任何需要 root 特权的自动任务。

2.1.4. 删除 playbook 中的 become: true 指令的要求
复制链接

从 2.1 发行版本中，因为 redhat.jws.jws 角色被预先配置了 become: true 指令，所以您不再需要在 playbook 中指定 become: true 指令。

这会取代早期版本的行为，其中 JBoss Web Server 集合要求您在 playbook 中指定 become: true 指令，以在 play 级别激活用户特权升级。

2.2. 早期版本中的新功能或已更改的功能
复制链接

JBoss Web 服务器集合包括早期版本中引入的以下功能：

2.2.1. 完整的红帽支持
复制链接

从 2.0 版本中，JBoss Web 服务器集合是红帽完全支持的功能。在 2.0 版本之前，JBoss Web 服务器集合只是一个技术预览功能。

JBoss Web Server 集合支持在 Red Hat Enterprise Linux (RHEL)版本 8 或 9 上运行的目标主机上自动安装 Red Hat JBoss Web Server。

2.2.3. 用于启用自动化任务的预定义变量集合
复制链接

JBoss Web 服务器集合提供了一组全面的预定义变量和默认值，您可以手动更新以匹配您的设置要求。这些变量设置提供了 JBoss Web Server 集合在目标主机上完成 Red Hat JBoss Web Server 的自动化和自定义安装所需的所有信息。

有关 JBoss Web Server 集合提供的变量的完整列表，请参阅 Ansible Automation Hub 中的 redhat.jws.jws 角色。redhat.jws.jws 角色的信息页面列出了您可以定义的所有变量的名称、描述和默认值。

默认情况下，JBoss Web 服务器集合支持从产品归档文件自动安装 Red Hat JBoss Web Server。您可以启用 JBoss Web Server 集合，从存档文件安装指定 JBoss Web Server 版本的基本版本。基础版本是特定产品版本的初始发行版本（例如，5.7.0 是版本 5.7的基本版本）。

JBoss Web 服务器集合要求 Ansible 控制节点上提供了相应存档文件的本地副本。如果存档文件的副本还没有在您的系统中，您可以设置变量以允许从红帽客户门户网站下载自动文件。如需更多信息，请参阅 自动下载存档文件的支持。或者，您可以手动下载存档文件。

此功能还包括支持以下自动化设置任务的变量：

  • 您可以指定要安装的产品版本的基本发行版本。
  • 如果您更改了 Ansible 控制节点上存档文件的名称，您可以指定适当的文件名。

设置适当的变量后，JBoss Web Server 集合会自动提取存档文件，并在随后运行 playbook 时将产品安装到目标主机上。

如需更多信息，请参阅启用 JBoss Web Server 基础版本的自动安装。

如果产品补丁更新可用于正在安装的 JBoss Web 服务器版本，您也可以启用 JBoss Web Server 集合从存档文件安装这些补丁更新。此功能默认为禁用。您可以使用相同的步骤启用补丁更新的自动安装，无论您要与基本发行版本同时安装这些更新。

JBoss Web 服务器集合要求 Ansible 控制节点上提供了相应存档文件的本地副本。如果存档文件的副本还没有在您的系统中，您可以设置变量以允许从红帽客户门户网站下载自动文件。如需更多信息，请参阅 自动下载存档文件的支持。或者，您可以手动下载存档文件。

此功能还包括支持以下自动化设置任务的变量：

  • 您可以启用自动安装补丁更新。
  • 如果要安装指定的补丁版本，而不是最新的可用补丁更新，您可以指定适当的补丁版本。
  • 如果要防止 JBoss Web Server 集合联系红帽客户门户网站以下载文件，您可以启用完全离线安装。如需更多信息，请参阅从 存档文件中完全离线安装支持。

设置适当的变量后，JBoss Web Server 集合会自动提取存档文件，并在随后运行 playbook 时在目标主机上安装补丁更新。

如需更多信息，请参阅启用 JBoss Web 服务器补丁更新的自动安装。

2.2.6. 支持自动下载存档文件
复制链接

默认情况下，JBoss Web 服务器集合配置为支持自动下载存档文件。但是，这个功能还需要设置变量来指定与红帽服务帐户关联的客户端标识符(ID)和 secret。

注意

服务帐户可让您安全并自动连接和验证服务或应用程序，而无需最终用户凭证或直接交互。要创建服务帐户，您可以登录到 Red Hat Hybrid Cloud Console 中的 Service Accounts 页面，然后点 Create service account。

如需更多信息，请参阅启用 JBoss Web 服务器基础版本的 自动安装和启用 JBoss Web 服务器补丁更新的自动安装。

2.2.7. 支持完全离线归档文件安装
复制链接

默认情况下，JBoss Web 服务器集合配置为联系红帽客户门户网站，以检查新的补丁更新是否可用。但是，您可以选择设置一个变量来强制完全离线安装，并防止集合联系红帽客户门户网站，如果您的 Ansible 控制节点无法访问互联网，且您希望集合以避免联系红帽客户门户网站以下载文件。

注意

如果启用此功能，还必须设置一个变量来指定要安装的补丁版本。您还必须确保 Ansible 控制节点上已存在适当存档文件的副本。

如需更多信息，请参阅启用 JBoss Web 服务器补丁更新的自动安装。

您可以启用 JBoss Web 服务器集合，从 RPM 软件包安装 Red Hat JBoss Web Server。此功能默认为禁用。

当您启用 RPM 安装方法时，JBoss Web Server 集合会为指定主版本（包括任何次要版本和补丁更新）安装最新的 RPM 软件包。该集合直接从红帽获取 RPM 软件包。

此功能包括支持以下自动化设置任务的变量：

  • 您可以指定要安装的产品版本。
  • 您可以启用 RPM 安装方法。

设置适当的变量后，JBoss Web Server 集合会自动获取最新的 RPM 软件包，并在随后运行 playbook 时在目标主机上安装这些软件包。

如需更多信息，请参阅从 RPM 软件包启用 JBoss Web 服务器的自动安装。

2.2.9. 红帽构建的 OpenJDK 自动安装
复制链接

默认情况下，JBoss Web 服务器集合不会在目标主机上自动安装 JDK，具体取决于您已在这些主机上安装受支持的 JDK。但是，为了方便起见，您可以选择设置一个变量来启用自动安装受支持的红帽构建的 OpenJDK 版本。在这种情况下，当您随后运行 playbook 时，JBoss Web 服务器集合会在每个目标主机上安装指定的 OpenJDK 版本。

注意

JBoss Web 服务器集合仅支持自动安装红帽构建的 OpenJDK。如果要使用 IBM JDK 或 Oracle JDK 的支持版本，您必须在每个目标主机上手动安装 JDK，或使用 playbook 自动执行此过程。有关手动安装 IBM JDK 或 Oracle JDK 版本的更多信息，请参阅 Red Hat JBoss Web Server 安装指南。

如需更多信息，请参阅确保目标主机上安装 JDK。

2.2.10. 自动创建产品用户帐户和组
复制链接

默认情况下，JBoss Web 服务器集合会在每个目标主机上自动创建一个 tomcat 用户帐户和一个 tomcat 组。但是，如果您希望 JBoss Web 服务器集合创建不同的用户帐户和组，您可以设置变量来修改 JBoss Web 服务器集合的行为，以匹配您的设置要求。在这种情况下，当您随后运行 playbook 时，JBoss Web 服务器集合会在每个目标主机上自动创建指定的用户帐户和组名称。

如需更多信息，请参阅确保目标主机上创建产品用户和组。

默认情况下，JBoss Web 服务器集合没有配置为将 Red Hat JBoss Web Server 设置为系统守护进程可以管理的服务。但是，如果您希望 JBoss Web 服务器集合将 Red Hat JBoss Web Server 与系统守护进程集成，您可以设置一个变量来修改 JBoss Web Server 集合的行为，以匹配您的设置要求。

如果您启用此功能，JBoss Web 服务器集合会在每个目标主机上自动将 Red Hat JBoss Web Server 设置为 jws5-tomcat 服务。但是，如果要使用不同的服务名称，您也可以设置变量来指示 JBoss Web 服务器集合来创建不同的服务名称。

注意

JBoss Web Server 服务由 systemd 管理。

如果您还没有启用红帽构建的 OpenJDK 自动安装，还必须设置一个变量来指定目标主机上安装的 JDK 的位置。此步骤是确保成功与 systemd 集成所必需的。

如需更多信息，请参阅启用 JBoss Web Server 与 systemd的自动化集成。

2.2.12. 自动配置 Red Hat JBoss Web Server 产品功能
复制链接

JBoss Web 服务器集合提供了一组全面的变量，以启用红帽 JBoss Web 服务器安装的自动配置。默认情况下，JBoss Web 服务器集合将 Red Hat JBoss Web Server 配置为侦听端口 8080 上的非安全 HTTP 连接。

其它产品功能默认是禁用的：

  • 支持安全 HTTPS 连接
  • mod_cluster 支持将 HTTP 服务器请求负载平衡到 JBoss Web 服务器后端
  • 将敏感数据存储在加密的 Java 密钥存储中的密码库
  • 支持 JBoss Web 服务器和 Apache HTTP 服务器之间的 Apache JServ 协议(AJP)流量

要启用更广泛的产品功能，您可以设置变量来修改 JBoss Web Server 集合的行为，以匹配您的设置要求。

如需更多信息，请参阅启用 JBoss Web 服务器配置任务。

2.2.13. JBoss Web 服务器应用程序自动化部署
复制链接

您还可以通过添加自定义任务到 playbook 来自动化在目标主机上部署 Web 应用程序。如果要在红帽 JBoss Web 服务器已在运行时部署新的或更新的应用程序，JBoss Web 服务器集合将提供一个处理程序，以便在部署应用程序时重新启动 Web 服务器。

如需更多信息，请参阅 在目标主机上启用 JBoss Web Server 应用程序的自动部署。

第 3 章 已解决的问题
复制链接

在 JBoss Web 服务器集合的最新版本中解决了以下问题：

Expand
问题描述

AMW-203

jws_conf_loggging 变量中的拼写错误

AMW-200

jws_selinux_enabled requires jws_native

第 4 章 已知问题
复制链接

JBoss Web 服务器集合的最新版本没有已知的问题。

法律通告
复制链接

Copyright © 2025 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat