일반적인 패키지 관리 실패(APT/YUM) 문제 해결 방법

패키지 관리자 오류는 보안 업데이트, 배포, 또는 평소에 건드리지 않는 호스트에서 '이 도구 하나만 설치'하려는 순간에 발생합니다. APT, YUM, DNF는 일반적으로 무엇이 잘못되었는지 알려주지만, 출력이 복잡할 수 있습니다. 중요한 것은 속도를 늦추고, 어떤 계층에서 실패했는지 식별하며, 데이터베이스를 더 나쁜 상태로 강제하지 않는 것입니다.

APT는 Debian 및 Ubuntu 시스템에서 일반적입니다. YUM과 DNF는 Red Hat 계열 시스템에서 일반적이며, DNF는 많은 최신 릴리스에서 YUM을 대체합니다. 아래 예제는 관리자가 실제로 보는 오류(깨진 트랜잭션, 저장소 메타데이터 문제, 종속성 충돌, 잠금, GPG 오류, 패키지 데이터베이스 문제)에 중점을 둡니다.

변경하기 전에 정확한 명령과 오류를 캡처하세요. 프로덕션 서버인 경우 다른 업데이트 프로세스가 실행 중인지도 확인하세요. 두 패키지 관리자가 동일한 데이터베이스를 놓고 경쟁하면 작은 문제가 긴 수리로 이어질 수 있습니다.

일반적인 APT 오류 및 문제 해결

APT는 포괄적인 종속성 해결 기능으로 유명합니다. 그러나 깨진 종속성, 중단된 다운로드 또는 저장소 문제와 관련된 문제가 여전히 발생할 수 있습니다.

1. 깨진 패키지 또는 충족되지 않은 종속성

이것은 아마도 가장 일반적인 APT 오류일 것입니다. 패키지가 설치되었지만 해당 종속성이 누락되었거나, 깨졌거나, 호환되지 않는 경우에 발생합니다. 오류 메시지는 종종 다음과 같습니다:

오류: dpkg가 중단되었습니다. 문제를 해결하려면 'sudo dpkg --configure -a'를 실행해야 할 수 있습니다.

압축 풀기 ... (데이터베이스 읽는 중 ... xxxx 파일 및 디렉터리가 현재 설치됨)

.../some-package_version_arch.deb 압축 풀기 준비 중 ...

some-package (버전) 압축 풀기 ...

dpkg: 오류: /var/cache/apt/archives/some-package_version_arch.deb 아카이브 처리 중 (--unpack):
 '/path/to/file'을(를) 덮어쓰려고 하는데, 이는 패키지 other-package:amd64에도 있습니다.

처리 중 오류가 발생했습니다:
 some-package
 E: 하위 프로세스 /usr/bin/dpkg가 오류 코드(1)를 반환했습니다.

문제 해결 단계:

대기 중인 패키지 구성: dpkg가 중단된 경우 첫 번째 단계는 수정을 시도하는 것입니다:
```
sudo dpkg --configure -a
```
이 명령은 압축은 풀렸지만 아직 구성되지 않은 모든 패키지를 구성하려고 시도합니다.
깨진 종속성 수정: 위 방법으로 해결되지 않으면 깨진 종속성을 수정해 볼 수 있습니다:
```
sudo apt --fix-broken install
```
이 명령은 누락된 종속성을 다운로드하여 설치하거나 문제가 있는 패키지를 제거하려고 시도합니다.
문제가 있는 패키지 제거: 특정 패키지가 지속적인 문제를 일으키는 경우가 있습니다. 해당 패키지를 제거해 볼 수 있습니다:
```
sudo apt remove <패키지-이름>
```
패키지를 정상적으로 제거할 수 없는 경우 강제로 제거해야 할 수도 있습니다(주의해서 사용):
```
sudo dpkg --remove --force-remove-reinstreq <패키지-이름>
```
APT 캐시 정리: 손상된 캐시도 오류를 유발할 수 있습니다:
```
sudo apt clean
sudo apt update
```
apt clean은 /var/cache/apt/archives/에서 다운로드한 패키지 파일을 제거하고, apt update는 패키지 목록을 새로 고칩니다.

2. 저장소 문제

구성된 저장소에서 패키지 목록을 검색할 수 없는 경우 오류가 발생할 수 있습니다. 이는 네트워크 문제, 잘못된 저장소 URL 또는 저장소를 일시적으로 사용할 수 없기 때문일 수 있습니다.

오류 예:

E: http://archive.ubuntu.com/ubuntu/dists/jammy/InRelease를 가져오지 못했습니다. 'archive.ubuntu.com'을 확인하는 중 일시적인 오류 발생
E: 일부 인덱스 파일을 다운로드하지 못했습니다. 무시되거나 이전 파일이 대신 사용됩니다.

문제 해결 단계:

DNS 및 네트워크 연결 확인: DNS 오류는 새로 구축된 서버와 끊어진 VPN 경로에서 흔합니다.
```
getent hosts archive.ubuntu.com
curl -I http://archive.ubuntu.com/ubuntu/
```
저장소 소스 확인: /etc/apt/sources.list 및 /etc/apt/sources.list.d/의 파일 내용을 확인하세요. URL이 올바르고 접근 가능한지 확인하세요.
- 오타를 찾으세요.
- 의심스러운 저장소 항목을 주석 처리하거나 제거하세요.
다른 미러 시도: 특정 미러가 다운된 경우 APT가 자동으로 다른 미러를 시도할 수 있습니다. 그렇지 않은 경우 sources.list를 수동으로 편집하여 다른 미러를 선택하세요.
패키지 목록 업데이트: 변경 후에는 항상 다음을 실행하세요:
```
sudo apt update
```

apt update가 서명에 대해 불평하는 경우 지름길로 서명 확인을 비활성화하지 마세요. 저장소 서명은 변조된 패키지 설치로부터 사용자를 보호합니다. 저장소 공급업체가 키를 변경했는지, 키링 패키지가 오래되었는지, 또는 오래된 타사 저장소가 더 이상 유지 관리되지 않는지 확인하세요.

3. 중단된 설치 또는 업그레이드

apt install 또는 apt upgrade 프로세스가 중단되면(예: 정전 또는 시스템 재부팅) 시스템이 일관되지 않은 상태로 남을 수 있습니다.

문제 해결 단계:

sudo dpkg --configure -a 실행: 앞서 언급했듯이 이것은 dpkg 구성 문제를 해결하기 위한 첫 번째 단계입니다.
sudo apt --fix-broken install 실행: 중단으로 인해 발생한 종속성 문제를 해결할 수 있습니다.
명령 다시 실행: 때로는 실패한 명령을 다시 실행하는 것만으로도 일시적인 문제가 해결될 수 있습니다.

일반적인 YUM/DNF 오류 및 문제 해결

YUM과 DNF는 Red Hat 기반 시스템에서 패키지를 관리하는 강력한 도구입니다. APT와 유사하게 오류는 종종 종속성 문제, 저장소 문제 또는 손상된 캐시에서 비롯됩니다.

1. 종속성 오류

YUM/DNF의 종속성 오류는 요청된 패키지에 설치되지 않았거나, 호환되지 않는 버전이거나, 구성된 저장소에서 찾을 수 없는 다른 패키지가 필요한 경우 발생합니다.

오류 예 (YUM):

오류: 패키지: some-package-1.0-1.el8.x86_64 (epel)
 필요: another-package >= 2.0
 시도해 볼 수 있음: rpm -e --nodeps some-package

오류 예 (DNF):

오류:
 문제: 이 패키지에 대한 최상의 후보를 설치할 수 없습니다(루트는 설치 프로세스를 의미함)
  - 'some-package-1.0-1.el8.x86_64'에 필요한 'another-package >= 2.0' 종속성을 제공하는 것이 없습니다.

문제 해결 단계:

패키지 정보 업데이트: 로컬 패키지 캐시가 최신 상태인지 확인하세요:
```
sudo yum makecache # YUM의 경우
sudo dnf makecache # DNF의 경우
```
수동으로 종속성 설치: 필요한 종속성을 알고 있다면 명시적으로 설치해 보세요:
```
sudo yum install another-package # YUM의 경우
sudo dnf install another-package # DNF의 경우
```

정리 도구를 주의해서 사용: 이러한 유틸리티는 중복되거나 오래된 패키지를 식별하는 데 도움이 될 수 있습니다.

sudo yum install yum-utils
sudo package-cleanup --cleandupes # 중복 패키지 정리
sudo package-cleanup --orphans # 고아 패키지 제거

sudo dnf install dnf-plugins-core
sudo dnf clean all

롤백 계획이 없는 한 rpm -e --nodeps 사용을 피하세요: 종속 패키지를 설치된 상태로 두면서 패키지를 제거할 수 있으며, 이는 명령을 만족시킬 수 있지만 시스템을 손상시킬 수 있습니다.

2. 저장소 구성 문제

YUM/DNF 저장소 문제로 인해 패키지를 찾거나 설치하지 못할 수 있습니다.

문제 해결 단계:

저장소 파일 확인: 저장소 정의는 일반적으로 /etc/yum.repos.d/에 있습니다. 이러한 .repo 파일에서 다음을 확인하세요:
- 올바른 baseurl 또는 mirrorlist 항목.
- 활성화된 저장소 (enabled=1).
- GPG 키 확인 문제 (gpgcheck=1로 표시되는 경우가 많음).
네트워크 액세스 확인: APT와 유사하게 시스템이 저장소 서버에 연결할 수 있는지 확인하세요.
```
ping <저장소-서버-주소>
```
GPG 키 확인: GPG 키 관련 오류가 표시되면 저장소의 공개 키를 가져오거나 다시 가져와야 할 수 있습니다.
```
# 키 가져오기 예
sudo rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-저장소
```
프로덕션 시스템에서는 gpgcheck=0을 설정하지 마세요. 이는 수리 작업을 공급망 위험으로 바꿉니다.
캐시 정리: 손상된 캐시는 문제를 일으킬 수 있습니다:
```
sudo yum clean all
sudo dnf clean all
```
그런 다음 메타데이터를 새로 고칩니다:
```
sudo yum makecache
sudo dnf makecache
```

3. 불완전한 트랜잭션 오류

이러한 오류는 패키지 설치, 업데이트 또는 제거 프로세스가 중단될 때 발생합니다.

문제 해결 단계:

트랜잭션 다시 실행: 종종 명령을 다시 실행하는 것만으로도(yum update, dnf install 등) 일시적인 결함이 해결될 수 있습니다.
캐시 정리: 위와 같이 캐시를 지우면 도움이 될 수 있습니다:
```
sudo yum clean all
sudo dnf clean all
```
보류된 패키지 확인: YUM/DNF에서는 APT보다 덜 일반적이지만 일부 구성에서는 패키지 업데이트를 방지할 수 있습니다. 이는 일반적으로 직접적인 'hold' 명령보다는 플러그인 구성에 의해 관리됩니다.
로그 확인: 자세한 오류 메시지는 /var/log/yum.log (YUM의 경우) 또는 /var/log/dnf.log (DNF의 경우)를 확인하세요.

잠금 및 중단된 패키지 프로세스

잠금 오류는 실제로 종속성 오류가 아닙니다. 일반적으로 다른 패키지 프로세스가 실행 중이거나 정리 없이 종료되었음을 의미합니다.

Debian 또는 Ubuntu에서는 /var/lib/dpkg/lock-frontend 또는 /var/lib/apt/lists/lock에 대한 메시지가 표시될 수 있습니다. Red Hat 계열 시스템에서는 RPM 데이터베이스 잠금을 보유한 다른 dnf 또는 yum 프로세스가 표시될 수 있습니다.

먼저 활성 프로세스를 확인하세요:

ps aux | grep -E 'apt|dpkg|dnf|yum|rpm' | grep -v grep

무인 업그레이드 또는 cloud-init가 실행 중인 경우 기다리세요. 실제 패키지 트랜잭션을 종료하면 패키지가 반쯤 구성된 상태로 남을 수 있습니다. 프로세스가 사라지고 오래된 잠금만 남았다고 확신하는 경우 일반 도구를 사용하여 패키지 데이터베이스를 복구하세요:

sudo dpkg --configure -a
sudo apt --fix-broken install

RPM 기반 시스템의 경우:

sudo dnf clean all
sudo rpm --rebuilddb

rpm --rebuilddb는 모든 DNF 문제에 대한 첫 번째 대응이 아닙니다. 저장소 URL이 잘못된 경우가 아니라 RPM 데이터베이스 자체가 손상된 것으로 보일 때 사용하세요.

타사 저장소의 버전 충돌

많은 심각한 패키지 오류는 혼합된 저장소(공급업체 저장소, EPEL, 언어 런타임 저장소, Kubernetes 저장소 또는 오래된 내부 미러)에서 비롯됩니다. 패키지 관리자는 지시받은 대로 정확히 수행하고 있을 수 있지만 사용 가능한 버전이 서로를 만족시킬 수 없습니다.

APT 시스템에서 정책을 검사하세요:

apt-cache policy <패키지-이름>
apt-cache madison <패키지-이름>

DNF 시스템에서:

dnf repoquery --show-duplicates <패키지-이름>
dnf repolist --enabled

하나의 타사 저장소가 문제라면 일시적으로 비활성화하고 트랜잭션을 다시 시도하세요:

sudo dnf --disablerepo='저장소-이름' update

APT의 경우 /etc/apt/sources.list.d/에서 의심스러운 항목을 주석 처리하고 sudo apt update를 실행한 후 다시 테스트하세요. 시스템을 미스터리 상태로 두지 말고 어떤 저장소가 비활성화되었는지와 그 이유를 문서화하세요.

릴리스 업그레이드 또는 주요 업데이트 실패 시

주요 업그레이드는 일반 패키지 설치보다 더 많은 주의가 필요합니다. 다시 시도하기 전에 시스템이 릴리스 사이에 있는지, 이전 저장소가 여전히 활성화되어 있는지, 구성 프롬프트가 중단되었는지 확인하세요.

Debian 또는 Ubuntu에서 릴리스 파일과 보류된 패키지를 확인하세요:

cat /etc/os-release
apt-mark showhold
sudo dpkg --audit

DNF 기반 시스템에서 활성화된 저장소와 배포판 동기화 동작을 확인하세요:

cat /etc/os-release
dnf repolist --enabled
sudo dnf distro-sync

distro-sync는 활성화된 저장소와 일치하도록 패키지를 다운그레이드하거나 교체할 수 있으므로 수락하기 전에 제안된 트랜잭션을 읽으세요. 중요한 시스템에서는 먼저 스냅샷을 찍거나 백업하세요. 패키지 관리자는 종속성 계산에 능숙하지만 비즈니스가 의존하는 로컬 구성 파일, 커널 모듈 또는 공급업체 에이전트를 알 수 없습니다.

일반적인 문제 해결 팁

패키지 관리자에 관계없이 몇 가지 일반적인 방법이 시간과 골치 아픈 일을 줄여줄 수 있습니다:

오류 메시지를 주의 깊게 읽으세요: apt 또는 yum/dnf의 출력에는 종종 문제에 대한 특정 단서가 포함되어 있습니다.
시스템 로그 확인: APT의 경우 /var/log/apt/history.log 및 /var/log/apt/term.log, YUM/DNF의 경우 /var/log/yum.log 또는 /var/log/dnf.log에서 자세한 트랜잭션 기록 및 오류 정보를 제공할 수 있습니다.
정기적으로 업데이트: 시스템과 패키지 목록을 최신 상태로 유지하여 오래된 종속성이나 저장소 문제가 발생할 가능성을 최소화하세요.
sudo 사용: 항상 슈퍼유저 권한으로 패키지 관리 명령을 실행하세요.
중요 데이터 백업: 주요 시스템 업데이트나 설치를 수행하기 전에 중요한 데이터를 백업하세요. 이는 심각한 문제가 발생할 경우 안전망 역할을 합니다.
문제 격리: 여러 패키지가 실패하면 문제를 일으키는 특정 패키지를 식별하기 위해 하나씩 업데이트하거나 설치해 보세요.
yes를 입력하기 전에 제안된 트랜잭션을 읽으세요: 제거는 중요합니다. 패키지 관리자가 데이터베이스 서버, 커널 패키지, SSH 서버 또는 핵심 런타임을 제거하려는 경우 중단하고 이유를 이해하세요.
강제 플래그보다 저장소 수정을 선호하세요: 대부분의 패키지 오류는 메타데이터, 저장소 또는 종속성 상태에서 비롯됩니다. 강제 플래그는 증상을 숨기면서 시스템을 유지 관리하기 어렵게 만들 수 있습니다.

가장 안전한 문제 해결 순서는 일관됩니다: 실행 중인 다른 패키지 프로세스 확인, 메타데이터 새로 고침, 중단된 트랜잭션 복구, 저장소 검사, 그런 다음 종속성 충돌 해결. 강제 제거 및 서명 우회는 영향 범위를 이해하고 롤백 경로가 있는 예외적인 경우에만 사용하세요.