Rocky Linux 10 강좌 / Rocky Linux 9에서 10으로 이관하기
Rocky Linux 9에서 10으로 옮길 때는 새 Rocky Linux 10 서버를 설치하고 필요한 설정과 자료를 이관하는 방식으로 준비합니다. Rocky Linux 프로젝트는 서로 다른 주 버전 사이의 제자리 업그레이드를 공식 지원하지 않습니다. 기존 서버를 남겨 둔 채 새 환경을 검증하면 전환 전 문제를 찾고 되돌릴 조건을 정하기 쉽습니다.
9→10 이관과 같은 버전 업데이트의 차이
9.x 안에서 최신 마이너 버전으로 업데이트하는 것과 9에서 10으로 주 버전을 바꾸는 것은 다른 작업입니다. Rocky Linux의 공식 버전 이관 문서는 새 설치, 필요한 계정·저장소·패키지 준비, 백업 복원의 흐름을 안내합니다. 저장소 주소의 숫자만 바꾸거나 dnf --releasever=10을 일반적인 공식 이관 방법으로 사용하지 않습니다.
새 서버를 준비하는 목적은 기존 시스템을 통째로 복제하는 데 있지 않습니다. 새 운영체제의 기본 설정과 보안 정책 위에 서비스가 실제로 요구하는 자료·설정을 맞추는 작업입니다. 이전 서버의 커널, 라이브러리와 RPM을 새 서버에 그대로 옮기면 의존성과 지원 범위가 맞지 않을 수 있습니다.
| 이관 대상 | 새 서버에서 할 일 | 검증 기준 |
|---|---|---|
| 사용자·서비스 계정 | 필요한 계정을 만들고 UID·GID 대응을 정합니다. | 이관 자료를 의도한 계정이 읽고 쓸 수 있어야 합니다. |
| 패키지와 실행 환경 | Rocky 10용 저장소에서 필요한 버전을 설치합니다. | 프로그램과 확장 모듈이 새 런타임에서 동작해야 합니다. |
| 설정 | 새 기본 파일을 기준으로 필요한 변경을 재적용합니다. | 설정 검사와 서비스 시작이 성공해야 합니다. |
| 파일·DB 자료 | 일관된 백업을 별도 경로에 복원합니다. | 내용·권한과 업무 기능을 함께 확인합니다. |
| 접속 대상·예약 작업 | 전환 순서와 중복 실행 방지 방법을 정합니다. | 사용자 요청이 의도한 서버로 가고 작업이 한 번만 처리되어야 합니다. |
한 대의 장비를 재설치해야 한다면 기존 서버를 동시에 유지할 수 없으므로 복원 시험을 끝낸 외부 백업과 재설치 전으로 돌아갈 수단이 더욱 중요합니다. 가능하면 새 VM이나 별도 서버로 먼저 연습하고 실제 전환의 중단 시간과 실패 기준을 정합니다.
기존 서버에서 필요한 구성 목록 확보하기
기존 Rocky 9 서버에서는 설치 상태와 서비스 의존성을 먼저 조사합니다. 다음은 관리자 셸에서 새 조사 디렉터리를 만드는 예입니다. 계정 목록과 네트워크 구성은 운영 정보를 포함할 수 있으므로 접근을 제한하고 공개 로그나 게시물에 그대로 붙이지 않습니다.
sudo -i
set -eu
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의 모듈 명령으로 그대로 옮긴다고 가정하지 않습니다.
웹·DB 서비스라면 자료 경로 외에도 DB 계정과 덤프 방식, 업로드 파일, 외부 API·메일·스토리지, 인증서, 예약 작업과 백업 작업을 확인합니다. 새 서버와 기존 서버에서 같은 예약 작업을 동시에 돌리면 메일 발송이나 자료 처리가 중복될 수 있습니다. 운영 비밀번호·비밀키는 별도의 보호된 절차로 전달하고 설정 비교용 파일에 불필요하게 복사하지 않습니다.
새 서버 준비와 실습 범위
새 서버에는 Rocky Linux 10을 새로 설치하고 업데이트, 관리 계정, SSH 접근, 방화벽·SELinux 기본 상태를 먼저 확인합니다. x86-64 환경이라면 Rocky 10의 CPU 요구 조건도 확인해야 합니다. 기존 서버가 Rocky 9를 실행한다는 이유만으로 새 버전의 요구 조건까지 충족한다고 판단하지 않습니다.
실제 프로그램을 옮길 때는 Python 가상 환경이나 컴파일된 확장 모듈을 디렉터리째 복사하기보다 새 서버에서 지원하는 런타임과 의존성으로 다시 만듭니다. DB 파일 형식과 플러그인 호환성은 해당 제품의 버전별 이관 절차를 따릅니다. /etc, /usr, /var 전체를 새 서버 위에 덮어쓰는 방식으로 기본 설정과 시스템 파일을 섞지 않습니다.
아래 실습은 Rocky 9.8 컨테이너 사용자 공간의 작은 읽기 전용 서비스를 Rocky 10.2 VM의 Python으로 옮기는 예입니다. 출발지 Python은 3.9.25, 도착지는 3.12.15였습니다. 컨테이너는 Rocky 10 VM의 커널을 공유하므로 Rocky 9 커널·부팅·systemd 전체를 이전한 시험은 아닙니다. 실제 DB나 공인 DNS를 바꾸지 않고 별도 파일의 접속 주소로 전환과 롤백을 검증합니다.
실습은 lfstudent 일반 계정으로 진행하며 Podman·Python·tar·curl이 필요합니다. 실습 VM의 UID·GID는 모두 1000입니다. Rocky Linux Podman 문서에 나오는 공식 docker.io/library/rockylinux 이미지를 기반으로 별도 이미지를 만듭니다. 실제 운영 서비스는 컨테이너 수명과 로그아웃 영향까지 별도로 관리해야 하며, 여기서는 시작부터 종료까지 같은 로그인 세션에서 실습합니다.
출발지 Rocky 9 사용자 공간 준비하기
기존 서버에서 아래 명령을 실행하는 것이 아니라 전용 Rocky 10 실습 VM의 일반 사용자 셸에서 실행합니다. 새 경로와 별도 로컬 이미지 이름을 사용합니다. 기존 실습 자료가 있으면 멈추고 저장 상태를 먼저 확인합니다.
set -eu
umask 077
test ! -e "$HOME/lf-course31"
mkdir -m 700 "$HOME/lf-course31"
cd "$HOME/lf-course31"
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 등 쓰기 기능은 제공하지 않으며 원본 디렉터리도 읽기 전용으로 연결합니다. 실제 쓰기 서비스에서는 이 부분을 유지보수 모드와 최종 일관된 백업 절차로 바꿔야 합니다.
test -z "$(ss -H -lnt 'sport = :18031')"
test -z "$(ss -H -lnt 'sport = :18032')"
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)
except (OSError, ValueError, KeyError):
body = b'Cannot read migration data\n'
self.send_response(500)
self.send_header('Content-Type', 'application/json')
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를 먼저 맞추거나 필요한 소유권 변환을 계획해야 합니다.
test -z "$(find target -mindepth 1 -print -quit)"
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 문법·실행 계정 권한을 확인합니다. 이 작은 서버는 루프백에서 기능을 확인하는 실습용이며 외부 운영용 웹 서버로 사용하지 않습니다.
작은 예제에서 성공했다고 실제 서비스의 모든 의존성이 호환된다는 뜻은 아닙니다. 운영 환경에서는 로그인, 조회·쓰기, 파일 업로드, DB 문자 집합·시간대, 예약 작업, 외부 연동, 인증서와 백업 작업을 서비스별로 확인합니다. 가능하면 새 서버의 재부팅 뒤에도 같은 결과인지 검증하고, 사용자가 정상 접속하는 주소와 경로에서도 검사합니다.
접속 대상 전환과 롤백을 같은 자료로 시험하기
이 실습의 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를 확인했고 각 자료 응답은 같았습니다. 원본을 읽기 전용으로 고정했고 새 환경에도 쓰기 기능이 없으므로 이 예제에서는 자료를 다시 합칠 필요 없이 접속 대상만 되돌릴 수 있었습니다.
실제 쓰기 서비스에서는 전환 뒤 새 서버에 들어온 자료가 핵심입니다. 이를 기존 서버에 반영하지 않은 채 주소만 되돌리면 새로운 주문·업로드·계정 변경 등을 잃을 수 있습니다. 이관 전에 쓰기 중단 시간, 최종 동기화 시점, 새 서버에서 쓰기를 허용할 조건, 롤백 시 자료를 되가져올 방법을 정합니다. 서로 다른 DB 버전에서 역방향 복원이 가능한지도 확인해야 합니다.
운영 전환은 선택한 방식에 따라 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 문맥 복원은 컨테이너가 사용을 끝낸 이 실습 원본 경로에만 적용하며 자료 내용과 기본 권한은 유지합니다.
실제 기존 서버는 새 서버의 업무 기능·운영 접근·백업과 복원·예약 작업 검증을 마치고, 정한 관찰 기간과 롤백 조건을 충족한 뒤 종료합니다. 종료 전에 마지막 백업의 위치와 복원 방법, 새 서버의 구성 차이, 아직 확인하지 못한 항목을 인계합니다. 서버를 새로 설치한 날짜보다 서비스와 자료를 검증한 결과가 이관 완료 판단의 근거가 되어야 합니다.




