红帽全球峰会第 2 章 升级到 Red Hat Ansible Automation Platform 2.6
要升级 Red Hat Ansible Automation Platform，请首先查看规划升级以确保成功升级。https://docs.redhat.com/en/documentation/red_hat_ansible_automation_platform/2.6/html/planning_your_upgrade然后您可以下载 Ansible Automation Platform 安装程序所需的版本，在安装捆绑包中配置清单文件以反映您的环境，然后运行安装程序。
在 Ansible Automation Platform 2.6 中，虽然自动化控制器的 API 保持向后兼容性，新的安装必须使用平台网关 API 来管理机构、团队和用户。使用旧 API 将引入最多 15 分钟的延迟，然后更改会同步到所有组件，包括 Event-Driven Ansible 控制器。
2.1. 升级先决条件
在开始升级过程前，请查看以下注意事项，以计划并准备 Ansible Automation Platform 部署：
2.1.1. Ansible Automation Platform 要求
- 在从以前的 Ansible Automation Platform 版本升级时，请验证您有有效的订阅。在升级过程中会执行现有订阅。
- 查看 规划升级以了解升级要求 和场景，以及 RPM 拓扑和基础架构的 测试部署模型。
- 在升级到 2.6 之前，请确保您位于 Ansible Automation Platform 2.4 或 2.5。您只能从 Ansible Automation Platform 2.4 或 2.5 升级到 2.6。
在升级到 Red Hat Ansible Automation Platform 2.6 之前，升级到 Ansible Automation Platform 2.4 或 2.5 的最新版本。
重要- 当从 Ansible Automation Platform 2.4 升级到 2.6 时，自动化控制器、自动化中心和 Event-Driven Ansible 控制器的 API 端点都可用。这些 API 已被弃用，并将在即将推出的发行版本中被禁用。此宽限期是允许迁移到使用平台网关的新 API。
- 如果从 Ansible Automation Platform 2.4 升级到 2.5，则必须在升级到 2.6 前迁移身份验证方法和用户，因为旧的验证器功能已被删除。有关迁移用户的详情，请参考对 2.5 的 RPM 升级和迁移指南 中的迁移 单点登录(SSO)用户。
- 在升级前备份 Ansible Automation Platform 环境，以防出现任何问题。如需 环境的特定拓扑，请参阅备份 Ansible Automation Platform 实例 以及 Operator 环境的备份和恢复。
- 在升级前捕获您的清单或实例组详情。
查看平台网关要求：
- Ansible Automation Platform 2.4 到 2.6 升级包括 平台网关。确保您查看 2.6 网络端口和协议， 以了解架构更改。
- 平台网关有多个关联的清单文件变量，需要一些变量。有关 2.6 的新和更改变量的详情，请参阅 附录 A. 清单文件变量。
当从 Ansible Automation Platform 2.4 升级到 2.6 时，如果您使用负载均衡器后面的自动化控制器，在平台网关 UI 上连接到平台网关 URL 可能会失败。此时会显示以下出错信息：
Error connecting to Controller API要解决这个问题，对于每个自动化控制器主机，请为每个自动化控制器主机的 settings.py 文件中的
CSRF_TRUSTED_ORIGIN设置中添加平台网关 URL。然后，您必须重启每个自动化控制器主机，以便实施 URL 更改。如需更多信息，请参阅 Ansible Automation Platform 故障排除中的升级。
查看 Ansible Automation Platform 为独立和集群拓扑提供的 集中式 Redis 实例。
- Ansible Automation Platform 2.6 在独立 和集群拓扑中提供集中的 Redis 实例。https://docs.redhat.com/en/documentation/red_hat_ansible_automation_platform/2.6/html/planning_your_installation/ha-redis_planning#gw-clustered-redis_planning有关如何配置 Redis 的详情，请参考 RPM 安装指南中的配置 Redis。
- 兼容 Redis 高可用性(HA)部署需要 6 个虚拟机。Redis 可以在每个 Ansible Automation Platform 组件虚拟机上并置，但自动化控制器、执行节点或 PostgreSQL 数据库除外。
- 基于 RPM 的 Ansible Automation Platform 部署不支持外部 Redis。
限制：
- 支持将 Event-Driven Ansible 2.5 升级到 2.6，但不支持从 Event-Driven Ansible 2.4 升级到 2.6。Event-Driven Ansible 2.4 和 Event-Driven Ansible 2.6 之间的数据库迁移不兼容。如果您要从 Ansible Automation Platform 2.4 升级到 2.6，并且部署了 Event-Driven Ansible，您必须首先删除 Event-Driven Ansible 2.4 数据库，然后将平台升级到 2.6。有关流程的详情，请参考 删除 Event-Driven Ansible 2.4 数据库。
2.1.2. 系统要求
| 类型 | 描述 | 注 |
|---|---|---|
| 订阅 | 有效的 Red Hat Ansible Automation Platform 订阅 | |
| 操作系统 | Red Hat Enterprise Linux 9.4 或更高版本的 Red Hat Enterprise Linux 9 次版本 | OpenShift 还支持 Red Hat Ansible Automation Platform。如需更多信息，请参阅在 OpenShift Container Platform 上安装。 |
| CPU 架构 | x86_64, AArch64, s390x (IBM Z), ppc64le (IBM Power) | |
| ansible-core | ansible-core 版本 2.16 或更高版本 | Ansible Automation Platform 使用系统范围的 ansible-core 软件包来安装平台，但在其 control plane 和内置执行环境中使用 ansible-core 2.16。 |
| 浏览器 | 当前支持的 Mozilla Firefox 或 Google Chrome 版本。 | |
| 数据库 |
|
|
2.1.3. 数据库要求
Ansible Automation Platform 可以使用两个数据库的不同：
- 使用 Ansible Automation Platform 安装的数据库 - 此数据库由 PostgreSQL 安装组成，作为红帽提供的 PostgreSQL 软件包的一部分完成。
- 客户提供或配置的数据库 - 这是客户提供的外部数据库，无论是裸机、虚拟机、容器还是云托管服务上。Ansible Automation Platform 需要客户提供（外部）数据库才能获得 ICU 支持。
- 在将 PostgreSQL 用户密码保存到数据库前，会使用 SCRAM-SHA-256 安全散列算法对其进行处理。
- 在出现任何问题时，请确保在升级前备份 Ansible Automation Platform 环境。有关 环境的特定拓扑，请参阅 备份和恢复 Operator 环境。
2.1.4. 用户权限
确保在 Red Hat Enterprise Linux 主机上配置了专用的非 root 用户。
- 此用户需要 sudo 或其他 Ansible 支持的特权升级（建议sudo）在安装过程中执行管理任务。
- 此用户负责安装 RPM Ansible Automation Platform。
- 您可以通过 sudo 命令或通过特权升级来获取 root 访问权限。您可以将特权从 root 分到用户，如 AWX、PostgreSQL、Event-Driven Ansible 或 Pulp。
- 每个节点上都配置了 NTP 客户端。
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}