<div id="readability-page-1" class="page"><div>
<article>
<header>
<h2>
  <a href="https://www.lainyzine.com/ko/article/docker-tutorial-3/">
    개발자를 위한 도커 가이드 - 컨테이너와 포터블 앱
  </a>
</h2>

</header>
<nav>
<ul>
<li><a href="#docker%EB%A1%9C-ffmpeg%EC%9D%84-%ED%8F%AC%ED%84%B0%EB%B8%94-%EC%95%B1%EC%9C%BC%EB%A1%9C-%ED%99%9C%EC%9A%A9%ED%95%98%EA%B8%B0">Docker로 FFmpeg을 포터블 앱으로 활용하기</a></li>
<li><a href="#%EB%8F%84%EC%BB%A4-%EB%B3%BC%EB%A5%A8-%EA%B8%B0%EB%8A%A5%EC%9C%BC%EB%A1%9C-%ED%98%B8%EC%8A%A4%ED%8A%B8%EC%99%80-%EC%BB%A8%ED%85%8C%EC%9D%B4%EB%84%88%EC%9D%98-%EB%94%94%EB%A0%89%ED%84%B0%EB%A6%AC-%EC%97%B0%EA%B2%B0%ED%95%98%EA%B8%B0">도커 볼륨 기능으로 호스트와 컨테이너의 디렉터리 연결하기</a></li>
<li><a href="#%EC%97%AC%EA%B8%B0%EA%B9%8C%EC%A7%80-%EB%B0%B0%EC%9A%B4-%EB%82%B4%EC%9A%A9-%EB%B3%B5%EC%8A%B5">여기까지 배운 내용 복습</a></li>
</ul>
</nav>
<p><a href="https://www.lainyzine.com/ko/article/docker-tutorial/">개발자를 위한 도커 가이드</a> 이전 글들에서는 도커의 가장 핵심 개념인 컨테이너와 이미지에 대해서 알아보았습니다. 여기서부터는 실전입니다. 설치하기 아무리 어려운 앱도, 미리 준비된 이미지 하나면 포터블 앱으로 활용할 수 있습니다. 이 글에서는 도커 컨테이너를 포터블 앱으로 활용하는 방법에 대해서 알아보고, 호스트와 컨테이너 사이에 파일을 공유할 수 있는 볼륨 기능도 사용해봅니다.</p>
<ul>
<li><a href="https://www.lainyzine.com/ko/article/docker-tutorial-1/">개발자를 위한 도커 가이드 1 - 컨테이너 실행</a></li>
<li><a href="https://www.lainyzine.com/ko/article/docker-tutorial-2/">개발자를 위한 도커 가이드 2 - 이미지와 도커 허브</a></li>
<li><a href="https://www.lainyzine.com/ko/article/docker-tutorial-3/"><strong>개발자를 위한 도커 가이드 3 - 컨테이너와 포터블 앱</strong></a></li>
<li><a href="https://www.lainyzine.com/ko/article/docker-tutorial-4/">개발자를 위한 도커 가이드 4 - 서버 컨테이너</a></li>
</ul>
<h2 id="docker로-ffmpeg을-포터블-앱으로-활용하기">Docker로 FFmpeg을 포터블 앱으로 활용하기</h2>
<p>지금까지 Docker의 기초에 대해서 알아보았습니다. 앞서 Docker 이미지에 대해서 설명하면서 이식성(Portability)이 높다고 이야기했습니다. Docker는 Docker 이미지와 Docker Hub의 조합으로 아주 높은 이식성을 자랑합니다. Docker 이전에도 리눅스 컨테이너 도구들이 있었습니다만, Docker가 가장 성공한 이유가 바로 뛰어난 이식성 때문이기도 합니다.</p>
<p>Docker의 이식성을 활용하면, Docker를 리눅스 포터블 앱으로 활용할 수도 있습니다. 즉, 시스템에 어떤 프로그램을 설치하지 않고도 리눅스 환경 그대로 프로그램을 실행할 수 있다는 의미입니다. 여기서는 커맨드라인에서 영상을 편집할 수 있는 FFmpeg을 Docker로 실행해보겠습니다.</p>
<ul>
<li>관련 글: <a href="https://www.lainyzine.com/ko/article/how-to-install-ffmpeg-on-windows-10/">Windosw에서 FFmpeg 설치하는 방법</a>
</li>
</ul>
<p>FFmpeg 설치가 어려운 편은 아닙니다만, 프로그램을 설치하면 어쨌건 시스템에 다양한 파일들이 설치됩니다. 또한 FFmpeg은 기본적으로 커맨드라인에서 동작하기 때문에 PATH 개념을 알고 위치를 잡아줘야 프로그램을 사용할 수 있습니다. 또 다른 문제는 윈도우나 맥OS에서는 리눅스 버전과 동작이 미묘하게 다를 수도 있어서, 대규모 파일 변환 같은 작업을 할 때 문제가 될 수도 있습니다.</p>
<p>Docker를 사용하면 프로그램을 설치하지 않고도 <code>ffmpeg</code> 명령어만 사용할 수 있습니다. Docker Hub에서 <code>ffmpeg</code>을 검색해봅니다.</p>
<ul>
<li><a href="https://hub.docker.com/search?q=ffmpeg">Explore Docker’s Container Image Repository | Docker Hub</a></li>
</ul>
<figure>
<img src="https://www.lainyzine.com/ko/article/docker-tutorial-3/assets/ffmpeg-image.png" alt="Docker Hub에서 FFmpeg 이미지를 검색해봅니다">
</figure>
<p>아쉽지만 FFmpeg의 Docker 공식 이미지(Docker Official Image)는 제공되지 않습니다. 여기서는 linuxserevr.io의 ffmpeg 이미지를 사용하겠습니다. 이 이미지는 비공식 이미지이지만, Sponsored OSS라고 표기되어있습니다. 왼쪽 사이드바에서 확인할 수 있듯이 Trusted Conetnt(믿을 수 있는 이미지) 카테고리 중 하나입니다. Sponsored OSS는 오픈소스 프로젝트로 관리되고 있으며, Docker에서 후원을 받고 있는 이미지입니다. 비공식 이미지를 사용할 때는 Trusted Content 중 하나를 사용해주세요.</p>
<div>
<p>
비공식 이미지는 안전한가요?
</p>
<div>

<p>Docker를 사용하다보면 다양한 사용자들이 만든 이미지를 접하게 됩니다. 하지만 비공식 이미지가 안전하다는 걸 누구도 보장해주지 않습니다. 공식 이미지를 사용하는 게 가장 좋고, 공식 이미지가 제공되지 않는다면 Trusted Content 필터로 검색해서 사용하는 걸 추천합니다.</p>
<p>그 이외의 이미지를 사용하는 경우, 이미지를 제공하는 사람이나 기관이 믿을만한지, Dockerfile의 내용이 공개되어 있는지, Dockerfile 내용에는 문제가 없는지 직접 검증해야합니다. Dockerfile을 구할 수 있다면, 이미지를 가져다 쓰는 대신에 내용을 확인하고 직접 빌드해서 사용하는 게 더 안전합니다. 또한 이미지를 믿을만 하더라도, 이미지가 꾸준히 관리되고 있지 않다면 다양한 취약점에 노출 될 수 있습니다. 아직 Dockerfile이나 이미지 빌드를 다루지 않았습니다만, 이 주제들까지 이 글에서 다 소개하기는 어렵습니다. 지금은 공식 이미지와 Trusted Content로 제공되는 이미지만 사용하는 것을 강력히 추천합니다.</p>
<p>아래 글에서는 실제로 Docker Hub에 공개되어 있었던 악성 도커 이미지 사례를 소개하고 있습니다. 비공식 이미지를 사용할 때는 항상 주의가 필요합니다.</p>
<ul>
<li><a href="https://www.ahnlab.com/kr/site/securityinfo/secunews/secuNewsView.do?seq=30533">악성 도커 이미지 피하는 3가지 방법 - AhnLab | 보안 이슈</a></li>
</ul>

</div>
</div>
<p>Docker Hub에 공개된 이미지이므로 <code>docker pull</code> 명령어로 풀 받을 수 있습니다.</p>
<pre><code>$ docker pull linuxserver/ffmpeg:latest</code></pre>
<p><code>docker images</code>로 이미지를 확인해봅니다. 4일 전에 만들어졌고, 용량은 401MB인 것을 알 수 있습니다.</p>
<pre><code>$ docker images
REPOSITORY               TAG                       IMAGE ID       CREATED         SIZE
linuxserver/ffmpeg       latest                    745b40c33acb   4 days ago      401MB</code></pre>
<p>이 이미지에는 FFmpeg이 이미 설치되어있습니다. 예를 들어 <code>debian:12</code>나 <code>rockylinux:9</code> 이미지에는 <code>ffmpeg</code> 명령어가 없습니다. <code>ffmpeg</code> 명령어가 없기 때문에 컨테이너가 실행되지 못 하고 종료됩니다.</p>
<pre><code>$ docker run -it --rm debian:12 ffmpeg -version
docker: Error response from daemon: failed to create task for container: failed to create shim task: OCI runtime create failed: runc create failed: unable to start container process: exec: "ffmpeg": executable file not found in $PATH: unknown.

$ docker run -it --rm rockylinux:9 ffmpeg -version
docker: Error response from daemon: failed to create task for container: failed to create shim task: OCI runtime create failed: runc create failed: unable to start container process: exec: "ffmpeg": executable file not found in $PATH: unknown.</code></pre>
<p>하지만 <code>linuxserver/ffmpeg:latest</code> 이미지에서는 <code>ffmpeg</code> 명령어가 실행됩니다.</p>
<pre><code>$ docker run -it --rm linuxserver/ffmpeg:latest -version
ffmpeg version 6.0 Copyright (c) 2000-2023 the FFmpeg developers
built with gcc 11 (Ubuntu 11.3.0-1ubuntu1~22.04.1)
[...]</code></pre>
<p>FFmpeg 명령어를 설치하지 않고도, 윈도우에서도, 맥OS에서도, 리눅스 서버에서도 이 명령어 하나로 <code>ffmpeg</code> 명령어를 바로 사용할 수 있습니다.</p>
<p>조금 자세히 뜯어보면, 이미지 뒤에 바로 <code>-version</code> 옵션을 붙인 것을 알 수 있습니다. 도커 이미지에는 Entrypoint라는 설정값이 있습니다. 이 값이 지정되어있으면, 지정된 명령어가 실행됩니다. 마치 다음 명령어 자체가 <code>ffmpeg</code> 명령어처럼 동작합니다.</p>
<pre><code>docker run -it --rm linuxserver/ffmpeg:latest</code></pre>
<p>따라서 따로 <code>ffmpeg</code>을 붙여주지 않고 바로 <code>ffmpeg</code> 명령어의 옵션을 입력해도 정상적으로 동작합니다. 이 기능은 편리하지만, 특정 이미지에서 다른 명령어를 사용하고 싶을 때는 사용법이 헷갈릴 수 있습니다. 지금은 Entrypoint라는 걸 사용하고 있다 정도로만 알아주세요.</p>
<p>여기서는 FFmpeg을 사용하는 간단한 예제로 이미지 한 장을 영상 파일로 변환해보겠습니다. 먼저 작업 디렉터리를 만들고, 이미지 파일을 다운로드 받아보겠습니다. 여기서는 작업 디렉터리로 <code>~/docker/ffmpeg</code>을 사용하겠습니다.</p>
<pre><code>## Windows
$ mkdir $HOME\docker\ffmpeg
$ cd $HOME\docker\ffmpeg

## macOS / Linux
$ cd ~/docker/ffmpeg/
$ mkdir -P ~/docker/ffmpeg/</code></pre>
<p>이미지 파일 다운로드는 <code>wget</code>을 사용해도 되고, 직접 주소에서 다운로드해도 괜찮습니다. 작업 디렉터리에 저장해주세요.</p>
<pre><code>## Windows
$ wget https://www.lainyzine.com/ko/images/docker-logo.png -OutFile docker-logo.png

## macOS / Linux
$ wget https://www.lainyzine.com/ko/images/docker-logo.png</code></pre>
<p>작업 디렉터리에서 다음 내용을 그대로 복사해서 실행해주세요.</p>
<pre><code>## Windows
$ docker run -it --rm `
  -v ${pwd}:/data `
  linuxserver/ffmpeg:latest `
  -loop 1 -i /data/docker-logo.png -c:v libx264 -t 15 -pix_fmt yuv420p -vf scale=320:240 /data/docker-logo.mp4

## macOS / Linux
$ docker run -it --rm \
  -v $(pwd):/data \
  linuxserver/ffmpeg:latest \
  -loop 1 -i /data/docker-logo.png -c:v libx264 -t 15 -pix_fmt yuv420p -vf scale=320:240 /data/docker-logo.mp4</code></pre>
<p>작업 디렉터리를 열어보면, 이미지 파일이 15초 짜리 영상으로 변환된 것을 확인할 수 있습니다.</p>
<figure>
<img src="https://www.lainyzine.com/ko/article/docker-tutorial-3/assets/image%2016.png" alt="FFmpeg을 사용해 이미지를 영상으로 변환했습니다">
</figure>
<h2 id="도커-볼륨-기능으로-호스트와-컨테이너의-디렉터리-연결하기">도커 볼륨 기능으로 호스트와 컨테이너의 디렉터리 연결하기</h2>
<p>갑자기 명령어가 많이 복잡해졌습니다. 하나씩 뜯어지면 크게 달리진 건 없습니다. 먼저 이미지를 영상으로 변환하는 명령어는 다음 글에서 가져왔습니다.</p>
<ul>
<li><a href="https://stackoverflow.com/questions/25891342/creating-a-video-from-a-single-image-for-a-specific-duration-in-ffmpeg">Creating a video from a single image for a specific duration in ffmpeg - Stack Overflow</a></li>
</ul>
<p>다음 명령어로 <code>docker-logo.png</code> 이미지 파일을 <code>docker-logo.mp4</code> 영상 파일로 변환합니다. FFmpeg은 정말 많은 일을 할 수 있는 도구입니다. 여기서 <code>ffmpeg</code> 명령어를 이해하실 필요는 없습니다.</p>
<pre><code>$ ffmpeg -loop 1 -i docker-logo.png -c:v libx264 -t 15 -pix_fmt yuv420p -vf scale=320:240 docker-logo.mp4</code></pre>
<p>다음으로 Docker 명령어를 살펴봅니다. 아, 그 전에 윈도우(파워셸) 버전과 맥OS/리눅스 버전이 조금 다릅니다. 이는 커맨드라인에서 여러 줄에 걸쳐서 명령어를 입력하는 방식이 달라서 그렇습니다. 파워셸에서는 줄 맨 뒤에 역따옴표(백틱) 문자를 사용해 여러줄에 걸쳐 명령어를 입력할 수 있습니다. 이와 달리 맥OS나 리눅스에서는 <code>\</code>(역슬래시) 문자를 사용합니다. 역따옴표나 역슬래시 문자 뒤에 공백이 있으면 명령어가 잘못 해석될 수 있습니다.</p>
<p><code>ffmpeg</code> 옵션 앞까지 docker 명령어를 다시 한줄로 바꿔보면 다음과 같습니다.</p>
<pre><code>## Winodws
$ docker run -it --rm -v ${pwd}:/data linuxserver/ffmpeg:latest

## macOS / Linux
$ docker run -it --rm -v $(pwd):/data linuxserver/ffmpeg:latest</code></pre>
<p>처음 실행했던 명령어와 크게 다르지 않죠?</p>
<p>새로 추가된 옵션은 <code>-v</code> 볼륨 옵션입니다. Docker 컨테이너는 전용 작업 공간을 가지고 있으며, 기본적으로 호스트의 파일 시스템에 접근할 수 없습니다. 볼륨 옵션을 사용하면 호스트의 특정 디렉터리를 새로 실행하는 도커 컨테이너 작업 공간의 특정 위치에 마운트해줍니다.</p>
<pre><code>[호스트의 디렉터리]:[컨테이너 내부의 디렉터리]</code></pre>
<p>호스트의 디렉터리와 컨테이너 내부에서 사용할 디렉터리 경로는 <code>:</code>(콜론)으로 구분해줍니다. 이 예제에서 호스트 디렉터리로, 윈도우에서는 <code>${pwd}</code>, 맥OS와 리눅스에서는 <code>$(pwd)</code>를 사용합니다. 이는 셸에서 사용하는 특수한 구문으로, 괄호 안의 명령어를 실행한 결과값을 대신 입력해줍니다. 윈도우는 중괄호, 맥과 리눅스에서는 소괄호를 사용합니다. 즉, 현재 디렉터리를 전체 경로로 지정해줍니다. 볼륨 옵션에는 상대 경로를 입력할 수 없어서 이 방식을 사용하면 편리하게 작업할 수 있습니다.</p>
<ul>
<li><a href="https://www.lainyzine.com/ko/article/linux-pwd-command-print-current-working-directory/">리눅스 pwd 명령어 사용법(디렉터리 위치)</a></li>
</ul>
<figure>
<img src="https://www.lainyzine.com/ko/article/docker-tutorial-3/assets/image%2017.png" alt="Docker 볼륨 기능">
</figure>
<p>컨테이너 내부의 디렉터리는 <code>/data</code>를 지정해주었습니다. 즉, <code>docker</code> 명령어를 실행하는 디렉터리가 Docker 컨테이너 안에서는 <code>/data</code>로 연결됩니다. 그리고 Docker 컨테이너 안에서 <code>/data</code>에 파일을 생성하면 호스트의 디렉터리에 파일이 추가됩니다. 볼륨 기능을 통해 컨테이너로 파일을 전달하거나, 작업 결과를 호스트로 편리하게 가져올 수 있습니다.</p>
<p>볼륨 옵션에 따라서, <code>ffmpeg</code> 명령어를 조금 수정해줍니다. 파일 경로에 명시적으로 <code>/data/</code>를 붙여줍니다.</p>
<pre><code>ffmpeg -loop 1 -i /data/docker-logo.png -c:v libx264 -t 15 -pix_fmt yuv420p -vf scale=320:240 /data/docker-logo.mp4</code></pre>
<p>그리고 앞서 설명한대로 <code>linuxserver/ffmpeg:latest</code> 이미지에는 Entrypoint가 지정되어있기 때문에 <code>ffmpeg</code> 명령어를 붙이지 않아도 됩니다. 아니, 붙이지 않아야 합니다.</p>
<pre><code>-loop 1 -i /data/docker-logo.png -c:v libx264 -t 15 -pix_fmt yuv420p -vf scale=320:240 /data/docker-logo.mp4</code></pre>
<p>최종 완성된 명령어입니다. 이제 다시 <code>docker run</code> 명령어와 조합해봅니다.</p>
<pre><code>$ docker run -it --rm -v ${pwd}:/data linuxserver/ffmpeg:latest -loop 1 -i /data/docker-logo.png -c:v libx264 -t 15 -pix_fmt yuv420p -vf scale=320:240 /data/docker-logo.mp4</code></pre>
<p>한 줄로 실행해도 상관은 없습니다만, 너무 깁니다. 그래서 Docker 명령어가 길어지면 여러 줄로 작성하는 경우가 많습니다. 여러 줄로 나눠서, 최종 완성된 <code>docker run</code> 명령어는 다음과 같습니다.</p>
<pre><code>## Windows
$ docker run -it --rm `
  -v ${pwd}:/data `
  linuxserver/ffmpeg:latest `
  -loop 1 -i /data/docker-logo.png -c:v libx264 -t 15 -pix_fmt yuv420p -vf scale=320:240 /data/docker-logo.mp4

## macOS / Linux
$ docker run -it --rm \
  -v $(pwd):/data \
  linuxserver/ffmpeg:latest \
  -loop 1 -i /data/docker-logo.png -c:v libx264 -t 15 -pix_fmt yuv420p -vf scale=320:240 /data/docker-logo.mp4</code></pre>
<p>조금 복잡해보이지만, 뜯어보면 생각보다 어렵지는 않습니다. 그리고 꼭 직접 실행해보시기 바랍니다. Docker를 포터블 앱으로 활용하는 건 매우 강력합니다. Docker만 설치되어있다면, 이 명령어를 어디서든 실행할 수 있고, 같은 결과를 얻을 수 있습니다.</p>
<p>그 외에도 이미지 변환 프로그램인 ImageMagick이나 문서 변환 프로그램인 Pandoc도 Docker를 사용해 손쉽게 사용해볼 수 있습니다. 개발 환경을 구축하지 않고도 프로그래밍 언어 도커 이미지를 사용해 소스 코드를 실행하거나 컴파일하는 것도 가능합니다. Docker의 활용 가능성은 무궁무진합니다.</p>
<h2 id="여기까지-배운-내용-복습">여기까지 배운 내용 복습</h2>


<p>이 시리즈에서 배운 내용 중 가장 중요한 명령어가 바로 <code>docker run</code>입니다.</p>
<pre><code>$ docker run -it --rm rockylinux:9 bash</code></pre>
<p><code>rockylinux:9</code> 이미지로 <code>bash</code> 셸을 실행합니다. 여기서 <code>-it</code> 옵션은 셸을 실행하거나, 명령어 출력을 바로 보고 싶을 때 사용합니다. <code>--rm</code> 옵션은 컨테이너가 종료되면 바로 삭제합니다. 이 옵션들을 기본으로 <code>ffmpeg</code>를 실행하는 명령어를 만들어봅니다.</p>
<pre><code>$ docker run -it --rm \
  -v $(pwd):/data \
  linuxserver/ffmpeg:latest \
  -loop 1 -i /data/docker-logo.png -c:v libx264 -t 15 -pix_fmt yuv420p -vf scale=320:240 /data/docker-logo.mp4</code></pre>
<p>조금 명령어가 긴데 기억나시나요? <code>linuxserver/ffmpeg</code> 이미지를 사용해 FFmpeg을 설치하지 않고도 <code>ffmpeg</code> 명령어를 사용할 수 있습니다. 여기서 포인트는 <code>-v</code> 옵션입니다. 이 옵션으로 호스트의 디렉터리와 컨테이너 내부의 디렉터리를 연결할 수 있습니다.</p>
<figure>
<img src="https://www.lainyzine.com/ko/article/docker-tutorial-3/assets/image%2017.png" alt="도커 볼륨 기능">
</figure>
<p>아직은 명령어가 복잡해보일 수 있습니다만, 원리를 이해하고 있다면 금방 익숙해질 것입니다. 자, 이제 컨테이너가 가장 많이 활용되는 방식인 서버 컨테이너에 대해서 알아볼 차례입니다. 다음 글에서 이어집니다.</p>
<ul>
<li><a href="https://www.lainyzine.com/ko/article/docker-tutorial-1/">개발자를 위한 도커 가이드 1 - 컨테이너 실행</a></li>
<li><a href="https://www.lainyzine.com/ko/article/docker-tutorial-2/">개발자를 위한 도커 가이드 2 - 이미지와 도커 허브</a></li>
<li><a href="https://www.lainyzine.com/ko/article/docker-tutorial-3/">개발자를 위한 도커 가이드 3 - 컨테이너와 포터블 앱</a></li>
<li><a href="https://www.lainyzine.com/ko/article/docker-tutorial-4/"><strong>개발자를 위한 도커 가이드 4 - 서버 컨테이너</strong></a></li>
</ul>

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

LZ: 프로그래머 가이드

LainyZine

개발자를 위한 도커 가이드 3편에서는 컨테이너를 포터블 앱으로 활용하는 방법과 도커 볼륨 기능에 대해서 알아봅니다.
전체 기사는 이 링크에서 읽을 수 있습니다.

개발자를 위한 도커 가이드 - 컨테이너와 포터블 앱

댓글