Rocky Linux 10 教程 / 从Rocky Linux 9迁移到10并验证切换与回滚
在从 Rocky Linux 9 升级到 10 时,您需要准备安装一个新的 Rocky Linux 10 服务器,并迁移必要的配置和数据。Rocky Linux 项目不官方支持不同主要版本之间的原地升级。通过在保留现有服务器的情况下验证新环境,更容易在切换之前发现问题并定义回滚条件。
区分9.x小版本更新与Rocky 9到10迁移
在 9.x 系列中更新到最新的小版本,以及将主版本从 9 更改为 10 是不同的任务。 官方的 Rocky Linux 版本迁移文档 指导通过全新安装流程,准备必要的账户、软件仓库、软件包,并恢复备份。仅仅更改仓库地址中的版本数字或使用 dnf --releasever=10 并不被视为标准的官方迁移方法。
准备新服务器的目的不是完全复制现有系统。而是在新操作系统的默认设置和安全策略基础上,适配服务所需的数据和设置。简单地将旧服务器的内核、库和RPM移动到新服务器上,可能会导致依赖关系不匹配和支持范围问题。
| 迁移目标 | 新服务器上的任务 | 验证标准 |
|---|---|---|
| 用户和服务账户 | 创建必要的账户并定义相应的UID和GID。 | 预期账户必须能够读取和写入迁移的数据。 |
| 软件包和运行环境 | 从 Rocky 10 仓库安装所需版本。 | 程序和扩展模块必须在新的运行时环境下工作。 |
| 配置 | 根据新的默认文件重新应用必要的更改。 | 配置检查和服务启动必须成功。 |
| 文件·数据库数据 | 将一致的备份恢复到单独的路径。 | 一起检查内容、权限和业务功能。 |
| 访问目标·计划任务 | 确定转换顺序和方法以防止重复执行。 | 用户请求应发送到预期的服务器,任务只应处理一次。 |
如果单个设备需要重新安装,则无法同时维护现有服务器,因此更重要的是拥有已完成恢复测试的外部备份以及重新安装前的恢复手段。如果可能,先在新的虚拟机或独立服务器上进行演练,并确定实际转换的停机时间和失败标准。
从现有服务器获取所需的配置列表
在现有的 Rocky 9 服务器上,首先调查安装状态和服务依赖关系。以下是从管理员 shell 创建新调查目录的示例。账户列表和网络配置可能包含操作信息,因此应限制访问,且不应直接复制到公共日志或帖子中。
sudo -i
set -euo pipefail
umask 077
test ! -e /root/migration-inventory
mkdir /root/migration-inventory
cd /root/migration-inventory
cat /etc/rocky-release > release.txt
getent passwd > users.txt
getent group > groups.txt
rpm -qa --qf '%{NAME}-%{VERSION}-%{RELEASE}.%{ARCH}\n' | sort > packages.txt
dnf repolist --enabled > repositories.txt
dnf module list --enabled > modules.txt
systemctl list-unit-files --state=enabled > enabled-units.txt
ss -lntup > listening-ports.txt
ip -br address > addresses.txt
ip route > routes.txt
exit
此列表不是可以直接在新服务器上执行的安装脚本。它仅作为参考,用于选择服务所需的项目,并检查 Rocky 10 中的名称、支持可用性以及替代软件包。对于在 Rocky 9 上使用模块流的服务,特别有必要调查执行版本,而不能假设可以直接将选择转移到 Rocky 10 中的模块命令。
对于Web和数据库服务,除了检查数据路径外,还要检查数据库账户和转储方法、上传的文件、外部API、邮件、存储、证书、计划任务和备份任务。在新服务器和现有服务器上同时运行相同的计划任务可能会导致邮件发送或数据处理重复。操作密码和密钥应通过独立的受保护流程传递,不应为配置比较不必要地复制到文件中。
新服务器的准备和适用范围
在新服务器上安装 Rocky Linux 10,执行更新,设置管理账户,检查 SSH 访问,并首先验证防火墙和 SELinux 的基本设置。如果是 x86-64 环境,还要检查 Rocky 10 的 CPU 要求。不要因为现有服务器运行的是 Rocky 9 就假设新版本的要求已经满足。
在传输实际程序时,不要按原样复制 Python 虚拟环境或已编译的扩展模块目录,而是使用新服务器支持的运行时和依赖在新服务器上重新创建它。对于数据库文件格式和插件兼容性,请遵循每个产品版本的迁移流程。不要通过完全覆盖 /etc、/usr 和 /var 在新服务器上混合默认设置和系统文件。
原实验将一个小型只读服务从 Rocky 9.8 容器用户空间迁移到 Rocky 10.2 虚拟机上的 Python 。源 Python 版本是 3.9.25,目标 Python 版本是 3.12.15。两个环境共享 Rocky 10 主机内核,因此测试没有迁移 Rocky 9 内核、引导过程或 systemd。一个本地地址文件模拟了切换和回滚,而没有更改生产数据库或公共 DNS。
以普通用户 lfstudent 身份运行练习,并且需要 Podman、Python、tar 和 curl。原练习账户lfstudent的UID和GID均为1000;这并不表示虚拟机上所有用户的ID都是1000。从官方 docker.io/library/rockylinux 镜像构建一个独立的镜像,如 Rocky Linux Podman 指南 所述。实际生产服务必须单独管理容器生命周期和注销的影响;在这里,练习是在同一登录会话中从开始到完成进行的。
构建Rocky 9容器用户空间
在专用的 Rocky 10 练习虚拟机的 shell 中以普通用户身份执行命令,而不是在现有服务器上。使用新的路径和单独的本地镜像名称。如果你已有现有练习材料,请先停止并检查保存状态。
set -euo pipefail
umask 077
test ! -e "$HOME/lf-course31"
mkdir -m 700 "$HOME/lf-course31"
cd "$HOME/lf-course31"
if podman image exists localhost/lf-course31-source9-updated:20261112; then
printf 'The local lab image tag already exists. Stop and inspect it.\n' >&2
exit 1
else
image_status=$?
test "$image_status" -eq 1
fi
podman pull docker.io/library/rockylinux:9
base=$(podman image inspect docker.io/library/rockylinux:9 \
--format '{{index .RepoDigests 0}}')
printf '%s\n' "$base" > base.ref
printf 'FROM %s\nRUN dnf -y upgrade && dnf -y install python3 tar && dnf clean all\n' \
"$base" > Containerfile
podman build --tag localhost/lf-course31-source9-updated:20261112 \
--file Containerfile .
podman run --rm localhost/lf-course31-source9-updated:20261112 \
/bin/bash -lc 'cat /etc/rocky-release; python3 --version; uname -r'
不要仅仅通过标签来假定实际版本。在实际操作中收到的基于 :9 的镜像标注为 9.3,在镜像内进行了完整的 9 系列更新后,实验室确认版本为 9.8 和 Python 3.9.25。此更新仅在隔离镜像中完成。记录基础镜像的摘要在 base.ref 中,注意相同的标签以后可能指向不同的镜像。
在容器内部,uname -r 显示主机 Rocky 10 的内核。使用 /etc/rocky-release 或 /etc/os-release 确认操作系统用户空间版本,并与内核版本区分开。准备镜像或首次用户映射可能需要时间,因此不要重复创建相同名称的容器。如果操作被中断,首先使用 podman ps -a 和 podman inspect 检查实际状态。
创建只读的原始服务和迁移备份
以下是一个完整的练习程序,读取一个配置文件和一个包含两条记录的JSON数据文件。/health 表示执行环境,/items 返回要传输的数据。不提供 POST 等写入函数,原始目录也以只读方式连接。在实际的写入服务中,这部分应更改为维护模式,并执行最终的一致性备份程序。
SOURCE_LISTENERS=$(ss -H -lnt 'sport = :18031')
TARGET_LISTENERS=$(ss -H -lnt 'sport = :18032')
test -z "$SOURCE_LISTENERS"
test -z "$TARGET_LISTENERS"
mkdir -m 700 source target
mkdir -m 700 source/data
printf '{"site":"LF31 migration lab"}\n' > source/config.json
printf '[{"id":1,"name":"alpha"},{"id":2,"name":"beta"}]\n' > source/data/items.json
cat > source/app.py <<'PY'
import json, platform, sys
from pathlib import Path
from http.server import BaseHTTPRequestHandler, HTTPServer
root = Path(sys.argv[1])
class Handler(BaseHTTPRequestHandler):
def do_GET(self):
try:
if self.path == '/health':
release = dict(line.split('=', 1) for line in
Path('/etc/os-release').read_text().splitlines() if '=' in line)
data = {'os': release['VERSION_ID'].strip('"'),
'python': platform.python_version()}
elif self.path == '/items':
config = json.loads((root/'config.json').read_text())
data = {'site': config['site'],
'items': json.loads((root/'data/items.json').read_text())}
else:
self.send_error(404)
return
body = (json.dumps(data, sort_keys=True) + '\n').encode()
self.send_response(200)
content_type = 'application/json'
except (OSError, ValueError, KeyError):
body = b'Cannot read migration data\n'
self.send_response(500)
content_type = 'text/plain; charset=utf-8'
self.send_header('Content-Type', content_type)
self.end_headers()
self.wfile.write(body)
HTTPServer((sys.argv[2], int(sys.argv[3])), Handler).serve_forever()
PY
chmod 640 source/app.py source/config.json source/data/items.json
uid=$(id -u)
gid=$(id -g)
source_id=$(podman run -d --init --name lf-course31-source --label lf.course=31 \
--userns=keep-id --user "$uid:$gid" \
-p 127.0.0.1:18031:8080 -v "$PWD/source:/work:ro,Z" \
localhost/lf-course31-source9-updated:20261112 \
python3 /work/app.py /work 0.0.0.0 8080)
printf '%s\n' "$source_id" > source-container.id
sleep 2
podman exec "$source_id" id
curl --fail --silent --max-time 10 http://127.0.0.1:18031/health
curl --fail --silent --max-time 10 http://127.0.0.1:18031/items > source-response.json
--userns=keep-id 允许即使在容器内,普通用户的数字 ID 也能保持不变。:ro,Z 以只读模式连接原始数据,并应用专用的 SELinux 标签。该标签更改不会广泛应用于公共数据目录。如果初始响应失败,podman inspect "$source_id" 和 podman logs "$source_id" 会被检查,并在恢复之前验证记录的容器 ID。该过程在未检查运行中的原始数据前不会进入下一步。
如果确认响应和原始数据正常,会在容器内创建一个相对路径备份,并复制到主机。备份仅包含该小程序、设置和数据。
podman exec "$source_id" tar --numeric-owner -cpf /tmp/lf31-migration.tar -C /work .
podman cp "$source_id":/tmp/lf31-migration.tar backup.tar
sha256sum backup.tar > backup.tar.sha256
sha256sum -c backup.tar.sha256
tar --numeric-owner -tvf backup.tar
校验和应为 OK,文件列表应显示 app.py、config.json 和 data/items.json。本例中的标准 tar 备份针对文件内容和基本权限。如果您想保留 ACL 和扩展属性,应针对这些选项和属性添加检查,就像备份和实际恢复验证 设置及用户数据 的教程一样。特别是,专用于容器的 SELinux 标签不应直接用于新服务器的部署策略。
在 Rocky 10 上恢复并比较执行结果
在再次确认准备好的 target 为空后,只恢复你自己创建的备份。由于恢复是在同一个主机上的相同普通账户下进行的,本例中的数字所有权映射是相同的。如果是不同的实际服务器,你需要先对新账户的 UID 和 GID 进行对齐,或规划必要的所有权转换。
TARGET_ENTRIES=$(find target -mindepth 1 -print -quit)
test -z "$TARGET_ENTRIES"
sha256sum -c backup.tar.sha256
tar -xpf backup.tar -C target
python3 - <<'PY'
from pathlib import Path
import hashlib, stat
source, target = Path('source'), Path('target')
for p in sorted(source.rglob('*')):
if not p.is_file():
continue
q = target/p.relative_to(source)
if p.read_bytes() != q.read_bytes():
raise SystemExit('FAIL: content differs')
if (p.stat().st_uid != q.stat().st_uid or
p.stat().st_gid != q.stat().st_gid or
stat.S_IMODE(p.stat().st_mode) != stat.S_IMODE(q.stat().st_mode)):
raise SystemExit('FAIL: owner or mode differs')
print(p.relative_to(source), hashlib.sha256(q.read_bytes()).hexdigest())
print('PASS: file content, numeric ownership and modes match')
PY
python3 target/app.py "$PWD/target" 127.0.0.1 18032 > target-service.log 2>&1 &
target_pid=$!
sleep 1
curl --fail --silent --max-time 10 http://127.0.0.1:18032/health
curl --fail --silent --max-time 10 http://127.0.0.1:18032/items > target-response.json
cmp source-response.json target-response.json
如果三个文件的内容和权限相同,并且 cmp 以状态 0 退出且没有输出,那么本例中的数据响应是一致的。在目标 /health 上,新用户空间和运行时版本显示如下。
{"os": "10.2", "python": "3.12.15"}
/items 响应应包括 alpha 和 beta,并且具有相同的 site 值。如果响应为 500,请检查 target-service.log、文件路径、JSON 语法和执行账户权限。这个小型服务器用于练习,以验证回环功能,并不用于外部生产 Web 服务器。
在一个小示例中成功并不意味着实际服务的所有依赖项都是兼容的。在生产环境中,必须针对每个服务检查登录、查看/写入操作、文件上传、数据库字符集和时区、计划任务、外部集成、证书以及备份操作。如果可能,即使在重新启动新服务器后,也要验证是否得到相同的结果,并检查用户通常连接的地址和路径。
测试使用相同数据切换连接目标并回滚
在此练习中,client.url 是一个标准文件,用于存储发送请求的地址。在不更改公共 DNS 或实际用户流量的情况下,你可以观察现有环境→新环境→现有环境→新环境的顺序。
printf 'http://127.0.0.1:18031\n' > client.url
curl --fail --silent --max-time 10 "$(cat client.url)/health"
printf 'http://127.0.0.1:18032\n' > client.url
curl --fail --silent --max-time 10 "$(cat client.url)/health"
curl --fail --silent --max-time 10 "$(cat client.url)/items" | cmp - source-response.json
printf 'http://127.0.0.1:18031\n' > client.url
curl --fail --silent --max-time 10 "$(cat client.url)/health"
curl --fail --silent --max-time 10 "$(cat client.url)/items" | cmp - source-response.json
printf 'http://127.0.0.1:18032\n' > client.url
curl --fail --silent --max-time 10 "$(cat client.url)/items" | cmp - source-response.json
原实验验证了源 9.8/3.9.25,目标10.2/3.12.15,然后再次验证源 9.8/3.9.25,各阶段的数据响应均保持相同。由于原始环境被固定为只读且新环境没有写功能,在此示例中,比较只能恢复连接目标,而无需再次合并数据。
在实际的写入服务中,迁移后进入新服务器的数据至关重要。如果你只是恢复地址而不在现有服务器上反映这一点,可能会丢失新的订单、上传、账户变更等。在迁移之前,设置写入暂停时间、最终同步点、新服务器允许写入的条件,以及回滚时的数据恢复方法。同时,验证不同数据库版本之间是否可以进行反向恢复。
生产切换应按选定方案调整 DNS、代理/负载均衡器或连接设置。由于 DNS 缓存和现有连接,并非所有用户会同时迁移到新服务器。过渡后,观察错误率、日志和关键业务检查,并且不要在现有服务器上重复恢复写操作或计划任务。
清理实验室并决定何时退役旧服务器
仅终止在实践中启动的两个进程。下面的 target_pid 和 source_id 是在当前会话中直接启动的目标。如果会话已断开,请检查保存的容器 ID 以及实际进程/端口,以确认是相同的目标后再进行清理,不要终止任何其他任意的 Python 进程。
kill "$target_pid"
wait "$target_pid" || test "$?" = 143
podman stop "$source_id"
podman inspect "$source_id" --format '{{.State.Status}} {{.State.ExitCode}}'
podman rm "$source_id"
ss -lnt 'sport = :18031'
ss -lnt 'sport = :18032'
sudo restorecon -RF "$HOME/lf-course31/source"
sha256sum -c backup.tar.sha256
--init 在容器中放置了一个小的初始进程,该进程负责信号传输等任务。在对其应用的单独终止检查中,exited 143 出现时没有强制终止警告,在本练习中,根据 SIGTERM 它处于终止状态。它还检查两个端口是否都已关闭,以及备份校验和是否为 OK。SELinux 上下文恢复仅适用于容器已完成使用的本练习的原始路径,同时保留内容和默认权限。
在新服务器完成业务功能、操作访问、备份与恢复以及计划任务的验证,并且满足既定的观察期和回滚条件后,再考虑关闭原有服务器。关闭前,需要移交最后一次备份的存放位置和恢复方法、新服务器的配置差异以及尚未验证的项目。应通过已验证的服务行为和数据完整性来判断迁移是否完成,而不是通过新服务器安装的日期判断。




