Skip to content

Releases

v0.7.0 — 升级后集中体检的经验:约 38 台阿里云/华为云机器(17 台由本技能升级到 9.8/10.2),`verify.sh` 全绿但几天后才暴露

Choose a tag to compare

@github-actions github-actions released this 19 Nov 15:22
0375fed

升级后集中体检的经验:约 38 台阿里云/华为云机器(17 台由本技能升级到 9.8/10.2),verify.sh 全绿但几天后才暴露的问题(报告:field-reports/2026-11-19-fleet-post-upgrade-audit.md)。

Added

  • scripts/post-audit.sh:升级完成后的只读体检,输出 HIGH/MEDIUM/INFO。覆盖 logrotate 没被调度和 logrotate -d 报错、Leapp 改坏的 /etc/virc(vi E319)、root 登录 shell 报错、旧版本包、leapp 残留、dnf check/源报错、写死旧版本号的源、内核与启动项、failed/反复 activating 的 unit、写在 [Install] 段的键、EL7 专用 sysctl、失效的服务启用链接、limits 写错、sshd -t/visudo -c/PAM 缺模块、NetworkManager/ifcfg/时间同步/findmnt --verify、本地程序和 failed unit 缺动态库、crond 日志与 root 邮件。POST_AUDIT_OFFLINE=1 不访问网络。(verified-on-real-run:11 台真实机器,结论与人工排查一致;container-smoke:四个镜像运行无 shell 报错)
  • hop.sh tidy:升级后的幂等小修,改动前备份到 /root/os-upgrade-kit/tidy-backup——启用 logrotate.timer(leapp 不对新增 unit 执行 preset,17/17 台升级机日志不再轮转)、注释 fs.may_detach_mounts(跳过链接文件)、virc 没有自定义内容时换回 virc.rpmnew、删除已知旧服务的失效启用链接、docker-ce.repo 写死的 centos/<N> 改回 $releasever。hop.sh post 末尾自动执行,并提示跑 post-audit.sh。(container-smoke:四个镜像的修复与幂等、virc 自定义内容不动;真实机器上同样的修复手工做过,hop.sh tidy 在 4 台已修好的机器上实测为 no-op)
  • hop.sh prep(目标 ≥9):运行中的非 rpm 程序依赖 libldap/liblber-2.4.so.2 时把 openldap-compat 写进 leapp to_install(真实案例:云厂商数据库审计 agent)。(untested)
  • pitfalls.md 第 6 节:升级后的慢性问题(logrotate、virc E319、may_detach_mounts、limits 写错、失效链接、docker-ce 写死版本、libldap-2.4、[Install] 段的键、退回 9.8 后的 leapp 残留);recovery.md F 第 7 步:退回旧版本后清理升级残留;云插件条目补充 cloudResetPwdUpdateAgent。SKILL 阶段 4 加 post-audit.sh。(verified-on-real-run)

Fixed

  • hop.sh post:写死旧版本号的源按 7…上一跳的所有版本号匹配(之前只看上一跳,某跳漏掉的源会一直留着);处理源之前先修 docker-ce.repo 写死的版本号(同文件有 $releasever 段时原规则会跳过它)。(问题 verified-on-real-run;修复 container-smoke)

安装 / Install

/plugin install centos7-almalinux-upgrade --marketplace seaworld008/centos7-lighthouse

完整变更见 CHANGELOG。升级前请先做整机快照,并在非关键机器上先试。

v0.6.3 — 华为云生产 Jenkins 发布机升级到 10.2 的经验(报告:`field-reports/2026-11-13-huawei-prod

Choose a tag to compare

@github-actions github-actions released this 13 Nov 10:18
ac207a2

华为云生产 Jenkins 发布机升级到 10.2 的经验(报告:field-reports/2026-11-13-huawei-prod-jenkins-tomcat.md)。

Added

  • scripts/known-hosts-fill.sh:CI/发布机到 EL10 后,经已信任的 ssh 连接读取目标机主机公钥,补齐 known_hosts 缺的类型——EL10 crypto-policies 固定 HostKeyAlgorithms,只记录了 ECDSA 的目标机会 Host key verification failed。不盲信新密钥;验证用 ControlPath=none。(verified-on-real-run:64 条记录、补齐后发布成功)
  • survey.sh:Tomcat <Context docBase="*.war"> 指向 appBase 内的 war 且自动部署开着(同一个 war 部署两次)报 MEDIUM;EL7-9 上 /root/.ssh/known_hosts 有没有 ed25519 记录的主机时报 INFO。冒烟测试覆盖 Tomcat 检测。(规则用真实 server.xml 验证;container-smoke)
  • hop.sh post:到 EL10 后 known_hosts 有缺 ed25519 的主机时提醒运行 known-hosts-fill.sh。(untested)
  • pitfalls.md / app-compat.md:EL10 发布机主机密钥校验、Tomcat 同一 war 部署两次(不要挪走 war)、重启后 Jenkins 会话失效、Tomcat 里 Jenkins 的 systemd unit 要点、任务里写死 python3.6(EPEL python3-pandas + 转发)、镜像测速每次都要做。(verified-on-real-run)

Fixed

  • prep-el7.sh pipfix:挪走 pip 文件后跑 yum check dependencies 补装被 --nodeps 删掉的 rpm 依赖,并验证 import requests——真实案例 python-urllib3 缺失导致 leapp 起不来。冒烟测试复现该场景。(问题 verified-on-real-run;脚本修复 container-smoke)

Verified

  • 0.6.2 的 hop.sh post "docker-compose 仍是 v1 且 v2 插件可用"提醒在本次真实升级中按预期出现(verified-on-real-run)。

安装 / Install

/plugin install centos7-almalinux-upgrade --marketplace seaworld008/centos7-lighthouse

完整变更见 CHANGELOG。升级前请先做整机快照,并在非关键机器上先试。

v0.6.2 — 升级次日第一次业务发布暴露的两个问题(报告 4.12)。

Choose a tag to compare

@github-actions github-actions released this 13 Nov 06:20
d1d72d4

升级次日第一次业务发布暴露的两个问题(报告 4.12)。

Added

  • survey.sh:扫描 cron 引用的脚本和 /root|/data|/opt 下 script(s) 目录里的 .sh,发现 tar -czf x dir --exclude=...(选项写在目录后面)报 MEDIUM——EL9+ 的 tar 1.34 会以 2 退出且 exclude 失效。冒烟测试覆盖命中与不误报。(规则基于真实脚本样本;container-smoke)
  • hop.sh post:docker-compose 仍是 v1 而 compose v2 插件已可用时提示补做 finalize.sh compose-wrapper。(untested)
  • pitfalls.md:发布/备份脚本的 tar 选项位置(含 CI 里 ssh 执行的同类命令、分开 ssh 的 cd 不生效、只保留最近 N 份备份);老 docker-compose v1 在 Docker 29 上 client version 1.25 is too old,以及替换前核对 compose 项目名。(verified-on-real-run:8 个 Jenkins 任务与 1 个主机脚本修复后发布成功)

安装 / Install

/plugin install centos7-almalinux-upgrade --marketplace seaworld008/centos7-lighthouse

完整变更见 CHANGELOG。升级前请先做整机快照,并在非关键机器上先试。

v0.6.1 — ### Fixed

Choose a tag to compare

@github-actions github-actions released this 13 Nov 02:17
2d5c14a

Fixed

  • 更正 v0.6.0 对华为云 c9 卡死原因的说法:两台按需 c9 测试机对照实验证明与数据盘无关,把 ata_piix/ata_generic 加入黑名单后仍同样卡死——ata_piix 不是原因(verified-on-real-run)。survey.sh 对 c9 的判断不再依赖 PIIX3 控制器;pitfalls / cloud-providers / SKILL / 报告 4.11 同步更正,c9 结论改为"只升到 AlmaLinux 9,暂无验证过的绕过办法"。

安装 / Install

/plugin install centos7-almalinux-upgrade --marketplace seaworld008/centos7-lighthouse

完整变更见 CHANGELOG。升级前请先做整机快照,并在非关键机器上先试。

v0.6.0 — 华为云三台生产机并行升级的经验(报告:`field-reports/2026-11-12-huawei-php-docker-nfs-frp

Choose a tag to compare

@github-actions github-actions released this 12 Nov 17:21
756b11d

华为云三台生产机并行升级的经验(报告:field-reports/2026-11-12-huawei-php-docker-nfs-frps-x3.md):一台 s3 到 10.2;两台 c9 的 EL10 内核在升级 initramfs 里探测 ata_piix 挂死,换盘改 grubenv 退回 9.8,无数据丢失。

Added

  • scripts/rescue-grubenv.sh:卡在升级 initramfs、抢不到 GRUB 时,在同可用区救援机上把故障机系统盘的默认启动项改回旧内核;可作为 user data 注入,救援机无需登录。recovery.md 新增 F 节完整流程。(verified-on-real-run)
  • survey.sh:华为云从元数据取规格;"c9 + PIIX3 IDE"报 HIGH(建议停在 AlmaLinux 9),其它隐藏 CPU 型号的规格报 INFO。(verified-on-real-run:只读运行于 c9 报 HIGH、s3 不报)
  • hop.sh prep(目标 ≥9):把当前 SSH 来源 IP 写入 PerSourcePenaltyExemptList,避免 OpenSSH 9.9 的 PerSourcePenalties 在 wait-ssh 探测后锁住操作者。(手工方式 verified-on-real-run;脚本化 untested)
  • hop.sh reboot:fstab 的 NFS 被 #osup-nfs# 注释时(非 K8s 主机)mask docker;k8s.sh nfs-on 在 NFS 全部挂上后 unmask 并启动 docker。(手工方式 verified-on-real-run;脚本化 untested)

Fixed

  • finalize.sh compose-wrapper:没有 compose v2 插件时不再替换 docker-compose(EL7 + Docker 19.03 上会把 docker-compose 弄坏);冒烟测试覆盖。

Docs

  • pitfalls.md:c9 上 EL10 ata_piix 挂死;升级后 docker 被重新 enable、容器抢在 NFS 前启动(用 mask);宿主机卸载 NFS 不影响容器内挂载(下载期间不停业务);pam_tally2 只在未引用的 -ac 文件里;OpenSSH 9.9 PerSourcePenalties;下载慢先测速(镜像侧临时限速,代理反而更慢);vector 停机积压后追赶时 OOM 无限重启。
  • cloud-providers.md 华为云:c9 规格识别与建议、敏感操作保护(短信验证码)、VNC 重连与 GRUB、EVS 挂系统盘的坑。
  • SKILL.md:c9 建议只升到 9;工具表加入 rescue-grubenv.sh。

安装 / Install

/plugin install centos7-almalinux-upgrade --marketplace seaworld008/centos7-lighthouse

完整变更见 CHANGELOG。升级前请先做整机快照,并在非关键机器上先试。

v0.5.0 — 升级后运维阶段的经验(升级后第 2~3 天在已升级的机器上发现):宿主机 MySQL 被 OOM 后整个服务停了 10 小时、老备份脚本静默

Choose a tag to compare

@github-actions github-actions released this 11 Nov 06:05
7955f88

升级后运维阶段的经验(升级后第 2~3 天在已升级的机器上发现):宿主机 MySQL 被 OOM 后整个服务停了 10 小时、老备份脚本静默失败了几个月、K8s 节点 IPv6 导致 flannel 丢包。见 2026-11-08 报告 4.12/4.13、2026-11-07 报告 4.13。

Added(verified-on-real-run)

  • ★ scripts/mysql-backup.sh:替换老的 mysqldump cron 脚本。宿主机实例(同大版本客户端)和容器实例(docker exec 容器内 mysqldump)统一配置;一次只备份一个实例;逐库 gzip,校验 -- Dump completed 和管道退出码;导出账号权限;保留天数 + 最少份数;--check;--metrics 给 categraf exec(mysql_backup_ok/age_hours/size_mb)。密码只经 600 临时文件/管道,用 --defaults-file 避开 /etc/my.cnf 里 [mysqldump] 的账号。两台测试机 6 个实例(MySQL 5.7 / 8.0、MariaDB 10.4)实测,含一次恢复校验
  • finalize.sh oom-policy:设了内存上限的 unit 改 MemoryMax=,加 drop-in OOMPolicy=continue(没有 Restart 的补 Restart=on-failure)
  • survey.sh:unit 设了 MemoryLimit/MemoryMax 但没设 OOMPolicy → MEDIUM(EL9+ 默认 OOMPolicy=stop);cron 里调用 mysqldump 的备份脚本 → INFO(提醒核对备份完整性、8.4 不认 MYSQL_PWD)
  • k8s.sh check:flannel.1 有 IPv6 地址时提示(tx_dropped 会慢慢涨、触发丢包告警)
  • 文档:pitfalls.md §7 OOMPolicy、mysqldump 备份静默失败;app-compat.md 宿主机 tarball MySQL(OOMPolicy + jemalloc)、备份脚本要点;kubernetes.md §4 flannel IPv6 丢包;SKILL.md 阶段 4 加两条

Changed

  • tests/container-smoke.sh:覆盖 mysql-backup.sh --metrics/--check/连不上时记 FAIL、finalize.sh oom-policy(含幂等)(container-smoke)

0.4.0 之后已合并、随本版本发布的内容

CI 构建机(阿里云):宿主机 Jenkins + GitLab omnibus 容器 + 共享 nginx 网关,CentOS 7.9 → AlmaLinux 10.2,约 2.3 小时。见 实战报告。

Added(verified-on-real-run)

  • hop.sh:stop_stateful / start_stateful。hop.sh post 在 dnf 事务前也优雅停止有状态容器(docker-ce 被升级时 dockerd 重启,容器只有 10s),结束后启动回来;有状态名单加入 gitlab/gitea/gogs/sonarqube/nexus/jira/confluence/harbor,等待时间 120s → 300s
  • survey.sh:不带版本号的 python shebang 运维脚本 → MEDIUM;第三方 rpm 拥有的可执行文件被手工替换 → MEDIUM;GitLab omnibus 容器没设 stop_grace_period → MEDIUM;Jenkins rpm(war 是否被替换、SHA1 签名)→ INFO
  • app-compat.md:Jenkins / CI 构建机、Node.js 多版本构建工具链、GitLab(omnibus 容器)三节
  • pitfalls.md:GitLab PostgreSQL 残留锁文件(§6)、python shebang 脚本(§7)、jenkins rpm DSA/SHA1(§4)、被替换的 rpm 文件随卸载消失(§2)

Fixed(verified-on-real-run)

  • ★ state.sh:--http1.1 在 EL7(curl 7.29 不支持)上让所有 HTTP 探测变成 000 → 先探测 curl 是否支持
  • backup.sh:打包 /root 时排除 .m2/.npm/.pnpm-store/.gradle/.yarn 等构建缓存(构建机上几十 GB)

两台运行了 861 / 1529 天、很复杂的 PHP + 中间件测试机(阿里云):CentOS 7.6 / 7.9 → AlmaLinux 10.2,约 3.3 小时,期间修了 8 处脚本问题。见 实战报告。

Added(均为 verified-on-real-run)

  • hop.sh prep(目标 ≥9):运行中的非 rpm 程序依赖 libcrypt.so.1(静态重编的 nginx、源码编译的 mysqld 5.7)时,把 libxcrypt-compat 写进 /etc/leapp/transaction/to_install,升级重启后直接能起来
  • hop.sh post(到 EL8 时):删除 EL7 的 SCL 残留(rh-/devtoolset-/llvm-toolset-*),否则 8→9 报 Detected RPMs with RSA/SHA1 signature;有进程在用 /opt/rh 时不删
  • prep-el7.sh inhibitors 第 5 步:宿主机已没有 Remi PHP 时,删除孤立的 Remi 兼容库(libwebp7/libzip5/libicu69…),否则 7→8 在 dnf_package_download 文件冲突(preupgrade 查不出来)
  • nginx-static-build.sh:NGX_OPENSSL / NGX_OPENSSL_SHA256 指定 OpenSSL 版本(原二进制已是 OpenSSL 3.x 时不降回 1.1.1);装 OpenSSL 3 Configure 需要的 perl 模块
  • survey.sh:残留 Remi 兼容库 → MEDIUM;非 rpm 程序依赖 libcrypt.so.1 → INFO;nginx add_header 头名带冒号(HTTP/2 客户端会 PROTOCOL_ERROR)→ INFO
  • survey.sh:主机名含下划线等非法字符 → MEDIUM(EL9 起 systemd 开机会去掉这些字符,用 $hostname 拼 ident 的监控 agent 会换成新目标、旧目标告警失联);pitfalls.md §4 写了处理办法
  • pitfalls.md:第三方源让 yum update 整个失败(MySQL 换签名密钥、ob-deploy 自冲突);长期不重启的机器先在 EL7 重启一次;SHA1 签名第三方包用 rpm -e --justdb 保留文件

Fixed(均为 verified-on-real-run)

  • ★ state.sh:Docker < 20.10 的 docker ps --format 没有 {{.State}},基线里一个容器都没记 → 失败时改用 {{.Status}} 推出状态
  • state.sh:HTTP 探测固定 --http1.1。EL8+ 的 curl 默认走 h2,遇到非法响应头直接 000,与 EL7 基线不可比(误报 9 个站点)

安装 / Install

/plugin install centos7-almalinux-upgrade --marketplace seaworld008/centos7-lighthouse

完整变更见 CHANGELOG。升级前请先做整机快照,并在非关键机器上先试。

v0.4.0 — 第一次 Kubernetes 集群原地升级:阿里云 kubeadm 1.21 测试集群 3 master + 3 worker,CentOS

Choose a tag to compare

@github-actions github-actions released this 07 Nov 00:48
34243a1

第一次 Kubernetes 集群原地升级:阿里云 kubeadm 1.21 测试集群 3 master + 3 worker,CentOS 7 → AlmaLinux 10.2,K8s 版本不变(dockershim + Docker 29 + cgroup v2 实测可用)。见 实战报告。

Added(均为 verified-on-real-run)

  • k8s.sh:backup(etcd 快照、/etc/kubernetes、二进制、pod 列表、资源 YAML;自动 pin)、pin(k8s 源 exclude kubelet/kubeadm/kubectl/cni/cri-tools,防止 dnf upgrade 升 minor)、stop(停 kubelet 后按 业务→控制面→etcd 顺序停容器;hop.sh reboot 遇到 kubelet 自动调用)、nfs-off/nfs-on(leapp 的 NFS 阻断项)、nm(NM 不接管 cni0/flannel/veth 等)、fix(modules-load.d、sysctl、删 Dead 容器、cgroup 驱动一致性)、check、pods(与升级前按 namespace 对比)、jvm-maxram(cgroup v2 下老 JDK 认不出内存限制 → 注入 JAVA_TOOL_OPTIONS=-XX:MaxRAM=$(limits.memory))
  • references/kubernetes.md:开工前要弄清的事、兼容性结论、推荐顺序、踩坑表、恢复检查清单
  • finalize.sh:iptables-legacy(容器内 legacy iptables,如 wg-easy)、redis-valkey、manual-procs(升级前手工启动的进程 → systemd 服务);postfix-lmdb 在禁用 IPv6 时改 inet_protocols=ipv4
  • backup.sh:记录从 SSH 会话手工启动、正在监听端口的进程(cmdline/cwd/exe/环境变量)
  • survey.sh:fstab bind 到 /sys|/proc|/dev|/run → BLOCKER;rpm 重复包 → HIGH;手工启动的服务进程 → HIGH;K8s 节点 BLOCKER 改为指向 kubernetes.md,并提示 cgroup v2 老 JDK
  • recovery.md B2:升级环境里很早进 emergency、VNC 敲不了命令(shell 在 ttyS0);看串口日志;用 noVNC JS 抓 1 秒的 GRUB 菜单回旧内核

Fixed(均为 verified-on-real-run)

  • ★ hop.sh up:leapp 把 fstab 固化进升级 initramfs,bind 到 /sys 的条目(阿里云 set_ecs_special.sh)会让升级环境进 emergency → leapp upgrade 前自动注释(#osup-bind#),EL10 的 post 恢复
  • hop.sh answer:ifcfg-*.bak/.orig/.old/~ 备份副本会让 8→9 一直报 unsupported device types → migrate 前挪走
  • prep-el7.sh update:排除 kube*、cri-tools
  • prep-el7.sh inhibitors:保留"最新已安装内核"的 kernel-devel(而不是运行中的),避免 update 后出现两个
  • state.sh:不把 kubelet 管理的 k8s_ 容器、127.0.0.1 上的临时端口(如 dockershim 随机端口)记进基线
  • verify.sh:先判断 unit 是否还存在。已卸载的 unit 也会返回 ConditionResult=no,以前会被误报为"条件不满足、预期跳过",现在报 WARN,交给人判断(verified-on-real-run)
  • hop.sh:改写镜像时的 .orig 备份放到工具目录,不再留在 /etc/yum.repos.d

安装 / Install

/plugin install centos7-almalinux-upgrade --marketplace seaworld008/centos7-lighthouse

完整变更见 CHANGELOG。升级前请先做整机快照,并在非关键机器上先试。

v0.3.1 — 第二台全程用脚本完成的 CentOS 7(阿里云测试应用机,7.9 → AlmaLinux 10.2,约 1.9 小时)。见 实战报告。

Choose a tag to compare

@github-actions github-actions released this 06 Nov 09:50
2a692b1

第二台全程用脚本完成的 CentOS 7(阿里云测试应用机,7.9 → AlmaLinux 10.2,约 1.9 小时)。见 实战报告。

Fixed(均为 verified-on-real-run)

  • prep-el7.sh repos:不可达的第三方源(如 netbird)会让 yum repolist 卡 20 分钟 → 改为逐个用 curl 探测,不通就禁用;挪走所有 CentOS-*.repo;repolist 加超时(实测 33 秒)
  • prep-el7.sh inhibitors:先删旧内核,再重建 initramfs
  • hop.sh post:自动禁用并挪走源码安装的 cloud-init unit(阿里云老镜像,三台机器都遇到)
  • Release 工作流:标题里的 markdown 链接只保留文字

Verified

  • 上一版新增的 7→8 驱动卸载、EL7 内核 --noscripts 删除、9→10 的 dhclient/ifcfg 自动处理,在第二台机器上全部无需人工干预

安装 / Install

/plugin install centos7-almalinux-upgrade --marketplace seaworld008/centos7-lighthouse

完整变更见 CHANGELOG。升级前请先做整机快照,并在非关键机器上先试。

v0.3.0 — 第一台全程用脚本完成的 CentOS 7(阿里云多业务机,7.6 → AlmaLinux 10.2;Closes #5)。见 [实战报告](https://gi

Choose a tag to compare

@github-actions github-actions released this 06 Nov 07:48
14da882

第一台全程用脚本完成的 CentOS 7(阿里云多业务机,7.6 → AlmaLinux 10.2;Closes #5)。见 实战报告。

Added

  • prep-el7.sh netmgr:network.service → NetworkManager,失败自动回滚(verified-on-real-run)
  • hop.sh answer:7→8 时卸载 floppy/pata_acpi;8→9 时遇到 ifcfg "unsupported device types" 用 nmcli connection migrate 处理;9→10 时处理 dhcp=dhclient(/etc 里的注释掉,/usr/lib 下不属于任何包的残留文件挪走)(verified-on-real-run)
  • hop.sh reboot --no-stop:业务方要求某些容器不能动时,不提前停止任何容器
  • survey.sh:/usr/lib 下的 dhcp=dhclient 报 HIGH;ifcfg 缺 TYPE= 报 MEDIUM;启用了 iptables.service 报 INFO
  • 文档:Harbor 开机 syslog 日志驱动竞争(autostart unit)、ssmtp 被删、LNMP 日志目录 777 导致 logrotate 跳过

Fixed(均为 verified-on-real-run)

  • hop.sh post:EL7 内核的 %preun 调用 new-kernel-pkg(exit 127)导致删不掉 → rpm -e --noscripts 后清理 /boot、/lib/modules 和启动项
  • prep-el7.sh inhibitors:黑名单文件里混进了 "rmmod" 行;写黑名单后重建 initramfs,避免重启后模块再次被加载
  • nginx-static-build.sh:--with-openssl-opt 被截断;老版本签名公钥改从 keyserver 获取;sha256 不符时删除文件并提示手动上传;--install 参数被 set -- 覆盖;用 mv 替换运行中的二进制
  • hop.sh prep:同名第三方包已安装(leapp 装的 docker-ce 没有签名)也算作在用的厂商源

安装 / Install

/plugin install centos7-almalinux-upgrade --marketplace seaworld008/centos7-lighthouse

完整变更见 CHANGELOG。升级前请先做整机快照,并在非关键机器上先试。

v0.2.0 — 第一次全程使用技能脚本的真实执行(阿里云,CentOS 8.3 → AlmaLinux 10.2),新增 CentOS 8 源路径和批量工具。

Choose a tag to compare

@github-actions github-actions released this 06 Nov 04:44
e66edf1

第一次全程使用技能脚本的真实执行(阿里云,CentOS 8.3 → AlmaLinux 10.2),新增 CentOS 8 源路径和批量工具。

Added

  • convert-el8.sh:源系统为 CentOS Linux 8 / Stream 8 时,先用官方 almalinux-deploy 转成 AlmaLinux 8,再走 8→9→10。子命令为 prep / update / run / post(verified-on-real-run,阿里云)
  • survey.sh:CentOS 8 源系统报 BLOCKER;epel.repo 版本与系统不一致报 HIGH;nginx 跑在容器里时不再误报"文件不存在"
  • state.sh:能读出容器里 nginx/openresty/tengine 的 server_name;老版本 nginx 没有 -T 时直接读配置文件;所有 TCP 端口按 IP 探测,443 用 https
  • verify.sh:新版本 unit 因启动条件不满足而跳过(如 sssd 无配置)时视为预期
  • hop.sh answer:8→9 自动处理 firewalld AllowZoneDrifting 阻断项(只改配置,不 reload)
  • hop.sh prep:按 .sigs 签名 key 判断本机在用的厂商源,只探测这些(docker-ce 的 PES 是空的)
  • hop.sh answer:9→10 自动执行 nmcli connection migrate,并对比迁移前后的地址和默认路由
  • hop.sh post:先等 leapp FirstBoot(leapp_resume.service)结束再清理;禁用只有 metalink 的 epel-cisco-openh264
  • verify.sh:dbus → dbus-broker 映射;30 秒内 RestartCount 仍在增长的容器判为 FAIL(crash-loop 检测)
  • bgrun(hop.sh / convert-el8.sh / prep-el7.sh)把后台命令的退出码传出来;convert-el8.sh update 失败或升级后仍低于 8.4 时停止
  • hop.sh post:镜像改写覆盖所有 epel*.repo(含 EL8 的 epel-modular,并设 skip_if_unavailable=1),只排除 cisco-openh264
  • 实战报告:阿里云堡垒机 CentOS 8.3 → AlmaLinux 10.2

Fixed

  • hop.sh pre 末尾调用 "$0" report 时,因为 SFTP 上传的文件没有执行权限而报 Permission denied → 改为 bash "$0"(verified-on-real-run)
  • convert-el8.sh 自建的 vault 源与 AlmaLinux 的 repo id 冲突,导致 distro-sync 实际同步回 CentOS → 改用 c8vault-* 并在转换前移走(verified-on-real-run)
  • hop.sh post 与 leapp_resume 竞争,导致 FirstBoot 中断(verified-on-real-run:9→10 时已正确等待)
  • hop.sh report 在 EL7(py2)和 EL8(py3.6)的 LC_ALL=C 环境下输出中文时崩溃(由 CI 冒烟测试发现)

Added (tooling)

  • Release 工作流:main 上版本号变化后,自动从 CHANGELOG 生成 Release(tools/changelog_section.py)
  • fleet_summary.py:汇总多台机器的 survey 结果 → A/B/C/D 分类、VPN/EL8 标记、金丝雀与分批建议(--groups 让同业务主备不同批)(#6;单元测试 + 真实数据)
  • CI:单元测试;centos:7 容器中真实执行 prep-el7.sh repos/pipfix/inhibitors 与 swap-openssh.sh 的检测路径(会修改系统的测试只在容器里运行)
  • swap-openssh.sh:没装 openssh-server 时直接退出
  • .github/release.yml 按标签生成发布说明分类;CODEOWNERS;main 分支保护(必须通过 CI)

Changed

  • ci: actions/checkout v7、setup-python v7、setup-node v7、gitleaks-action v3(Node 24 运行时)

安装 / Install

/plugin install centos7-almalinux-upgrade --marketplace seaworld008/centos7-lighthouse

完整变更见 CHANGELOG。升级前请先做整机快照,并在非关键机器上先试。