Linux / 명령어 / apk - Alpine Linux 패키지 설치·제거와 저장소 갱신

apk는 Alpine Linux의 패키지 관리 명령입니다. 저장소 패키지 검색·추가·제거와 업그레이드에 쓰이며, Alpine의 설치 방식에 따라 변경사항 보존 절차가 달라질 수 있습니다.

apk 명령어란?

apk add는 패키지를 원하는 시스템 상태에 추가하고, apk del은 그 제약을 제거합니다. 원하는 패키지 목록은 /etc/apk/world에 기록됩니다. apk update는 저장소 인덱스를 새로 받고, apk upgrade는 설치된 패키지를 갱신합니다. 디스크리스 모드에서는 변경사항 영속화에 별도 절차가 필요할 수 있습니다.

기본 문법

apk [전역옵션] 명령 [패키지 ...]

설치된 구현과 옵션은 배포판에 따라 다를 수 있습니다. man apk으로 현재 시스템의 설명을 확인하세요.

사용 예제

패키지 검색

저장소에서 이름이 일치하는 후보를 찾습니다.

apk search nginx

패키지 설치

필요한 의존성을 확인하고 추가합니다.

sudo apk add nginx

저장소 정보 갱신과 업그레이드

두 동작의 차이를 확인하고 변경 목록을 검토합니다.

sudo apk update
sudo apk upgrade

설치 여부와 저장소 갱신 구별하기

apk info -e는 지정한 패키지가 설치되어 있는지 이름으로 확인합니다. Alpine 기본 환경에서 busybox가 설치된 경우 다음처럼 표시됩니다.

apk info -e busybox

예시 출력:

busybox

apk update는 저장소 색인을 갱신할 뿐 설치된 패키지 버전을 바꾸지 않습니다. 설치된 패키지를 실제로 업그레이드하려면 apk upgrade가 필요합니다. diskless 모드나 일회용 컨테이너에서는 패키지 변경이 재시작·재생성 뒤에도 남는지 운영 방식에 맞게 확인하세요.

주요 옵션과 형식

사용할 때 주의할 점

apk update만으로 설치된 패키지는 업그레이드되지 않습니다. apk del은 다른 패키지의 필요 여부에 따라 함께 제거되는 항목이 있을 수 있으므로 제안 목록을 확인하세요. 디스크리스·컨테이너 환경에서는 패키지 변경을 이미지나 구성 관리에 반영해야 재생성 후에도 유지됩니다.

자주 묻는 질문

apk add와 apk update는 무엇이 다른가요?

add는 원하는 패키지를 설치하고, update는 저장소 인덱스를 갱신합니다. 설치된 패키지의 버전 갱신은 upgrade입니다.

공식 문서

옵션의 정확한 동작과 구현별 차이는 apk 관련 공식 문서에서 확인할 수 있습니다.