Debian 13 강좌 / APT 잠금·의존성 오류와 backports·pinning 진단
Debian 13의 APT 오류는 먼저 다른 작업의 잠금, 디스크 공간, 중단된 dpkg 처리, 패키지 후보·의존성 문제로 나누어 진단합니다. 잠금 파일을 지우거나 다른 Debian 릴리스를 섞어 해결하려고 하지 말고 실제 점유 프로세스와 설치 계획을 확인해야 합니다. backports와 pinning은 필요한 패키지의 버전 선택을 조정하는 도구이므로 원인 진단 뒤 제한된 범위에서 사용합니다.
오류 메시지와 현재 상태부터 기록하기
실패한 명령과 마지막 오류를 남기고 같은 명령을 무작정 반복하지 않습니다. 서버 상태 기록과 APT 이력은 언제 무엇이 바뀌었는지 좁히는 데 도움이 됩니다. 다음은 패키지를 변경하지 않는 조회입니다.
cat /etc/os-release
sudo dpkg --audit
apt-mark showhold
df -h / /var
df -i / /var
sudo tail -n 40 /var/log/apt/history.log
sudo tail -n 40 /var/log/dpkg.log
dpkg --audit가 아무것도 출력하지 않으면 이 검사가 보고할 미완료 항목이 없다는 뜻입니다. 모든 애플리케이션이 정상이라는 보증은 아닙니다. hold 목록에 있는 패키지는 관리자가 업데이트를 보류한 이유부터 확인합니다. 공간은 용량과 파일 수 제한인 inode를 각각 확인하며 /var가 별도 마운트라면 그 파일 시스템을 기준으로 봅니다.
| 오류 단서 | 먼저 확인할 대상 | 바로 하지 않을 작업 |
|---|---|---|
| Could not get lock | 진행 중인 apt·dpkg·자동 업데이트 | 잠금 파일 삭제 |
| No space left on device | 대상 파일 시스템 용량·inode | 원인 모르는 시스템 파일 삭제 |
| dpkg was interrupted | 중단 시점과 audit·로그 | 데이터베이스 파일 직접 편집 |
| unmet dependencies·held broken packages | 후보 버전·저장소·pin·hold | testing·unstable 저장소 임의 추가 |
잠금 파일의 존재와 점유 상태 구분하기
패키지 관리 도구는 같은 데이터베이스를 동시에 바꾸지 않도록 프로세스 잠금을 사용합니다. 파일이 디스크에 있다는 사실만으로 현재 점유 중인 것은 아닙니다. Debian dpkg FAQ도 잠금 파일 제거를 해결 방법으로 사용하지 않도록 설명합니다.
sudo lslocks -u -o PID,COMMAND,TYPE,PATH
systemctl status apt-daily.service apt-daily-upgrade.service --no-pager
sudo journalctl -u apt-daily-upgrade.service -b --no-pager -n 30
lslocks는 현재 잠금과 PID를 조회하며 -u는 긴 경로를 잘라 표시하지 않게 합니다. 실습 VM의 util-linux 2.41.5에서 지원을 확인했습니다. /var/lib/dpkg/lock-frontend, /var/lib/dpkg/lock, APT 목록·아카이브 잠금 경로를 확인하고 오류에 표시된 PID와 대조합니다.
read -r -p '오류 또는 잠금 조회에서 확인한 PID: ' lock_pid
ps -fp "$lock_pid"
정상 업데이트가 진행 중이면 끝날 때까지 기다립니다. 화면이 멈춰 보인다고 설치 작업이 멈췄다고 단정하지 말고 로그·프로세스 상태·실행 시간을 함께 봅니다. 강제 종료는 정상 종료 가능성과 영향 범위를 검토한 별도 복구 판단이며, 단순한 첫 단계로 kill -9를 실행하지 않습니다.
검증에서는 실제 dpkg 잠금 대신 별도 임시 파일에 프로세스 잠금을 만들었습니다. 다른 프로세스의 충돌이 거부되고 lslocks에서 보이며, 파일을 지우지 않고 닫았을 때 다시 잠금을 얻는 것을 확인했습니다. 운영 중인 dpkg 작업을 일부러 중단시켜 오류를 재현하지 않았습니다.
중단된 처리와 의존성 문제를 복구하는 순서
다른 패키지 작업이 끝났고 공간이 충분한지 확인한 뒤, audit와 로그가 중단된 구성을 가리키는 경우에만 다음을 검토합니다.
sudo dpkg --configure -a
sudo apt-get check
sudo apt-get -s -f install
dpkg --configure -a는 풀렸지만 아직 구성되지 않은 패키지의 처리를 진행합니다. 패키지 관리 스크립트와 서비스 작업이 실행될 수 있으므로 단순 조회 명령이 아닙니다. 오류가 반복되면 어떤 패키지의 어떤 스크립트가 실패하는지 읽고 디스크·설정·의존성 원인을 해결합니다.
apt-get check는 의존 관계를 검사하고, -s -f install은 깨진 의존성을 고치는 계획을 모의로 보여 줍니다. 제거 대상에 필요한 서비스·커널·관리 도구가 포함되면 승인하지 않습니다. 계획을 이해하고 백업·영향을 확인한 경우에만 sudo apt-get -f install로 실제 처리합니다. 검증 VM은 정상 상태여서 check와 복구 모의 실행은 변경 0개였으며, 실제로 망가진 데이터베이스를 복구했다고 주장하지 않습니다.
후보를 못 찾는 문제에는 apt-cache policy 패키지명으로 Installed·Candidate·출처를 확인합니다. 버전 고정 요청이 현재 저장소에 없을 수도 있습니다. 실습의 apt-get -s install tmux=0.invalid.0 요청은 Version was not found로 거부되었고 패키지를 설치하지 않았습니다. 이 오류는 패키지 데이터베이스 손상과 다릅니다.
backports가 필요한지 먼저 판단하기
backports는 새 기능이 필요한 일부 패키지를 안정 릴리스에 맞추어 다시 빌드해 제공하는 경로입니다. testing 저장소를 직접 섞는 것과 같지 않습니다. 기존 안정판 패키지로 요구를 충족하면 추가할 필요가 없습니다. 새 버전에 필요한 기능·의존성·서비스 설정 차이와 유지관리 책임을 먼저 판단합니다.
Debian Backports 안내는 필요한 특정 패키지를 골라 사용하는 방식을 권장합니다. Backports FAQ의 보안 지원 설명처럼 안정판의 보안 지원과 같은 보장을 가정해서는 안 되며 담당자의 최선 노력에 의존하는 범위를 확인해야 합니다. 전체 시스템을 backports로 바꾸는 일반 업그레이드 정책으로 사용하지 않습니다.
다음은 tmux가 설치되지 않은 전용 VM에서 후보와 모의 설치만 비교하는 실습입니다. tmux는 한 터미널에서 여러 작업 세션을 관리하는 프로그램입니다. 기존 운영용 tmux를 제거하거나 교체하는 실습은 하지 않습니다.
apt-cache policy tmux
sudo test ! -e /etc/apt/sources.list.d/lf-course-backports.sources
sudo test ! -e /etc/apt/preferences.d/lf-course-tmux.pref
sudo nano /etc/apt/sources.list.d/lf-course-backports.sources
기존 같은 파일이 있거나 tmux가 설치되어 있으면 예제의 전제를 먼저 맞춥니다. 새 저장소 파일에 아래 전체 내용을 넣습니다. deb822 기본 문법과 백업은 저장소 형식 설정 실습의 방법을 적용합니다.
Types: deb
URIs: http://deb.debian.org/debian
Suites: trixie-backports
Components: main
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
sudo apt update
apt-cache policy tmux
sudo apt-get -s install tmux
sudo apt-get -s -t trixie-backports install tmux
실제 비교에서 안정판은 3.5a-3·우선순위 500, backports는 3.7c-1~bpo13+1·우선순위 100이었습니다. 기본 요청은 안정판, -t로 대상 갈래를 지정한 모의 요청은 backports를 선택했습니다. 필요한 libevent 패키지도 계획에 표시되었으므로 tmux 한 이름만 읽고 승인하면 안 됩니다. 버전·아키텍처별 제공 시점은 달라질 수 있어 자신의 policy 결과를 기준으로 합니다.
실제 설치가 필요하다면 전체 의존성 계획을 검토한 뒤 해당 모의 명령에서 -s를 제거합니다. 이 글의 검증은 후보 비교와 모의 설치까지만 진행했으며 새 tmux를 설치한 것으로 표시하지 않습니다. -t는 그 요청의 대상 갈래를 지정하므로 의존성 선택에도 영향을 줄 수 있습니다.
단일 패키지 pinning으로 후보 변화 비교
pinning은 특정 패키지·버전에 적용되는 선택 우선순위를 조정하는 방법입니다. APT 우선순위 매뉴얼의 규칙을 이해하고 좁은 범위로 사용합니다. 숫자를 크게 하면 문제가 해결된다고 생각해 모든 패키지에 높은 값을 적용하지 않습니다.
sudo nano /etc/apt/preferences.d/lf-course-tmux.pref
새 파일에 다음 세 줄을 입력합니다. Package는 tmux 하나로 한정하며 n은 Release 정보의 코드명 조건입니다.
Package: tmux
Pin: release n=trixie-backports
Pin-Priority: 600
apt-cache policy tmux
sudo apt-get -s install tmux
실습에서는 backports의 tmux가 600으로 평가되어 일반 요청의 후보도 3.7c로 바뀌었습니다. 이제 같은 파일의 600만 50으로 바꾸고 다시 확인합니다.
sudo nano /etc/apt/preferences.d/lf-course-tmux.pref
apt-cache policy tmux
sudo apt-get -s install tmux
| 같은 미설치 tmux의 조건 | backports 우선순위 | 실습의 기본 후보 |
|---|---|---|
| 사용자 pin 없음 | 100 | 안정판 3.5a |
| tmux만 pin 600 | 600 | backports 3.7c |
| 같은 pin을 50으로 변경 | 50 | 안정판 3.5a |
이는 같은 저장소·같은 미설치 패키지에서 한 값을 바꾼 비교입니다. 이미 backports 버전을 설치한 경우에는 우선순위를 낮추거나 저장소를 지워도 자동으로 예전 버전으로 내려가지 않습니다. APT의 다운그레이드 규칙과 의존성 때문에 단순 숫자 비교만으로 결정되지 않습니다. 1000을 넘는 강제적인 우선순위로 무작정 되돌리지 않습니다.
추가한 설정만 복구하고 최종 상태 확인
실습용 두 파일만 삭제합니다. 기존 저장소나 다른 관리자의 pin 파일은 변경하지 않습니다. 필요한 비교 자료가 있다면 먼저 별도 보관합니다.
sudo rm -- /etc/apt/preferences.d/lf-course-tmux.pref
sudo rm -- /etc/apt/sources.list.d/lf-course-backports.sources
sudo apt update
apt-cache policy tmux
sudo dpkg --audit
sudo apt-get check
검증 VM에서는 처음과 같은 tmux 후보로 복구되었고 설치된 패키지·버전·상태 목록도 바이트 단위 비교에서 변하지 않았습니다. backports를 실제 설치했다면 이 정리만으로 설치 이전으로 돌아가지 않습니다. 복구가 필요한 경우에는 변경 패키지와 데이터를 기준으로 별도의 계획을 세웁니다.
오류 해결의 완료 기준은 경고 문구를 숨기는 것이 아니라 잠금 점유자를 설명할 수 있고, 필요한 공간과 패키지 상태가 정상이며, 출처와 후보·의존성 계획이 의도대로인 것입니다. 수정 후에는 원래 실패했던 작업을 해당 영향 범위 안에서 다시 확인합니다.




