Menu Close

Red Hat Ansible Automation Platform 升级和迁移指南

Red Hat Ansible Automation Platform 2.1

升级到最新版本的 Ansible Automation Platform,并将旧虚拟环境迁移到自动化执行环境

摘要

提供反馈:
如果您对本文档有任何改进建议,或者发现错误,请在 https://issues.redhat.com 中创建一个问题。选择 Ansible Automation Platform项目,并使用 Documentation 组件。

第 1 章 升级 Red Hat Ansible Automation Platform

要将 Red Hat Ansible Automation Platform 升级到更新的版本,请下载 Ansible Automation Platform 安装程序所需的版本。使用您在之前安装中使用的相同参数进行配置,配置任何新参数,然后运行安装程序。

在某些情况下,如果您计划升级 Ansible Automation Platform 的其他组件,如自动化控制器,您可能需要配置其他设置。以下小节更详细地描述了这些步骤。

1.1. 升级计划

根据您的安装,在尝试升级 Red Hat Ansible Automation Platform 时,可能会考虑一些更改。

升级自动化控制器

如果您计划将自动化控制器实例与 Ansible Automation Platform 升级,请查看以下信息:

  • 即使您已经拥有之前版本的有效许可证,您仍必须在升级到最新版本的自动化控制器时提供您的凭证或订阅清单。请参阅 Automation Controller 用户指南中的导入订阅
  • 如果需要升级 Red Hat Enterprise Linux 和自动化控制器,则需要备份和恢复自动化控制器数据。如需更多详情,请参阅备份和恢复 Tower
  • 在开始升级前,集群升级需要特别注意实例和实例组。详情请参阅集群

完成升级计划过程中的必要更改,请下载 Ansible Automation Platform 安装程序所需的版本。

1.2. 选择并获取 Red Hat Ansible Automation Platform 安装程序

根据您的 Red Hat Enterprise Linux 环境互联网连接,选择您需要的 Red Hat Ansible Automation Platform 安装程序。查看以下场景,并确定哪个 Red Hat Ansible Automation Platform 安装程序满足您的需求。

注意

需要有效的红帽客户帐户才能访问红帽客户门户上的 Red Hat Ansible Automation Platform 安装程序下载。

使用互联网访问进行安装

如果您的 Red Hat Enterprise Linux 环境连接到互联网,请选择 Red Hat Ansible Automation Platform 安装程序。通过互联网访问进行安装将检索最新的软件仓库、软件包和依赖项。

  1. 进入 https://access.redhat.com/downloads/content/480
  2. Ansible Automation Platform <latest-version> SetupDownload Now
  3. 解压文件:

    $ tar xvzf ansible-automation-platform-setup-<latest-version>.tar.gz

在没有互联网访问的情况下安装

如果您无法访问互联网,或者不想从在线存储库安装独立的组件和依赖项,请使用 Red Hat Ansible Automation Platform Bundle 安装程序。仍然需要访问 Red Hat Enterprise Linux 软件仓库。所有其他依赖项都包含在 tar 归档中。

  1. 进入 https://access.redhat.com/downloads/content/480
  2. Ansible Automation Platform <latest-version> Setup BundleDownload Now
  3. 解压文件:

    $ tar xvzf ansible-automation-platform-setup-bundle-<latest-version>.tar.gz

1.3. 设置清单文件

要使用 Red Hat Ansible Automation Platform 安装程序升级,请编辑安装程序中找到的 inventory 文件,使其与所需的配置匹配。在编辑 inventory 文件时,您可以使用之前 Ansible Automation Platform 设置中的 inventory 文件参数保持与之前相同的配置。您还可以在 Red Hat Ansible Automation Platform 的新版本中启用 inventory 文件中引入的任何新参数。

流程

  1. 进入安装程序:

    捆绑的安装程序
    $ cd ansible-automation-platform-setup-bundle-<latest-version>
    在线安装程序
    $ cd ansible-automation-platform-setup-<latest-version>
  2. 使用文本编辑器打开清单文件。
  3. 编辑 inventory 文件参数,使其与之前版本的 Red Hat Ansible Automation Platform 中的 inventory 文件匹配。

    注意

    要查看有关具体情况的清单文件要求的信息,请参阅 Red Hat Ansible Automation Platform 安装指南

  4. 可选:编辑 inventory 文件参数,以启用 Red Hat Ansible Automation Platform 新版本中引入的任何新功能。

    注意

    有关任何新功能以及如何启用它们的更多信息,请参阅 Red Hat Ansible Automation Platform 产品文档来搜索特定功能及其配置。查看 Red Hat Ansible Automation Platform 发行注记,了解每个版本版本的完整功能列表。

1.4. 运行 Red Hat Ansible Automation Platform 安装程序设置脚本

完成更新 inventory 文件后,您可以运行设置脚本,以匹配之前的 Ansible Automation Platform 安装。

流程

  1. 运行 setup.sh 脚本

    $ ./setup.sh

安装将开始。

第 2 章 升级到自动化执行环境

如果从旧版本的自动化控制器升级到 4.0 或更高版本,控制器能够检测之前与机构、清单和作业模板关联的虚拟环境版本;并通知您需要迁移到新的自动化执行环境模型。全新的自动化控制器安装会在安装过程中创建两个 virtualenv一个用于运行控制器本身,另一个用于运行 Ansible。与传统虚拟环境一样,自动化执行环境允许控制器在稳定的环境中运行,同时允许您根据需要在自动化执行环境中添加或更新模块,以运行 playbook。

将旧的 venvs 迁移到自动化执行环境

您可以通过将自定义虚拟环境迁移到新的自动化执行环境,在自动化执行环境中进行完全相同的设置。使用本节中的 awx-manage 命令:

  • 所有当前自定义虚拟环境及其路径列表(list_custom_venvs
  • 查看依赖特定自定义虚拟环境的资源(custom_venv_associations
  • 将特定的自定义虚拟环境导出到可用于迁移到自动化执行环境(export_custom_venv)的格式.

以下工作流描述了如何使用 awx-manage 命令从旧的 venvs 迁移到自动化执行环境。

2.1. 将虚拟环境迁移到自动化执行环境

升级到 Red Hat Ansible Automation Platform 2.0 和自动化控制器 4.0 后,请使用以下部分协助迁移过程中的其他步骤。

2.1.1. 列出自定义虚拟环境

您可以使用 awx-manage 命令列出自动化控制器实例上的虚拟环境。

流程

  1. SSH 到自动化控制器实例并运行:

    $ awx-manage list_custom_venvs

这时将显示已发现的虚拟环境列表。

# Discovered virtual environments:
/var/lib/awx/venv/testing
/var/lib/venv/new_env

To export the contents of a virtual environment, re-run while supplying the path as an argument:
awx-manage export_custom_venv /path/to/venv

2.1.2. 查看与自定义虚拟环境关联的对象

使用 awx-manage 命令,查看与自定义虚拟环境关联的组织、作业和清单源。

流程

  1. SSH 到自动化控制器实例并运行:

    $ awx-manage custom_venv_associations /path/to/venv

这时将显示相关对象的列表。

inventory_sources:
- id: 15
  name: celery
job_templates:
- id: 9
  name: Demo Job Template @ 2:40:47 PM
- id: 13
  name: elephant
organizations
- id: 3
  name: alternating_bongo_meow
- id: 1
  name: Default
projects: []

2.1.3. 清除要导出的自定义虚拟环境

选择您要使用 awx-manage export_custom_venv 命令导出的自定义虚拟环境。

流程

  1. SSH 到自动化控制器实例并运行:

    $ awx-manage export_custom_venv /path/to/venv

此命令的输出将显示在指定虚拟环境中的 pip freeze 状态。此信息可复制到 Ansible Builder 的 requirements.txt 文件中,用于创建新的自动化执行环境镜像

numpy==1.20.2
pandas==1.2.4
python-dateutil==2.8.1
pytz==2021.1
six==1.16.0

To list all available custom virtual environments run:
awx-manage list_custom_venvs
注意

运行 'awx-manage list_custom_venvs' 以减少输出时传递 -q 标志。

2.2. 其他资源