Debian 13 강좌 / Debian 12 업그레이드 사전 점검과 복구 준비
Debian 12에서 Debian 13으로 업그레이드하기 전에는 현재 시스템을 정상화하고, 복원 가능한 백업과 SSH가 끊겨도 접근할 콘솔을 준비해야 합니다. 패키지 목록만 저장하거나 VM 스냅샷만 만드는 것으로 준비를 끝내지 말고, 서비스 데이터 복원과 재부팅 후 접속까지 확인하세요.
업그레이드할 시스템과 중단 기준 정하기
이 글은 amd64 Debian 12 최소 서버의 준비 단계입니다. 저장소를 trixie로 바꾸거나 Debian 13 패키지를 설치하지 않습니다. Debian 11 등 더 오래된 버전은 먼저 Debian 12로 올리는 별도 작업이 필요합니다. i386 서버는 같은 절차를 적용하지 말고 아키텍처 전환 가능성부터 검토하세요.
실습에는 VirtualBox 7.2의 별도 VM을 사용했습니다. Debian 12.15, 메모리 3 GiB, 가상 디스크 30 GiB, UEFI, ext4 루트와 별도 EFI 파티션을 사용했고, bookworm 업데이트 후 커널은 6.1.0-55-amd64였습니다. 이는 관찰 환경이며 필요한 용량의 일반 기준은 아닙니다. Debian 12.15 발표에 따르면 이 포인트 릴리스는 Debian 12의 마지막 정기 갱신이며 이후 지원은 LTS의 대상 아키텍처·패키지 범위를 확인해야 합니다.
| 계속하기 위한 조건 | 중단하고 먼저 해결할 상태 |
|---|---|
| 콘솔 로그인, sudo, 새로운 SSH 접속 모두 가능 | 기존 SSH 세션 하나에만 의존하거나 복구 매체가 없음 |
| 패키지 감사 정상, 보류·외부 패키지의 이유를 파악함 | 미설정 패키지, 원인 모르는 hold, 저장소 혼합 |
| 백업의 실제 복원과 서비스 읽기 확인 완료 | 파일 존재나 체크섬만 확인함 |
| 서비스 중단·데이터 쓰기 정지·복원 시점을 합의함 | 업그레이드 후 새 데이터를 옛 스냅샷으로 덮게 됨 |
현재 버전·패키지·저장소 상태 기록하기
결과 파일은 root만 읽는 디렉터리에 저장합니다. 아래 명령은 처음 한 번 실행하는 예이며, 이미 같은 디렉터리가 있으면 덮어쓰지 않고 중단합니다. 실제 운영에서는 작업별 날짜나 변경 번호로 이름을 구분하세요.
sudo bash <<'ROOT'
set -euo pipefail
dest=/var/backups/debian13-preflight
test ! -e "$dest"
install -d -m 700 "$dest"
cat /etc/os-release > "$dest/os-release.txt"
uname -a > "$dest/kernel.txt"
dpkg --print-architecture > "$dest/architecture.txt"
dpkg-query -W -f='${binary:Package}\t${Version}\t${db:Status-Abbrev}\n' > "$dest/packages.tsv"
dpkg --get-selections '*' > "$dest/selections.txt"
apt-mark showmanual > "$dest/manual.txt"
apt-mark showhold > "$dest/holds.txt"
apt-cache policy > "$dest/apt-policy.txt"
dpkg --audit > "$dest/dpkg-audit.txt"
test ! -s "$dest/dpkg-audit.txt"
apt-get check
ROOT
dpkg --audit는 문제가 없으면 보통 아무것도 출력하지 않습니다. 결과가 있으면 내용을 읽고 원인을 해결한 뒤 다시 검사합니다. apt-get check가 의존성 오류로 끝나는 상태에서는 배포판 업그레이드를 시작하지 않습니다. hold를 무조건 해제하지 말고 보류 이유와 해당 패키지의 Debian 13 지원 여부를 확인하세요.
sudo grep -R -nE '^(deb |deb-src |Types:|URIs:|Suites:|Components:|Signed-By:)' /etc/apt/sources.list /etc/apt/sources.list.d
apt list '?narrow(?installed, ?not(?origin(Debian)))'
dpkg --print-foreign-architectures
존재하지 않는 sources.list 때문에 grep 오류가 표시될 수 있습니다. 실제 있는 .list와 .sources를 모두 살피며 bookworm, bookworm-updates, bookworm-security 외에 backports·제삼자 저장소·pin 설정이 있는지 확인합니다. URI에 인증 정보가 들어 있으면 결과를 공개하지 마세요. 외부 출처 후보 조회는 현재 APT 메타데이터를 기준으로 하므로 출력이 없다고 모든 설치 파일의 출처가 증명되는 것은 아닙니다.
먼저 Debian 12를 업데이트하고 재부팅하기
현재 저장소가 bookworm을 가리키는 것을 확인한 뒤 패키지 목록을 갱신하고 예상 변경을 읽습니다. 커널 메타 패키지가 설치되어 있는지도 확인합니다. 시뮬레이션의 삭제 목록이나 설정 질문을 검토하지 않은 채 자동 승인 옵션을 붙이지 마세요.
sudo apt update
apt -s full-upgrade
apt-cache policy linux-image-amd64 openssh-server
sudo apt full-upgrade
sudo /usr/sbin/sshd -t
sudo reboot
재부팅이 끝나면 기존 창을 재사용하는 대신 새로운 SSH 연결을 만들고, 콘솔에서도 로그인 가능한지 확인합니다. 실습에서는 업데이트 뒤 패키지 감사가 정상이었고, bookworm의 추가 전체 업그레이드 시뮬레이션은 변경할 패키지 0개였습니다. 원격 업그레이드에는 trixie 알려진 문제의 OpenSSH 관련 조건도 적용됩니다.
디스크·네트워크·서비스의 기준값 남기기
findmnt --target / -o TARGET,SOURCE,FSTYPE,OPTIONS
findmnt --target /boot -o TARGET,SOURCE,FSTYPE,OPTIONS
findmnt --target /boot/efi -o TARGET,SOURCE,FSTYPE,OPTIONS
findmnt --target /tmp -o TARGET,SOURCE,FSTYPE,OPTIONS
df -hT / /boot /var
df -i / /boot /var
ip -brief address
ip route
readlink -f /etc/resolv.conf
cat /etc/resolv.conf
sudo ss -lntup
systemctl --failed --no-pager
/boot가 별도 파일 시스템인지 루트의 일부인지 구분하고, 용량과 inode를 모두 확인합니다. EFI가 없는 BIOS 시스템에서는 /boot/efi 확인을 생략합니다. 디스크가 작다면 다운로드 캐시뿐 아니라 새 커널·initramfs·설치 중 임시 공간을 고려해야 하며, 현재 부팅한 커널이나 유일한 정상 커널을 공간 확보용으로 지우지 마세요.
주소만 기록하지 말고 인터페이스 이름, 기본 경로, DNS 파일 관리 주체, 서비스의 리슨 주소·포트를 함께 남깁니다. 웹 서비스라면 HTTP 상태와 응답 내용, 데이터베이스라면 쓰기 정지 방법과 논리 백업·복원 명령이 기준에 포함되어야 합니다. systemctl is-active가 active라는 사실만으로 데이터가 정상이라고 판단할 수 없습니다.
Debian 13에서는 기본 /tmp 저장 방식과 sysctl 설정 읽기 경로가 달라집니다. 영구 데이터를 /tmp에 두지 않았는지, 필요한 설정이 /etc/sysctl.d/*.conf에 있는지 미리 확인합니다. 실습은 /tmp의 작은 표식과 별도 sysctl 설정을 기록해 재부팅 전후 차이를 확인할 수 있게 준비했습니다.
백업 범위와 실제 복원 시험 구분하기
설정·패키지 상태 백업과 서비스 데이터 백업은 목적이 다릅니다. 다음은 앞서 만든 보안 디렉터리에 시스템 상태를 보관하는 명령입니다. 이 tar는 완전한 디스크 이미지가 아니며, 실행 중인 데이터베이스의 일관된 백업도 아닙니다. 서비스별 덤프나 쓰기 정지 절차를 별도로 적용해야 합니다.
sudo bash <<'ROOT'
set -euo pipefail
dest=/var/backups/debian13-preflight
test -d "$dest"
test ! -e "$dest/system-state.tar"
tar --acls --xattrs --numeric-owner -cpf "$dest/system-state.tar" -C / etc var/lib/dpkg var/lib/apt/extended_states
cd "$dest"
sha256sum system-state.tar > system-state.sha256
sha256sum -c system-state.sha256
ROOT
/etc에는 개인 키나 인증 정보가 있을 수 있습니다. 읽기 권한을 제한하고, 별도 장치·서버에 보관할 때는 암호화와 접근 통제를 적용합니다. 백업 경로가 같은 루트 디스크에만 있으면 디스크 손상으로 원본과 함께 잃습니다. 반대로 패키지 상태 디렉터리만 옛 버전으로 덮어쓰는 것은 운영체제 다운그레이드 방법이 아닙니다.
복원 절차를 직접 연습하려면 운영 데이터 대신 다음의 독립된 작은 파일을 사용합니다. 원본을 다른 위치로 옮긴 뒤 아카이브에서 실제 복원하고, 내용·소유자·권한을 비교합니다. 이 예제의 UID 1000은 자신의 실습 계정 UID와 다르면 바꾸세요.
sudo bash <<'ROOT'
set -euo pipefail
dest=/var/backups/debian13-preflight
test -d "$dest"
test ! -e /var/lib/preflight-demo
test ! -e "$dest/demo.tar"
install -d -m 750 -o 1000 -g 1000 /var/lib/preflight-demo
printf 'upgrade backup sample\n' > /var/lib/preflight-demo/message.txt
chown 1000:1000 /var/lib/preflight-demo/message.txt
chmod 640 /var/lib/preflight-demo/message.txt
stat -c '%u:%g:%a' /var/lib/preflight-demo/message.txt > "$dest/demo-mode.txt"
sha256sum /var/lib/preflight-demo/message.txt > "$dest/demo-data.sha256"
tar --acls --xattrs --numeric-owner -cpf "$dest/demo.tar" -C / var/lib/preflight-demo
mv /var/lib/preflight-demo/message.txt "$dest/demo-held.txt"
tar --acls --xattrs --numeric-owner --same-owner -xpf "$dest/demo.tar" -C / var/lib/preflight-demo/message.txt
cmp "$dest/demo-held.txt" /var/lib/preflight-demo/message.txt
test "$(stat -c '%u:%g:%a' /var/lib/preflight-demo/message.txt)" = "$(cat "$dest/demo-mode.txt")"
sha256sum -c "$dest/demo-data.sha256"
ROOT
예상 결과는 비교 명령이 오류 없이 끝나고 SHA-256 확인에 OK가 표시되는 것입니다.
실제 검증은 이와 같은 방식으로 실습 HTTP 서비스의 데이터를 옮긴 뒤 백업에서 복원하고, 파일 해시·UID·GID·권한과 HTTP 응답까지 비교했습니다. 비밀 없는 세 실습 파일만 별도로 VM 밖에 복사해 해시와 내용을 확인했으며 전체 시스템 설정 아카이브는 VM 안에 보관했습니다. 따라서 이 실습이 호스트 전체 손실을 견디는 독립 시스템 백업까지 검증한 것은 아닙니다.
작은 파일 실습만 정리하려면 복원이 성공한 것을 확인한 뒤 sudo rm -- /var/lib/preflight-demo/message.txt와 sudo rmdir -- /var/lib/preflight-demo를 실행합니다. 백업은 업그레이드 결과를 확인할 때까지 보관하고 실제 서비스 파일과 혼동하지 마세요.
콘솔·정상 재부팅·되돌림 시점 확정하기
VirtualBox 관리자에서 대상 VM을 선택하고 콘솔을 연 뒤 로그인·sudo를 시험합니다. 설치 ISO나 rescue 진입 방법, 루트·EFI 파티션 식별 정보, 백업 위치도 SSH 밖에서 확인할 수 있어야 합니다. 정상 종료한 VM의 스냅샷은 현재 상태로 빠르게 돌아가는 수단이지만 같은 호스트와 저장장치에 의존합니다.
- 업그레이드 시작 전 쓰기를 중단하고 서비스 데이터를 마지막으로 백업합니다.
- 게스트를 정상 종료한 뒤 VM의 스냅샷 메뉴에서 변경 전 상태를 저장합니다. 실행 중인 DB의 일관성을 스냅샷 자체가 보장한다고 생각하지 마세요.
- VM을 켜고 자동 부팅, 새 SSH 연결, 서비스 응답과 데이터 해시를 확인합니다.
- 실패 시 누가 콘솔을 열고 어느 백업으로 복원할지, 새로 생긴 데이터를 어떻게 보존할지 기록합니다.
실습에서는 이 마지막 부팅 확인에서 EFI 디렉터리에 부트로더가 있지만 부팅 순서에 등록되지 않은 문제를 발견했습니다. 콘솔로 EFI/debian/shimx64.efi를 선택해 부팅한 뒤 실제 UEFI 항목을 확인해 순서를 수정했고, 냉간 재시작에서 자동 부팅·새 SSH·서비스 응답을 다시 확인했습니다. 부팅 항목 번호는 장치마다 다르므로 다른 시스템의 efibootmgr 번호를 복사해 적용하면 안 됩니다.
업그레이드 후 쓰기를 재개한 다음 옛 스냅샷으로 돌아가면 그 사이 데이터가 사라질 수 있습니다. 패키지 설치 실패, 부팅 실패, 서비스 데이터 오류 각각에 대해 계속 수리할지 전체 상태를 복원할지 기준을 정하세요. Debian 공식 업그레이드 안내와 자신의 서비스 문서를 함께 읽고, 미해결 항목이 없을 때 저장소 전환을 시작합니다.




