第 3 章 启用 JBoss Web 服务器自动化部署
JBoss Web Server 集合提供了一组完整的变量和默认值,您可以手动更新以满足您的设置要求。这些变量设置提供了 JBoss Web Server 集合在目标主机上完成 Red Hat JBoss Web Server 的自动化和自定义安装所需的所有信息。
有关 JBoss Web Server 集合提供的变量的完整列表,请查看 Red Hat Automation Hub 中的 jws
角色的信息页面。jws
角色的信息页面列出了您可以定义的所有变量的名称、描述和默认值。
您可以以多种方式定义变量。默认情况下,JBoss Web Server 集合包含一个 playbook.yml
文件示例,该文件链接到同一 /playbooks
文件夹中的 vars.yml
文件。为便于说明,本节中的说明描述了如何在集合提供的 vars.yml
文件中定义变量。如果您希望定义变量,您可以使用不同的方法定义变量。
您可以定义变量来自动化以下任务:
您还可以通过在 playbook 中添加自定义任务来自动部署 Web 应用程序,如在目标主机上 启用 JBoss Web Server 应用程序自动化部署 中所述。
3.1. 从存档文件启用 JBoss Web Server 自动安装
默认情况下,JBoss Web 服务器集合配置为从产品归档文件在每个目标主机上安装 Red Hat JBoss Web Server。根据您的设置要求,您可以启用 JBoss Web Server 集合,从存档文件同时安装基本产品版本、产品补丁更新或两者。您可以选择从红帽客户门户网站手动下载存档文件,或者启用 JBoss Web Server 集合来自动下载存档文件。
3.1.1. 启用基本 JBoss Web 服务器版本的自动安装
您可以启用 JBoss Web Server 集合,从产品归档文件安装指定 JBoss Web Server 版本的基本版本。基础版本是 特定产品版本的初始发行版本(例如,6.0.0 是版本 6.0 的基本版本)。
JBoss Web 服务器集合要求 Ansible 控制节点上提供了相应存档文件的本地副本。如果存档文件的副本还没有在您的系统中,您可以设置变量来启用集合,以从红帽客户门户网站自动下载存档文件。或者,您可以手动下载存档文件。
先决条件
- 您已安装了 JBoss Web Server 集合。
- 如果系统上已经有 JBoss Web Server 归档文件的副本,您已将这些存档文件复制到 Ansible 控制节点上。
如果您希望 JBoss Web 服务器集合从红帽客户门户网站自动下载存档文件,您已创建了红帽服务帐户。
注意服务帐户可让您安全并自动连接和验证服务或应用程序,而无需最终用户凭证或直接交互。要创建服务帐户,请登录到 Red Hat Hybrid Cloud Console 中的 Service Accounts 页面,然后点 Create service account。
如果您希望手动下载存档文件,您可以将适当的存档文件下载到 Ansible 控制节点。如需更多信息,请参阅 Red Hat JBoss Web Server 安装指南。
注意如果手动下载存档文件,则不需要在 Ansible 控制节点上提取这些文件。在这种情况下,JBoss Web 服务器集合会自动提取存档文件。
流程
-
在 Ansible 控制节点上,打开
vars.yml
文件。 要指定要安装的 JBoss Web Server 版本,请将
jws_version
变量设置为适当的基本发行版本。例如:
[...] jws_version: 6.0.0
注意确保为
jws_version
变量指定的值与您要安装的产品存档文件的版本匹配。例如,要为 JBoss Web Server 6.0 安装存档文件,请指定值6.0.0
。如果您还想为目标主机上的操作系统安装原生 JBoss Web Server 归档,请执行以下操作:
将
jws_native
变量设置为True
。例如:
[...] jws_native: True
注意默认情况下,
jws_native
变量被设置为False
,这意味着 JBoss Web Server 集合只会安装主应用服务器存档。如果将
jws_native
变量设置为True
,且您没有启用自动文件下载,请确保也获取并复制了原生存档文件到 Ansible 控制节点。在这种情况下,请确保复制的存档文件与目标主机上安装的操作系统版本匹配。如果要为 JBoss Web Server 6.0 安装原生存档文件,还要设置
jws_native_zipfile
变量来指定适当的文件名。例如:
[...] jws_native_zipfile: jws-6.0.0-optional-native-components-RHEL8-x86_64.zip
重要由于 JBoss Web Server 6.0 中原生归档文件的命名格式的变化,如果您要为 6.0.0 版本安装原生存档文件,则此步骤是必须的。在这种情况下,请确保为目标主机上安装的操作系统指定正确的原生存档文件。
注意如果要为 JBoss Web Server 5.x 版本安装其中一个默认原生存档文件,则不需要这一步。
如果您希望集合从红帽客户门户网站自动下载存档文件,请设置
rhn_username
和rhn_password
变量,以指定您的红帽客户端标识符(ID)和 secret。例如:
[...] rhn_username: <client_ID> rhn_password: <client_secret>
在前面的示例中,将 & lt;red_hat_username & gt; 和 <red_hat_password > 替换为与您的红帽服务帐户关联的客户端 ID 和客户端 secret。
注意如果您希望手动下载存档文件,或者已以某种方式获取这些文件,则不需要设置
rhn_username
和rhn_password
变量。如果
jws_native
变量也被设置为True
,则集合会自动决定哪些原生存档文件与目标主机上安装的操作系统匹配。如果您的 Ansible 控制节点上已存在适当存档文件的副本,则集合不会再次下载这些存档文件。如果您更改了 Ansible 控制节点上下载的存档文件的名称,请设置
zipfile_name
和jws_native_zipfile
变量,以指定您要安装的文件。例如:
[...] zipfile_name: <application_server_file> jws_native_zipfile: <native_file>
在前面的示例中,将 < application_server_file> 和 <native_file > 替换为适当的归档文件名。
注意如果您没有更改主应用服务器存档文件的名称,则不需要设置
zipfile_name
变量。JBoss Web Server 集合使用jws_version
变量的值自动确定默认文件名。如果要为 JBoss Web Server 6.0 安装原生存档文件,您必须设置
jws_native_zipfile
变量,如 第 3b 步 所述,即使您没有更改默认文件名。-
将您的更改保存到
vars.yml
文件。
通过设置这些变量,您可以启用 JBoss Web Server 集合,以便在随后运行 playbook 时在目标主机上自动安装基础产品版本。
3.1.2. 启用 JBoss Web 服务器补丁更新的自动安装
如果产品补丁更新可用于正在安装的 JBoss Web 服务器版本,您也可以启用 JBoss Web Server 集合从存档文件安装这些补丁更新。根据您的要求,您可以启用 JBoss Web Server 集合,以只为特定版本安装最新的累积补丁或累积补丁。您可以使用相同的步骤启用补丁更新的自动安装,无论您要与基本发行版本同时安装这些更新。
JBoss Web 服务器集合要求 Ansible 控制节点上提供了相应存档文件的本地副本。如果存档文件的副本还没有在您的系统中,您可以设置变量来启用集合,以从红帽客户门户网站自动下载存档文件。或者,您可以手动下载存档文件。
您不能使用 累积补丁更新来安装产品版本的基础(X.X.0)版本。例如,安装 6.0.2 补丁将安装 6.0.1 和 6.0.2 版本,但无法安装基本 6.0.0 版本。在这种情况下,您必须确保适当产品版本的基本版本(如 6.0.0)也同时安装或之前安装。
先决条件
- 您已安装了 JBoss Web Server 集合。
- 如果系统上已存在您要安装的最新补丁更新存档文件的副本,您已将这些存档文件复制到 Ansible 控制节点。
如果您希望 JBoss Web 服务器集合从红帽客户门户网站自动下载存档文件,您已创建了红帽服务帐户。
注意服务帐户可让您安全并自动连接和验证服务或应用程序,而无需最终用户凭证或直接交互。要创建服务帐户,请登录到 Red Hat Hybrid Cloud Console 中的 Service Accounts 页面,然后点 Create service account。
如果您希望手动下载存档文件,您可以将适当的存档文件下载到 Ansible 控制节点。如需更多信息,请参阅 Red Hat JBoss Web Server 安装指南。
注意补丁更新是累积的。您不需要为当前未安装的任何早期补丁更新下载存档文件。
如果手动下载存档文件,则不需要在 Ansible 控制节点上提取这些文件。在这种情况下,JBoss Web 服务器集合会自动提取存档文件。
流程
-
在 Ansible 控制节点上,打开
vars.yml
文件。 将
jws_apply_patches
变量设置为True
。例如:
[...] jws_version: 6.0.0 jws_native: True [...] jws_apply_patches: True
注意确保将
jws_version
变量设置为相应产品版本(如6.0.0
)的基础版本。如果
jws_native
变量设置为True
,且您没有启用自动文件下载,请确保已将适当的补丁版本的原生存档文件复制到 Ansible 控制节点。在这种情况下,请确保复制的存档文件与目标主机上安装的操作系统版本匹配。将
jws_apply_patches
变量设置为True
可让 JBoss Web Server 集合安装适当的补丁更新。如果您希望集合只为特定版本安装累积补丁,请将
jws_patch_version
变量设置为您要安装的最新补丁版本。例如:
[...] jws_apply_patches: True jws_patch_version: 6.0.2
根据前面的示例,集合只会安装最多 6.0.2 版本的累积补丁,即使后续补丁也可用。
注意如果您希望集合安装最新的累积补丁更新,则不需要设置
jws_patch_version
变量。在这种情况下,集合会根据您在jws_version
变量中指定的产品版本决定要安装的正确补丁。如果您希望集合从红帽客户门户网站自动下载存档文件,请设置
rhn_username
和rhn_password
变量,以指定您的红帽客户端标识符(ID)和 secret。例如:
[...] rhn_username: <client_ID> rhn_password: <client_secret>
在前面的示例中,将 & lt;red_hat_username & gt; 和 <red_hat_password > 替换为与您的红帽服务帐户关联的客户端 ID 和客户端 secret。
注意如果您希望手动下载存档文件,或者已以某种方式获取这些文件,则不需要设置
rhn_username
和rhn_password
变量。如果
jws_native
变量也被设置为True
,则集合会自动决定哪些原生存档文件与目标主机上安装的操作系统匹配。如果您的 Ansible 控制节点上已存在适当存档文件的副本,则集合不会再次下载这些存档文件。如果将
jws_patch_version
变量设置为特定版本,则集合只会将所有累积补丁下载到该补丁版本,即使后续补丁也可用。默认情况下,JBoss Web 服务器集合配置为联系红帽客户门户网站,以检查新的补丁更新是否可用。如果要强制完全离线安装,并防止集合联系红帽客户门户网站,请将
jws_offline_install
变量设置为True
。例如:
[...] jws_offline_install: True
注意如果您的 Ansible 控制节点无法访问互联网,并且希望集合避免联系红帽客户门户网站以进行文件下载,则
jws_offline_install
变量很有用。在这种情况下,您必须确保 Ansible 控制节点上已存在适当存档文件的副本。如果将
jws_offline_install
变量设置为True
,则集合不会尝试联系红帽客户门户网站,即使您也设置了rhn_username
和rhn_password
变量来启用自动文件下载。-
将您的更改保存到
vars.yml
文件。
通过设置这些变量,您可以启用 JBoss Web Server 集合,以便在随后运行 playbook 时在目标主机上自动安装产品补丁更新。