Debian 13 강좌 / Debian 12 업그레이드 실행과 재부팅 검증
Debian 12에서 13으로 올릴 때는 저장소를 trixie로 전환한 뒤 최소 업그레이드와 전체 업그레이드를 순서대로 실행합니다. 완료 여부는 APT의 종료 메시지뿐 아니라 새 커널 부팅, 새 SSH 연결, 네트워크와 서비스 데이터, 임시 파일·커널 설정의 동작까지 확인해 판단합니다.
시작 조건과 접속 세션 준비
업그레이드 사전 점검과 복구 준비를 마친 amd64 Debian 12 서버를 대상으로 합니다. 백업 복원·콘솔 로그인·정상 재부팅을 아직 확인하지 않았다면 먼저 준비를 끝내세요. 외부 저장소나 다른 아키텍처, 데이터베이스·메일 서버가 있는 환경은 해당 제품의 전환 지침을 추가로 검토해야 합니다.
검증 환경은 별도 VirtualBox VM의 Debian 12.15, 커널 6.1.0-55-amd64, 3 GiB 메모리, 30 GiB 가상 디스크였습니다. 실제 두 단계 설치와 재부팅을 수행했습니다. Python 서비스의 코드·데이터를 백업하고 HTTP 응답을 기준값으로 남겼으며, 운영 중인 데이터베이스의 메이저 버전 전환을 시험한 환경은 아닙니다.
bookworm에서 tmux가 없다면 저장소를 바꾸기 전에 sudo apt install tmux로 설치합니다. 별도의 콘솔을 열어 둔 상태에서 아래 세션을 만들고 기록을 시작하세요. 로그에는 설정 내용이 포함될 수 있어 공개하지 않습니다.
tmux new-session -s debian13-upgrade
umask 077
script -a -f "$HOME/debian13-upgrade.typescript"
SSH 연결만 끊기면 다시 접속해 tmux attach-session -t debian13-upgrade로 돌아갑니다. APT가 진행 중인지 먼저 살피고 같은 업그레이드를 중복 실행하지 마세요. tmux는 SSH 단절에 대비하는 도구이며 재부팅이나 전원 장애를 견디는 작업 보장은 아닙니다.
저장소를 확인하고 deb822 형식으로 전환
이 예제는 공식 bookworm 항목이 /etc/apt/sources.list 한 파일에만 있고 sources.list.d에는 활성 항목이 없는 실습 서버용입니다. 먼저 실제 파일을 읽고 기존 외부 저장소·backports·pin 설정을 별도로 처리하세요. 아래 사전 조건이 맞지 않으면 일괄 문자열 치환을 하는 대신 실제 저장소 구성에 맞게 수정합니다.
sudo cat /etc/apt/sources.list
sudo find /etc/apt/sources.list.d -maxdepth 1 -type f -print
sudo bash <<'ROOT'
set -euo pipefail
. /etc/os-release
test "$VERSION_ID" = 12
test -z "$(dpkg --audit)"
test -z "$(find /etc/apt/sources.list.d -maxdepth 1 -type f -print -quit)"
test -f /usr/share/keyrings/debian-archive-keyring.gpg
dest=/var/backups/debian13-upgrade
test ! -e "$dest"
install -d -m 700 "$dest"
cp -a /etc/apt/sources.list "$dest/sources.list.bookworm"
mv /etc/apt/sources.list "$dest/sources.list.disabled"
cat > /etc/apt/sources.list.d/debian.sources <<'SOURCES'
Types: deb
URIs: https://deb.debian.org/debian
Suites: trixie trixie-updates
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
Types: deb
URIs: https://security.debian.org/debian-security
Suites: trixie-security
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
SOURCES
ROOT
sudo apt update
apt-cache policy apt systemd linux-image-amd64 openssh-server
main non-free-firmware는 이 VM에서 사용한 구성입니다. 기존 서버가 contrib·non-free를 필요로 한다면 패키지와 정책을 검토해 구성 요소를 추가합니다. deb-src가 필요한 개발 환경도 별도 고려 대상입니다. Signed-By는 실제 Debian 아카이브 키링을 가리키며, 서명 오류를 무시하는 옵션을 붙이면 안 됩니다. 형식은 Debian sources.list 매뉴얼에서 확인할 수 있습니다.
목록 갱신이 오류 없이 끝나고 후보 버전이 trixie 계열에서 오는지 확인합니다. 이 시점에는 아직 Debian 13 패키지를 설치하지 않았으므로 잘못된 저장소 선택을 발견했다면 새 파일을 비활성화하고 보관한 bookworm 파일을 복원해 다시 갱신할 수 있습니다. 설치를 시작한 뒤에는 저장소만 되돌려 전체 시스템이 원복된다고 생각하면 안 됩니다.
최소 업그레이드를 완료한 뒤 전체 변경 검토
apt -s upgrade --without-new-pkgs
sudo apt upgrade --without-new-pkgs
sudo dpkg --audit
apt -s full-upgrade
첫 단계는 새 패키지를 설치하거나 기존 패키지를 제거하지 않고 가능한 항목을 갱신합니다. 남겨 둔 패키지가 있다고 바로 실패는 아닙니다. 검증 VM에서는 최소 단계에 222개가 갱신되었고 새 설치·삭제는 없었습니다. 전체 단계가 필요로 하는 라이브러리 교체는 다음 단계에서 처리합니다.
시뮬레이션에서 삭제할 패키지의 이름과 대체 패키지를 대조합니다. 예를 들어 이 VM에서는 libssl3 등 25개가 삭제 대상으로 나타났고 libssl3t64 같은 후속 패키지가 새로 설치되었습니다. 이것이 모든 삭제를 허용할 이유는 아닙니다. SSH·네트워크·스토리지·애플리케이션을 지탱하는 패키지가 대체 없이 사라진다면 진행을 멈추세요. APT 매뉴얼에 설명된 것처럼 full-upgrade에는 삭제가 수반될 수 있습니다.
검토는 삭제 목록뿐 아니라 다운로드 크기, 설치 후 추가 공간, 보류된 패키지와 외부 의존성을 포함합니다. 다른 APT 작업이 실행 중이면 끝날 때까지 기다리며, 잠금 파일을 지우거나 패키지 프로세스를 강제 종료하지 않습니다.
전체 업그레이드와 설정 파일 선택
sudo apt full-upgrade
sudo dpkg --audit
sudo apt-get check
sudo /usr/sbin/sshd -t
systemctl --failed --no-pager
실제 변경 요약이 검토한 목록과 같은지 읽고 승인합니다. apt-listchanges의 안내가 열리면 내용을 읽고 종료해야 설치가 이어집니다. dpkg나 ucf가 수정된 설정 파일을 어떻게 처리할지 물으면 어떤 파일인지, 직접 바꾼 내용이 무엇인지부터 확인하세요.
| 선택 상황 | 판단과 후속 확인 |
|---|---|
| 인증·포트·네트워크 등 의도한 로컬 변경이 있음 | 차이를 확인하고 필요한 변경을 보존합니다. 보존한 구문이 새 버전에도 유효한지 검사합니다. |
| 배포 기본 설정을 바꾼 적이 없거나 새 버전에 필수 변경이 있음 | 패키지 안내와 새 기본값을 검토합니다. 기존 파일 보존을 무조건 정답으로 취급하지 않습니다. |
| 중요 설정의 차이를 판단할 수 없음 | 콘솔·백업을 유지한 채 설명과 diff를 확인합니다. 재부팅을 서두르지 않습니다. |
| 자동 설치 환경 | 선택 정책을 사전 시험합니다. 비대화형 변수 하나로 모든 질문과 호환성이 해결되지는 않습니다. |
이 강좌의 검증 VM은 별도 tmux 작업에서 로그와 종료 코드를 저장했고, 변경 없는 최소 서버 설정을 기준으로 기존 수정 설정을 보존하는 정책을 지정했습니다. 위 독자용 절차는 질문을 읽고 선택하는 대화형 실행입니다. 실습의 자동 승인 옵션을 운영 서버 전체에 그대로 적용하도록 안내하지 않습니다.
설치가 오류로 끝나면 우선 로그와 디스크 공간, 패키지 상태를 확인합니다. 진행 중인 APT 작업이 없고 원인을 해결한 경우에만 sudo dpkg --configure -a나 sudo apt --fix-broken install이 제안하는 변경을 검토합니다. 설치 중간 재부팅이나 일괄 제거·강제 덮어쓰기를 일반적인 해결책으로 사용하지 마세요.
재부팅 전에 커널·NIC·SSH 확인
dpkg-query -W linux-image-amd64 'linux-image-*'
ls -l /vmlinuz /initrd.img
sudo ls -lh /boot
sudo /usr/sbin/sshd -t
ip -brief link
sudo udevadm test-builtin net_setup_link /sys/class/net/enp0s3
sudo efibootmgr -v
enp0s3는 검증 VM의 인터페이스입니다. 실제 이름으로 바꾸고 ID_NET_NAME과 현재 네트워크 설정의 인터페이스를 비교하세요. 일부 하드웨어에서는 이름이 바뀔 수 있어 콘솔이 필요합니다. BIOS 시스템은 efibootmgr 대신 해당 부팅 방식과 GRUB 설치 상태를 확인합니다.
새 커널·initramfs가 설치되어 있어도 현재 uname -r는 재부팅 전 커널을 표시합니다. 새 SSH 창을 실제로 열어 인증·sudo가 되는지 확인하고, 아직 열려 있는 연결 하나만으로 정상이라고 판단하지 마세요. 검증 VM의 인터페이스 이름은 바뀌지 않았고, 재부팅 전 새로운 SSH 연결이 성공했습니다.
sudo reboot
부팅이 지연되면 콘솔에서 부트로더·커널·서비스 중 어느 단계인지 확인합니다. 즉시 전원을 끄거나 호스트 키 확인을 끄는 대신 실제 부팅 상태와 원래 지문을 확인하세요.
새 운영체제에서 서비스와 데이터까지 검증
cat /etc/os-release
uname -r
sudo dpkg --audit
sudo apt-get check
ip -brief address
ip route
getent ahostsv4 deb.debian.org
systemctl --failed --no-pager
sudo /usr/sbin/sshd -t
재접속한 VM에서 Debian 13.7과 커널 6.12.117+deb13-amd64를 확인했습니다. 기존 서비스는 enabled·active였고, HTTP 본문을 사전 기준값과 비교했으며 프로그램·데이터의 SHA-256도 동일했습니다. 자신의 서비스에서도 실제 이름·주소·파일로 다음처럼 확인합니다. 샘플 경로를 임의의 운영 파일로 바꾸어 삭제하거나 덮어쓰지 마세요.
systemctl is-enabled lf-upgrade33.service
systemctl is-active lf-upgrade33.service
curl --noproxy '*' -fsS http://127.0.0.1:8080/
sudo sha256sum -c /var/backups/lf-debian13-upgrade33/service-files-before.sha256
위 서비스는 사전 점검용 검증 VM에만 존재합니다. 일반 서버에서는 실제 서비스의 상태, 포트, 읽기 응답과 데이터베이스 연결 등을 대조합니다. 쓰기 기능이 있는 서비스는 격리된 테스트 데이터로 쓰기·재조회도 확인한 뒤 실제 쓰기를 재개합니다.
/tmp와 sysctl 설정 변경 확인
findmnt --target /tmp -o TARGET,SOURCE,FSTYPE,OPTIONS
df -hT /tmp
sudo /usr/lib/systemd/systemd-sysctl --cat-config
sysctl kernel.printk_ratelimit
검증 VM은 재부팅 후 /tmp가 tmpfs로 바뀌었습니다. tmpfs의 크기 제한은 그만큼 메모리를 미리 예약한다는 뜻이 아닙니다. 이전 루트 파일 시스템의 /tmp에 있던 파일은 새 마운트 아래에 가려질 수 있습니다. 이전 파일을 찾아야 한다면 임시 빈 마운트 지점을 만들고 일반 bind mount로 루트만 보세요. 하위 tmpfs까지 따라가는 --rbind를 사용하지 않습니다.
sudo bash <<'ROOT'
set -euo pipefail
view=$(mktemp -d /mnt/old-root-view.XXXXXX)
trap 'mountpoint -q "$view" && umount "$view"; rmdir "$view"' EXIT
mount --bind / "$view"
find "$view/tmp" -mindepth 1 -maxdepth 2 -printf '%p\n'
umount "$view"
rmdir "$view"
trap - EXIT
ROOT
이 명령은 목록만 보여 줍니다. 실제 서버에서는 파일의 주체와 필요성을 판단하고 전체 임시 디렉터리를 일괄 삭제하지 마세요. 검증 VM의 이전 표식은 루트 보기에서도 없었고, 업그레이드 전 마지막 부팅 직후의 잔존 여부를 기록하지 않아 파일 소실을 업그레이드 탓으로 판단하지 않았습니다. 가림 원리 자체는 별도 마운트 네임스페이스의 작은 실습 디렉터리에서 tmpfs를 덮었을 때 기존 파일이 숨고, 일반 루트 bind 보기에서는 보이는 것을 확인했습니다. 이는 기존 표식의 업그레이드 전후 추적과 구분한 검증입니다.
Debian 13의 systemd-sysctl은 /etc/sysctl.conf를 직접 읽지 않습니다. 필요한 로컬 설정을 /etc/sysctl.d/의 개별 파일로 관리하고 실제 런타임 값과 비교합니다. 실습에서는 별도 drop-in의 kernel.printk_ratelimit=7이 새 커널 부팅 후에도 적용된 것을 확인했으며 검증 후 자신의 drop-in만 제거하고 원래 값으로 복원했습니다. 전체 설정을 무심코 재적용하면 네트워크 등 다른 값에도 영향을 줄 수 있으므로 적용 범위를 정하세요. systemd-sysctl 매뉴얼이 파일 선택과 적용 방법을 설명합니다.
작업 종료와 복구 판단
중단했던 모니터링·예약 작업·APT 타이머가 있다면 기록한 원래 상태로 복원합니다. 검증 VM에서는 APT의 두 타이머를 다시 enabled·active 상태로 돌렸습니다. 불필요한 패키지는 전체 검증 후 apt -s autoremove로 목록을 먼저 살피며, 정상 부팅용 이전 커널이나 서비스 의존성을 성급히 제거하지 않습니다.
서비스·데이터 검증이 실패하면 새 쓰기를 재개하지 않은 상태로 로그와 실패 증거를 보존합니다. 패키지가 이미 교체되었다면 bookworm 저장소로 바꾸는 것만으로 복구되지 않습니다. 수리 범위를 판단하거나 사전 검증한 전체 상태·서비스 백업을 이용하고, 전환 뒤 새 데이터가 있다면 별도 보존·재적용 계획을 세웁니다. 공식 Debian 업그레이드 절차와 trixie의 알려진 변경 사항을 해당 서비스의 전환 문서와 함께 확인하세요.




