搜索

第 3 章 启用 JBoss Web 服务器自动化部署

download PDF

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 服务器集合会自动提取存档文件。

流程

  1. 在 Ansible 控制节点上,打开 vars.yml 文件。
  2. 要指定要安装的 JBoss Web Server 版本,请将 jws_version 变量设置为适当的基本发行版本。

    例如:

    [...]
    jws_version: 6.0.0
    注意

    确保为 jws_version 变量指定的值与您要安装的产品存档文件的版本匹配。例如,要为 JBoss Web Server 6.0 安装存档文件,请指定值 6.0.0

  3. 如果您还想为目标主机上的操作系统安装原生 JBoss Web Server 归档,请执行以下操作:

    1. jws_native 变量设置为 True

      例如:

      [...]
      jws_native: True
      注意

      默认情况下,jws_native 变量被设置为 False,这意味着 JBoss Web Server 集合只会安装主应用服务器存档。

      如果将 jws_native 变量设置为 True,且您没有启用自动文件下载,请确保也获取并复制了原生存档文件到 Ansible 控制节点。在这种情况下,请确保复制的存档文件与目标主机上安装的操作系统版本匹配。

    2. 如果要为 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 版本安装其中一个默认原生存档文件,则不需要这一步。

  4. 如果您希望集合从红帽客户门户网站自动下载存档文件,请设置 rhn_usernamerhn_password 变量,以指定您的红帽客户端标识符(ID)和 secret。

    例如:

    [...]
    rhn_username: <client_ID>
    rhn_password: <client_secret>

    在前面的示例中,将 & lt;red_hat_username & gt; 和 <red_hat_password > 替换为与您的红帽服务帐户关联的客户端 ID 和客户端 secret。

    注意

    如果您希望手动下载存档文件,或者已以某种方式获取这些文件,则不需要设置 rhn_usernamerhn_password 变量。

    如果 jws_native 变量也被设置为 True,则集合会自动决定哪些原生存档文件与目标主机上安装的操作系统匹配。如果您的 Ansible 控制节点上已存在适当存档文件的副本,则集合不会再次下载这些存档文件。

  5. 如果您更改了 Ansible 控制节点上下载的存档文件的名称,请设置 zipfile_namejws_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 步 所述,即使您没有更改默认文件名。

  6. 将您的更改保存到 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 服务器集合会自动提取存档文件。

流程

  1. 在 Ansible 控制节点上,打开 vars.yml 文件。
  2. 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 集合安装适当的补丁更新。

  3. 如果您希望集合只为特定版本安装累积补丁,请将 jws_patch_version 变量设置为您要安装的最新补丁版本。

    例如:

    [...]
    jws_apply_patches: True
    jws_patch_version: 6.0.2

    根据前面的示例,集合只会安装最多 6.0.2 版本的累积补丁,即使后续补丁也可用。

    注意

    如果您希望集合安装最新的累积补丁更新,则不需要设置 jws_patch_version 变量。在这种情况下,集合会根据您在 jws_version 变量中指定的产品版本决定要安装的正确补丁。

  4. 如果您希望集合从红帽客户门户网站自动下载存档文件,请设置 rhn_usernamerhn_password 变量,以指定您的红帽客户端标识符(ID)和 secret。

    例如:

    [...]
    rhn_username: <client_ID>
    rhn_password: <client_secret>

    在前面的示例中,将 & lt;red_hat_username & gt; 和 <red_hat_password > 替换为与您的红帽服务帐户关联的客户端 ID 和客户端 secret。

    注意

    如果您希望手动下载存档文件,或者已以某种方式获取这些文件,则不需要设置 rhn_usernamerhn_password 变量。

    如果 jws_native 变量也被设置为 True,则集合会自动决定哪些原生存档文件与目标主机上安装的操作系统匹配。如果您的 Ansible 控制节点上已存在适当存档文件的副本,则集合不会再次下载这些存档文件。

    如果将 jws_patch_version 变量设置为特定版本,则集合只会将所有累积补丁下载到该补丁版本,即使后续补丁也可用。

  5. 默认情况下,JBoss Web 服务器集合配置为联系红帽客户门户网站,以检查新的补丁更新是否可用。如果要强制完全离线安装,并防止集合联系红帽客户门户网站,请将 jws_offline_install 变量设置为 True

    例如:

    [...]
    jws_offline_install: True
    注意

    如果您的 Ansible 控制节点无法访问互联网,并且希望集合避免联系红帽客户门户网站以进行文件下载,则 jws_offline_install 变量很有用。在这种情况下,您必须确保 Ansible 控制节点上已存在适当存档文件的副本。

    如果将 jws_offline_install 变量设置为 True,则集合不会尝试联系红帽客户门户网站,即使您也设置了 rhn_usernamerhn_password 变量来启用自动文件下载。

  6. 将您的更改保存到 vars.yml 文件。

通过设置这些变量,您可以启用 JBoss Web Server 集合,以便在随后运行 playbook 时在目标主机上自动安装产品补丁更新。

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

© 2024 Red Hat, Inc.