AlmaLinux使用ELevate跨主版本升级前,要核对哪些依赖并怎样安排回退?
AlmaLinux 使用 ELevate 跨主版本升级时,首先要核对的不是某一个 RPM 包,而是源版本与目标版本是否存在受支持的升级路径,以及启用的软件仓库、模块流、第三方软件、内核驱动、运行时环境和数据存储是否能够一起迁移。leapp preupgrade 可以发现大量阻断项,但它不能替代业务测试,也不能证明应用一定适配目标版本。
回退必须在执行 leapp upgrade 之前安排完成。主版本升级会改变 RPM 依赖、系统库、systemd、启动项和安全策略,通常不存在可靠的一键降级方案,dnf history undo 也不适合作为跨主版本回滚手段。生产环境应准备经过恢复验证的整机镜像、虚拟机快照或重建方案,并明确数据库一致性、业务切流和回退触发条件。
A5idc数据提供中国香港、美国、日本、韩国、中国台湾、新加坡和马来西亚等地区的物理服务器资源,覆盖常规建站、数据库、接口服务及多任务计算场景。不同产品配备Xeon或AMD EPYC处理器、NVMe或大容量硬盘,并提供多种网络线路与IP配置,可为AlmaLinux业务系统的测试、灰度部署、生产运行及重建环境提供硬件与区域资源基础。
现状核对:先确认升级路径和依赖边界
1. 核对源版本、目标版本和运行架构
ELevate 不是通用的发行版降级工具,必须先确认当前系统、目标系统、CPU 架构和升级路径均在当前版本的支持范围内。不同主版本之间的可升级路径、支持的架构和所需软件包可能变化,例如某些 7 到 8、8 到 9 的路径需要分别使用对应的 ELevate 数据包,不能把一套命令直接套用到所有版本。
建议先保存以下只读信息:
cat /etc/os-release
cat /etc/almalinux-release 2>/dev/null || true
rpm -E '%{rhel}'
uname -m
uname -r
systemd-detect-virt 2>/dev/null || true
重点确认以下内容:
- 当前确实是 AlmaLinux,或者是 ELevate 当前支持的兼容发行版。
- 源主版本和目标主版本明确,例如 8 到 9,而不是只知道“升级到最新版”。
- CPU 架构、虚拟化平台、云平台镜像类型在目标路径中有对应支持。
- 系统是否使用 UEFI、独立
/boot、独立/boot/efi、软件 RAID、LVM 或加密磁盘。 - 是否通过控制面板、云厂商代理或第三方管理系统维护了特殊启动项和仓库配置。
若当前系统是托管在云平台或虚拟化平台上,还要确认快照是否覆盖全部系统盘、数据盘和 EFI 分区。只对系统盘做快照,而数据库或上传文件位于独立数据盘时,回退后可能出现系统版本回去了、数据却仍处于新状态的分裂情况。

2. 按对象核对依赖,而不是只检查系统包
跨主版本升级中的“依赖”至少包含系统包依赖、软件仓库依赖、应用运行时依赖和硬件驱动依赖。它们的判断标准并不相同。
| 核对对象 | 需要确认的内容 | 可接受的结果 | 不满足时的处理 |
|---|---|---|---|
| 基础系统 | 源版本、目标版本、架构、启动方式 | 路径和架构均在当前支持矩阵内 | 暂停变更,改用重装迁移或其他受支持路径 |
| RPM 包状态 | 冲突包、损坏依赖、重复包、版本锁定 | dnf check 无关键错误,未锁定核心包 | 先修复包状态,不能带着错误进入升级 |
| 软件仓库 | BaseOS、AppStream、ELevate 及必要扩展仓库 | 使用与源版本、目标版本匹配的仓库 | 清理过期仓库配置,确认第三方仓库目标版本 |
| 模块流 | PHP、数据库、编译器、运行时模块流 | 目标版本存在对应模块流和升级方案 | 记录当前模块流,按应用兼容性选择目标流 |
| 第三方软件 | 监控、备份、安全代理、驱动、控制面板 | 厂商提供目标主版本软件包 | 升级前暂停、替换或迁移该组件 |
| 内核与启动 | DKMS、厂商驱动、GRUB、EFI、RAID | 目标内核可加载,控制台可访问 | 先在测试机验证,保留镜像回退 |
| 应用运行时 | OpenSSL、glibc、Python、Java、PHP、Node.js 等 | 应用已在目标版本上验证 | 升级应用或准备重建环境,不强行保留旧运行时 |
| 数据与存储 | 文件系统挂载、数据库、队列、对象或上传文件 | 有一致性备份并完成恢复验证 | 先完成备份和恢复演练 |
| 认证与安全 | SELinux、PAM、SSSD、LDAP、证书、加密策略 | 登录、授权、证书验证均有测试结果 | 让安全或身份系统负责人参与变更 |
可以先检查仓库、包状态、模块和磁盘空间:
dnf repolist --enabled
dnf check
dnf modules list --enabled 2>/dev/null || true
dnf versionlock list 2>/dev/null || true
df -hT
findmnt / /var /boot /boot/efi 2>/dev/null || true
dnf check 没有输出通常是较好的信号,但不能据此判断应用已经兼容。特别要关注以下情况:
/etc/yum.repos.d/中仍存在旧主版本仓库。- 自建仓库只提供旧版本的 RPM。
- 启用了版本锁定,阻止核心包或内核切换。
- 当前使用的模块流在目标主版本中已移除或更名。
- 安全代理、备份代理或监控代理包含旧版
glibc、Python 或内核模块依赖。 - 应用直接依赖旧版 OpenSSL、旧版 Python 解释器路径或特定内核接口。
- 数据库、消息队列和搜索服务使用了独立仓库,且其目标版本尚未验证。
3. 单独确认第三方仓库和外部依赖
ELevate 主要处理操作系统层面的迁移,不会替所有第三方软件完成应用级兼容性改造。启用的 EPEL、数据库仓库、语言运行时仓库、厂商安全软件仓库,都应分别确认目标主版本的版本线。
不能简单地把所有第三方仓库全部删除,也不能不加判断地继续保留旧仓库。删除仓库文件可能影响回退和后续审计,正确做法是先备份配置、记录启用状态,再按照供应商提供的目标版本方案切换。
建议保存包清单和服务清单:
stamp=$(date +%F-%H%M)
rpm -qa --qf '%{NAME}-%{VERSION}-%{RELEASE}.%{ARCH}\n' \
| sort > "/root/rpm-inventory-${stamp}.txt"
dnf repolist --enabled > "/root/dnf-repos-${stamp}.txt"
systemctl list-unit-files --state=enabled \
> "/root/enabled-services-${stamp}.txt"
对于业务依赖,还要通过应用自身的方式核对。例如:
- Web 应用:确认 PHP、Java、Node.js 或 Python 的主版本和扩展清单。
- 数据库:确认客户端库、认证插件、字符集、备份工具和连接池。
- 文件服务:确认挂载点、ACL、SELinux 上下文和定时任务。
- 监控与备份:确认目标系统有可安装的代理版本,并且不会阻断网络、磁盘或启动流程。
- 身份认证:确认 PAM、SSSD、LDAP、证书和时间同步服务的目标版本配置。
变更准备:把回退做成可执行动作
1. 先完成可恢复备份
回退方案不是“已经有一个快照”这么简单,而是要回答三个问题:恢复什么、恢复到哪里、恢复后如何证明业务可用。
至少准备以下内容:
- 整机镜像或虚拟机快照,覆盖系统盘、启动分区和相关数据盘。
/etc、应用配置、证书、密钥引用、定时任务和自定义 systemd 单元的独立备份。- 数据库的一致性备份,并在另一台环境完成恢复测试。
- 上传文件、队列数据、对象存储索引和其他不在系统盘中的业务数据备份。
- 包清单、仓库清单、网络配置、挂载配置和防火墙策略记录。
- 回退所需的控制台、带外管理或云平台串口访问权限。
数据库不能只复制正在使用的数据文件作为备份。应使用数据库自身的逻辑备份、物理备份、快照一致性机制或复制节点切换方案。若数据库与应用位于不同主机,回退系统时要同时考虑数据库版本、应用写入和复制延迟。
快照适合缩短恢复时间,但不能替代独立备份。快照回退会丢失快照之后的写入,且不同存储平台对内存状态、数据盘和外部挂载的处理方式不同。回退前必须明确是否需要停止写入、暂停队列消费和冻结外部同步。
2. 先做测试机或灰度机升级
生产主机直接升级的风险,通常来自未被包管理器识别的应用行为。推荐复制一台与生产环境接近的测试机,至少保持以下条件一致:
- 相同的 AlmaLinux 源版本、目标版本和架构。
- 相同的启用仓库、模块流和主要第三方软件。
- 相同或接近的数据库客户端、运行时和安全策略。
- 相同的挂载方式、SELinux 模式、身份认证方式和监控代理。
- 使用脱敏后的真实配置和具有代表性的业务数据。
测试机的目标不是证明“命令能够执行”,而是提前发现应用启动、认证、证书、文件权限、定时任务和外部连接问题。测试通过后再安排生产变更,并优先选择可从负载均衡或业务入口摘除的节点。
3. 冻结无关变更并安排控制台
在升级窗口内暂停以下操作:
- 应用版本发布和数据库结构变更。
- 仓库调整、内核升级和大规模配置管理任务。
- 自动清理、自动重启和非必要的定时任务。
- 可能在升级过程中写入大量数据的批处理任务。
ELevate 会准备目标系统用户空间并修改启动流程,升级阶段不能只依赖 SSH。生产窗口必须具备云控制台、虚拟化控制台或带外管理能力;如果主机重启后无法联网,仍应能查看启动日志、选择启动项或执行恢复操作。
分步实施:先预检,再进入升级交易
1. 安装与源版本匹配的 ELevate 组件
确认备份已完成、快照已创建并记录快照时间后,再安装与当前路径匹配的 ELevate 仓库和 Leapp 数据包。包名和仓库位置可能随主版本及项目发布变化,以下命令仅适用于已经配置了对应官方仓库的场景:
dnf info elevate-release leapp-upgrade leapp-data-almalinux
dnf install -y elevate-release
dnf install -y leapp-upgrade leapp-data-almalinux
如果 dnf info 找不到这些包,不要随意从不明来源下载 RPM,也不要把其他发行版的 Leapp 数据包混用。应重新核对当前源版本、目标版本和 ELevate 对应路径。
安装完成后确认包来源:
rpm -q elevate-release leapp-upgrade leapp-data-almalinux
dnf repoquery --installed --qf '%{name}-%{version}-%{release}.%{arch}' \
leapp-upgrade leapp-data-almalinux 2>/dev/null || true
2. 执行预升级检查并处理报告
预升级检查应在维护窗口前完成,并留出重复检查的时间:
leapp preupgrade
less /var/log/leapp/leapp-report.txt
同时保留完整日志:
ls -lh /var/log/leapp/
报告中的问题应按风险处理:
- 阻断项或 inhibitor:表示当前状态不适合继续,必须解决后重新运行
leapp preupgrade。 - 高风险警告:需要由应用、数据库、网络或安全负责人确认,不能仅因为命令允许继续就忽略。
- 信息项:记录处理结果,在升级后的验证清单中保留对应检查。
某些检查会要求通过 leapp answer 明确确认。只有在理解报告内容、确认影响范围并经过变更审批后,才处理对应条目:
leapp answer --section <报告中明确要求的section>.confirm=True
leapp preupgrade
不要使用批量确认、猜测 section 名称或为了让报告“变绿”而随意选择确认项。重新运行预检后,仍需确认旧版本仓库、模块流、版本锁定、第三方包和启动配置没有新的冲突。
3. 执行升级并控制重启时点
只有在以下条件同时满足时,才进入升级阶段:

- 目标路径和架构已确认。
- 阻断项已经清零。
- 数据库和业务备份已完成恢复验证。
- 变更窗口、控制台和回退负责人均已就绪。
- 应用负责人确认了停机或切流方案。
- 快照或整机镜像的创建时间已记录。
在已经完成预检的生产主机上执行:
leapp upgrade
该命令会下载并准备目标版本所需内容,修改启动相关配置,执行期间可能占用较多磁盘和网络资源。不要在执行过程中并行运行常规 dnf update、切换仓库或清理 Leapp 生成的文件。
命令返回后先检查日志和磁盘空间,再按维护窗口安排重启。重启会中断业务,且升级阶段可能暂时无法通过网络登录,必须通过控制台确认主机已经进入目标系统。不要把旧内核启动项当成完整回滚方案;旧内核并不等于旧用户空间,混合状态可能造成更严重的不一致。
验证观察:从系统状态延伸到业务结果
主机重启后,先做低风险的系统确认,再恢复全部业务流量:
cat /etc/almalinux-release
rpm -E '%{rhel}'
uname -r
dnf repolist --enabled
dnf check
systemctl --failed --no-pager
getenforce
findmnt -rno TARGET,FSTYPE,OPTIONS
ss -lntup
核对重点包括:
/etc/almalinux-release和%{rhel}显示目标主版本。- 目标仓库已启用,旧主版本仓库没有继续参与日常更新。
/、/var、/boot、数据盘和应用挂载点均存在。- 网络地址、默认路由、DNS、时间同步和主机名正常。
- 没有关键 systemd 服务处于 failed 状态。
- SELinux 模式符合原计划,关键服务没有被拒绝规则阻断。
- 监控、备份、日志、定时任务和安全代理已恢复到目标版本。
- 关键端口监听状态与升级前基线一致。
系统检查通过后,再按照业务依赖顺序恢复服务。不要只检查首页或一个端口,应至少覆盖:
- 负载均衡或入口健康检查。
- 管理员登录、普通用户登录和权限校验。
- 数据库连接、读写操作和连接池。
- 文件上传、下载、权限和持久化。
- 队列生产、消费和失败重试。
- 外部 API、证书校验、邮件或消息通知。
- 定时任务、日志采集、备份任务和监控告警。
可以使用下面的验收表记录结果,具体阈值应采用升级前基线,而不是临时凭感觉判断。
| 验收层级 | 观察内容 | 通过标准示例 |
|---|---|---|
| 系统 | 版本、挂载、网络、失败服务 | 关键服务正常,核心挂载和路由完整 |
| 平台 | 认证、SELinux、监控、备份 | 登录和授权正常,无持续新增阻断日志 |
| 应用 | 健康检查、核心接口、任务队列 | 核心交易或请求链路连续成功 |
| 数据 | 记录、文件、队列、复制状态 | 数量、抽样内容和一致性检查符合基线 |
| 性能 | CPU、内存、磁盘、连接数、延迟 | 未出现超出既定阈值的持续异常 |
| 运维 | 告警、日志、定时任务、发布流程 | 日常运维动作可以正常执行 |
观察时间不能只按“主机已启动”计算。至少应覆盖一次业务高峰、一次重要定时任务和一次备份或日志轮转;全天候业务还应根据流量周期延长观察窗口。若无法在一个窗口内覆盖批处理、结算或报表任务,就应把这些任务纳入延后验收,而不是提前关闭变更。
回滚条件:按阶段选择恢复动作
1. 不同阶段使用不同回退方式
| 阶段 | 典型异常 | 建议动作 |
|---|---|---|
| 预检阶段 | 阻断项未解决、依赖无法确认、备份未验证 | 不执行升级,修复问题或改用重建迁移 |
leapp upgrade 前 | 发现仓库、数据或控制台条件不满足 | 停止变更,保留报告和清单,恢复原有仓库配置 |
leapp upgrade 执行后、重启前 | 命令失败、磁盘不足、关键包异常 | 不强行重启,保存日志,按官方处理路径或快照恢复 |
| 重启后启动失败 | 无法进入目标系统、关键挂载缺失、网络不可用 | 通过控制台采集日志,使用整机快照或镜像恢复 |
| 系统可用但业务失败 | 数据库连接失败、核心接口错误、认证异常 | 立即停止切流,按应用和数据恢复方案回退 |
| 观察窗口内持续异常 | 错误率、延迟、资源占用或数据一致性超阈值 | 排空流量,恢复旧环境或切换到备用节点 |
回退触发条件应在变更单中写成可判断的规则。例如:核心健康检查连续失败超过约定时间、关键挂载点丢失、数据库出现一致性错误、认证系统不可用、备份任务无法运行,或者关键接口错误率持续超过升级前基线,都可以作为回退信号。阈值应由业务负责人根据服务等级确定,不宜由执行人员在故障现场临时修改。
2. 生产回退的推荐顺序
如果升级后的系统仍可操作但业务异常,先停止新增流量并保留现场信息:
- 记录升级日志、系统日志、应用日志和监控截图。
- 停止会继续写入数据的批处理和队列消费。
- 将流量切换到备用节点或维护页面。
- 判断数据库和外部系统是否已经产生新写入。
- 决定使用快照恢复、整机镜像恢复,还是重建旧版本环境并恢复备份。
使用快照时,要对系统盘、数据盘和启动分区执行一致性恢复,不能只恢复其中一个盘。若外部数据库、对象存储或消息系统在升级后继续接收了数据,直接回退本机快照可能造成重复写入或数据分叉,必须先采用复制切换、时间点恢复或业务补偿方案。
若没有可用快照,通常应使用已验证的旧版本镜像重建主机,再恢复配置和业务数据。恢复后重新验证数据库、文件权限、证书、定时任务和外部连接。不要通过大量卸载目标版本包、手工替换 glibc 或执行 dnf history undo 来模拟跨主版本降级,这类操作可能使 RPM 数据库、系统库和启动环境处于不可预测状态。
回退完成后仍要保留升级失败原因和差异清单,避免在未解决根因的情况下重复执行。只有当目标系统重新通过测试机验证、第三方软件完成目标版本适配、备份恢复路径再次确认,并且观察窗口覆盖关键业务周期后,才适合关闭本次变更。任何一次出现启动失败、核心业务不可用、数据一致性无法证明或回退链路不可执行,都应触发既定回退条件,而不是以“系统已经能登录”作为成功标准。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/6670.html



