<div id="readability-page-1" class="page"><div>
<article>
<header>


</header>
<nav id="table-of-contents">
<ul>
<li><a href="#alpine-%EB%A6%AC%EB%88%85%EC%8A%A4-%EC%86%8C%EA%B0%9C-%EB%B0%8F-apk-%ED%8C%A8%ED%82%A4%EC%A7%80-%EB%A7%A4%EB%8B%88%EC%A0%80-%EA%B0%9C%EC%9A%94">Alpine 리눅스 소개 및 APK 패키지 매니저 개요</a></li>
<li><a href="#docker%EC%97%90%EC%84%9C-alpine-%EB%A6%AC%EB%88%85%EC%8A%A4-%EC%82%AC%EC%9A%A9%ED%95%98%EB%8A%94-%EB%B0%A9%EB%B2%95">Docker에서 Alpine 리눅스 사용하는 방법</a></li>
<li>
<a href="#apk-%ED%8C%A8%ED%82%A4%EC%A7%80-%EB%A7%A4%EB%8B%88%EC%A0%80-%EC%84%A4%EC%B9%98-%EB%B0%8F-%EC%84%A4%EC%A0%95-%EB%B0%A9%EB%B2%95">APK 패키지 매니저 설치 및 설정 방법</a>
<ul>
<li><a href="#apk-%EB%A6%AC%ED%8F%AC%EC%A7%80%ED%84%B0%EB%A6%AC-%EC%84%A4%EC%A0%95">APK 리포지터리 설정</a></li>
</ul>
</li>
<li>
<a href="#apk%EB%A5%BC-%EC%82%AC%EC%9A%A9%ED%95%9C-%ED%8C%A8%ED%82%A4%EC%A7%80-%EA%B2%80%EC%83%89-%EB%B0%8F-%EC%84%A4%EC%B9%98">APK를 사용한 패키지 검색 및 설치</a>
<ul>
<li><a href="#apk-search-%ED%8C%A8%ED%82%A4%EC%A7%80-%EA%B2%80%EC%83%89">apk search: 패키지 검색</a></li>
<li><a href="#apk-add-%ED%8C%A8%ED%82%A4%EC%A7%80-%EC%84%A4%EC%B9%98">apk add: 패키지 설치</a></li>
<li><a href="#apk-upgrade-%ED%8C%A8%ED%82%A4%EC%A7%80-%EC%97%85%EA%B7%B8%EB%A0%88%EC%9D%B4%EB%93%9C">apk upgrade: 패키지 업그레이드</a></li>
<li><a href="#apk-del-%ED%8C%A8%ED%82%A4%EC%A7%80-%EC%82%AD%EC%A0%9C">apk del: 패키지 삭제</a></li>
</ul>
</li>
<li><a href="#apk-%EC%82%AC%EC%9A%A9-%ED%8C%81-%EB%B0%8F-%ED%8A%B8%EB%9F%AC%EB%B8%94%EC%8A%88%ED%8C%85-%EA%B0%80%EC%9D%B4%EB%93%9C">APK 사용 팁 및 트러블슈팅 가이드</a></li>
<li><a href="#%EB%A7%88%EC%B9%98%EB%A9%B0">마치며</a></li>
</ul>
</nav>
<h2 id="alpine-리눅스-소개-및-apk-패키지-매니저-개요">Alpine 리눅스 소개 및 APK 패키지 매니저 개요<a href="#table-of-contents">#</a>
</h2>
<p>Alpine 리눅스는 경량화된 리눅스 배포판으로, 도커 컨테이너 환경에서 자주 사용됩니다.</p>
<ul>
<li><a href="https://alpinelinux.org/">Alpine Linux 공식 웹사이트</a></li>
</ul>
<p>Alpine 리눅스는 보안, 경량화, 성능을 중시하며, 패키지 관리 시스템인 APK(Alpine Package Keeper)를 통해 리눅스 패키지를 손쉽게 설치하고 관리할 수 있습니다. APK는 간단하고 효율적인 패키지 관리 도구로, 설치된 패키지의 버전 관리, 의존성 해결, 패키지 검색 등의 작업을 처리할 수 있습니다.</p>
<p>이 글에서는 Alpine 리눅스에서 APK 패키지 매니저를 사용하는 방법에 대해 알아보겠습니다. 기본적인 명령어 사용법부터, 패키지 설치 및 삭제, 업데이트, 팁 및 트러블슈팅 방법까지 다룹니다.</p>
<h2 id="docker에서-alpine-리눅스-사용하는-방법">Docker에서 Alpine 리눅스 사용하는 방법<a href="#table-of-contents">#</a>
</h2>
<p>Alpine 리눅스를 도커에서만 사용할 수 있는 건 아닙니다만, 이미지 경량화나 가볍게 리눅스 환경을 테스트하기 위한 용도로 도커를 통해서도 자주 사용됩니다. 다음 명령어로 간단히 Alpine 리눅스 환경을 사용해볼 수 있습니다.</p>
<pre><code>$ docker run -it alpine:latest sh
/ #</code></pre>
<p>이 글은 도커의 공식 alpine 리눅스 상에서 테스트를 하고 작성했습니다.</p>
<ul>
<li><a href="https://hub.docker.com/_/alpine">alpine - Official Image | Docker Hub</a></li>
</ul>
<p>Docker 사용법에 대한 더 자세한 정보는 다음 글을 참고해주세요.</p>
<ul>
<li><a href="https://www.lainyzine.com/ko/article/summary-of-how-to-use-docker/">Docker 사용법 총 정리</a></li>
</ul>
<div>
<p>
Alpine 리눅스 배포판과 busybox
</p>
<div>

<p>Alpine 리눅스와 함께 busybox도 도커 이미지 경량화에 많이 사용되곤 합니다. 하지만 busybox는 리눅스 배포판이 아니라, 리눅스에서 사용할 수 있는 명령어 모음(툴박스)입니다. Alpine 리눅스에서도 기본적으로 busybox를 사용해 다양한 명령어들을 제공하고 있습니다. Alpine 리눅스는 완전한 리눅스 환경을 제공할 뿐만 아니라 APK와 같은 패키지 관리자도 사용할 수 있어서, 배포 환경 구성에 더 큰 장점이 있습니다.</p>
<ul>
<li><a href="https://www.lainyzine.com/ko/article/busybox/">BusyBox(비지박스) 소개와 사용법</a></li>
</ul>

</div>
</div>
<h2 id="apk-패키지-매니저-설치-및-설정-방법">APK 패키지 매니저 설치 및 설정 방법<a href="#table-of-contents">#</a>
</h2>
<p>Alpine 리눅스를 설치하면 기본적으로 APK 패키지 매니저가 함께 설치되어 있습니다. 별도로 APK를 설치할 필요는 없습니다. Alpine 리눅스 환경에서 <code>apk</code>를 실행해봅니다.</p>
<pre><code># apk
apk-tools 2.14.6, compiled for aarch64.

usage: apk [&lt;OPTIONS&gt;...] COMMAND [&lt;ARGUMENTS&gt;...]
...</code></pre>
<p>또한 패키지는, 시스템에 기본적으로 포함된 리포지터리 설정을 사용해서 다운로드 받을 수 있습니다. APK 리포지터리를 관리하거나 추가적인 리포지터리를 설정하고자 할 때는 <code>/etc/apk/repositories</code> 파일을 수정해야 합니다.</p>
<h3 id="apk-리포지터리-설정">APK 리포지터리 설정<a href="#table-of-contents">#</a>
</h3>


<p>Alpine 리눅스에서 apk 명령어로 패키지를 설치하려면 패키지 저장소(Repository)가 설정되어있어야합니다. apk 명령어는 <code>/etc/apk/repositories</code> 파일에 설정된 리포지터리를 통해 패키지를 다운로드합니다. Alpine Linux 3.21.0 버전에서 이 파일을 출력하면 다음과 같습니다.</p>
<pre><code>$ cat /etc/apk/repositories
https://dl-cdn.alpinelinux.org/alpine/v3.21/main
https://dl-cdn.alpinelinux.org/alpine/v3.21/community</code></pre>
<p><code>vi</code>와 같은 편집기를 사용해 이 파일을 편집하면 추가적인 리포지터리나 미러 서버를 설정할 수 있습니다.</p>
<h2 id="apk를-사용한-패키지-검색-및-설치">APK를 사용한 패키지 검색 및 설치<a href="#table-of-contents">#</a>
</h2>
<p>APK 패키지 매니저는 서브 커맨드로 패키지 검색, 설치 및 의존성 관리를 처리할 수 있습니다. 기본적인 패키지 관리 명령어는 다음과 같습니다.</p>
<h3 id="apk-search-패키지-검색">apk search: 패키지 검색<a href="#table-of-contents">#</a>
</h3>
<p>먼저 apk search 명령어로 설치할 수 있는 패키지를 검색할 수 있습니다. 예를 들어 curl과 관련된 패키지를 검색하고 싶다면 아래와 같이 명령어를 입력합니다.</p>
<pre><code>$ apk search curl
asterisk-curl-20.11.0-r0
collectd-curl-5.12.0-r21
curl-8.11.1-r0
curl-dbg-8.11.1-r0
curl-dev-8.11.1-r0
curl-doc-8.11.1-r0
...</code></pre>
<p>이 명령어는 패키지 이름에 <code>curl</code>이 들어간 모든 패키지 목록을 출력합니다. 출력된 목록에서 원하는 패키지를 선택하여 설치할 수 있습니다.</p>
<h3 id="apk-add-패키지-설치">apk add: 패키지 설치<a href="#table-of-contents">#</a>
</h3>
<p>패키지를 설치할 때는 apk add 명령어를 사용합니다. <code>apk search</code>에서 검색 결과가 <code>curl-8.11.1-r0</code>라면 버전명을 제외한 <code>curl</code> 패키지 이름으로 설치할 수 있습니다. 따라서 curl 패키지를 설치하려면 다음과 같은 명령어를 입력합니다. 루트 권한이 필요한 경우 <code>sudo</code>를 앞에 붙여줍니다.</p>
<pre><code>$ apk add curl
fetch https://dl-cdn.alpinelinux.org/alpine/v3.21/main/aarch64/APKINDEX.tar.gz
fetch https://dl-cdn.alpinelinux.org/alpine/v3.21/community/aarch64/APKINDEX.tar.gz
(1/9) Installing brotli-libs (1.1.0-r2)
(2/9) Installing c-ares (1.34.3-r0)
(3/9) Installing libunistring (1.2-r0)
(4/9) Installing libidn2 (2.3.7-r0)
(5/9) Installing nghttp2-libs (1.64.0-r0)
(6/9) Installing libpsl (0.21.5-r3)
(7/9) Installing zstd-libs (1.5.6-r1)
(8/9) Installing libcurl (8.11.1-r0)
(9/9) Installing curl (8.11.1-r0)
Executing busybox-1.37.0-r8.trigger
OK: 12 MiB in 24 packages</code></pre>
<p>이 명령어는 curl 패키지를 다운로드하고 설치합니다. 의존성 패키지가 있을 경우, 자동으로 함께 설치됩니다.</p>
<h3 id="apk-upgrade-패키지-업그레이드">apk upgrade: 패키지 업그레이드<a href="#table-of-contents">#</a>
</h3>


<p>패키지 업그레이드는 패키지 관리에서 중요한 작업 중 하나입니다. 이를 통해 시스템의 보안을 유지하고, 최신 버전의 패키지를 사용할 수 있습니다. APK에서는 <code>apk upgrade</code>를 사용해 패키지를 최신 버전으로 업그레이드할 수 있습니다. 이 명령어는 크게 두 가지 방법으로 사용됩니다.</p>
<p>먼저 인자 없이 <code>apk upgrade</code>를 실행하면, 시스템의 모든 패키지를 최신 버전으로 업그레이드합니다.</p>
<pre><code>$ apk upgrade</code></pre>
<p>이 명령어는 모든 시스템 패키지를 최신 상태로 유지하는 데 유용합니다.</p>
<p>다음으로 특정 패키지만 업데이트하려면 패키지 이름을 지정하여 업데이트할 수 있습니다. 예를 들어, curl 패키지만 업데이트하려면 다음과 같이 명령어를 입력합니다.</p>
<pre><code>$ apk upgrade curl</code></pre>
<p>이 명령어는 curl 패키지만 업그레이드 가능한지 확인하고, 가능한 경우 업그레이드를 진행합니다.</p>
<h3 id="apk-del-패키지-삭제">apk del: 패키지 삭제<a href="#table-of-contents">#</a>
</h3>
<p>불필요한 패키지를 삭제하려면 apk del 명령어를 사용합니다. 예를 들어, curl을 삭제하려면 다음과 같은 명령어를 입력합니다.</p>
<pre><code>sudo apk del curl</code></pre>
<p>이 명령어는 curl 패키지를 삭제하며, 해당 패키지와 관련된 의존성 패키지도 삭제됩니다. 여기까지 apk 명령어로 패키지를 관리하기 위한 주요 명령어들을 알아보았습니다.</p>
<h2 id="apk-사용-팁-및-트러블슈팅-가이드">APK 사용 팁 및 트러블슈팅 가이드<a href="#table-of-contents">#</a>
</h2>
<p>지금까지 살펴본 명령어들로도 APK를 충분히 잘 사용할 수 있습니다만, 알아두면 도움이 되는 다른 명령어들도 살펴보도록 하겠습니다.</p>
<p>APK는 설치한 패키지를 다운로드하고 캐시로 저장합니다. 이 캐시가 쌓이면 디스크 공간을 차지할 수 있습니다. 이를 관리하려면 apk cache 명령어를 사용하여 캐시를 정리할 수 있습니다. 이를 통해 사용하지 않는 캐시 파일을 삭제하여 디스크 공간을 절약할 수 있습니다.</p>
<pre><code>$ apk cache clean</code></pre>
<p>패키지 설치 중 의존성 문제가 발생할 수 있습니다. 이 경우, apk fix 명령어를 사용하여 손상된 패키지를 복구하거나 누락된 의존성을 자동으로 해결할 수 있습니다.</p>
<pre><code>$ apk fix</code></pre>
<p>특정 버전의 패키지를 다운로드하고 싶다면 <code>apk add</code>를 사용할 때 <code>=</code> 연산자를 사용합니다. 예를 들어 정확히 <code>curl-8.11.1-r0</code>를 설치하고 싶다면 다음과 같이 지정합니다.</p>
<pre><code>$ apk add curl=8.11.1-r0</code></pre>
<p>여기서 지정가능한 버전은, apk 저장소 설정에 있는 저장소에 존재하는 버전입니다. 먼저 <code>apk search</code> 명령어를 사용하는 걸 추천합니다.</p>
<h2 id="마치며">마치며<a href="#table-of-contents">#</a>
</h2>
<p>Alpine 리눅스의 APK 패키지 매니저는 간단하면서도 강력한 도구로, 패키지 관리 및 시스템 유지 관리에 많은 도움을 줍니다. 이 글에서 설명한 기본적인 명령어와 팁을 활용하면, APK 패키지 매니저를 통해 손쉽게 시스템을 관리하고 최적화할 수 있습니다. 또한, 패키지 설치, 업데이트, 삭제 과정에서 발생할 수 있는 문제를 해결하는 데 유용한 방법들을 알아보았습니다. 이를 참고하여 보다 효율적으로 Alpine 리눅스를 활용하시기 바랍니다.</p>



</article>
</div></div>

LZ: 프로그래머 가이드

LainyZine

이 글에서는 Alpine 리눅스의 패키지 매니저 APK 사용법을 상세히 소개합니다. 패키지 검색부터 패키지 설치, 삭제, 업그레이드 등 다양한 활용법을 알아봅니다.
전체 기사는 이 링크에서 읽을 수 있습니다.

Alpine 리눅스 APK 패키지 매니저 사용법

댓글