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


</header>

<p>도커로 특정 이미지에서 Bash 셸을 사용하고 싶을 때, 다음과 같이 실패하는 경우가 있습니다.</p>
<pre><code>$ docker run -it busybox:latest bash
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: "bash": executable file not found in $PATH: unknown.
ERRO[0000] error waiting for container: context canceled</code></pre>
<p>에러 메시지가 조금 복잡한데요, 결론은 이미지에 지정한 명령어를 찾을 수 없기 때문에 발생하는 에러입니다. 이 글에서는 bash 셸을 실행할 수 없는 이유와 해결 방법에 대해서 소개합니다.</p>
<nav>
<ul>
<li><a href="#%EB%8F%84%EC%BB%A4-%EC%BB%A8%ED%85%8C%EC%9D%B4%EB%84%88%EC%97%90%EC%84%9C-bash-%EB%AA%85%EB%A0%B9%EC%96%B4%EB%A5%BC-%EC%8B%A4%ED%96%89%ED%95%98%EB%8A%94-%EB%B0%A9%EB%B2%95">도커 컨테이너에서 bash 명령어를 실행하는 방법</a></li>
<li><a href="#bash-%EB%AA%85%EB%A0%B9%EC%96%B4%EA%B0%80-%EC%97%86%EB%8A%94-%EC%9D%B4%EB%AF%B8%EC%A7%80%EB%93%A4-busybox-alpine-%EB%93%B1">bash 명령어가 없는 이미지들: busybox, alpine 등</a></li>
<li><a href="#bash%EB%A5%BC-%EC%A7%81%EC%A0%91-%EC%84%A4%EC%B9%98%ED%95%B4%EC%84%9C-%EC%82%AC%EC%9A%A9%ED%95%98%EA%B8%B0">bash를 직접 설치해서 사용하기</a></li>
<li><a href="#bash%EB%8F%84-sh%EB%8F%84-%EC%97%86%EB%8A%94-%EA%B2%BD%EC%9A%B0">bash도 sh도 없는 경우</a></li>
<li><a href="#%EC%B6%94%EC%B2%9C-%EB%AC%B8%EC%84%9C">추천 문서</a></li>
</ul>
</nav>
<h2 id="도커-컨테이너에서-bash-명령어를-실행하는-방법">도커 컨테이너에서 bash 명령어를 실행하는 방법</h2>
<p>도커에서는 컨테이너를 실행할 때, 실행할 명령어를 직접 지정할 수 있습니다. 이 명령어에 셸을 지정하면, 컨테이너의 메인 프로세스로 셸이 실행됩니다.</p>
<pre><code>$ docker run -it ubuntu:latest /bin/bash
root@00c743b41e4c:/#</code></pre>
<p>이 명령어를 실행하면, <code>ubuntu:latest</code> 이미지로 <code>/bin/bash</code> 명령어를 실행합니다. 여기서 <code>/bin/bash</code>는 <code>bash</code> 셸의 실행 경로 전체를 의미합니다.</p>
<p>비슷한 방법으로 <code>/bin/bash</code> 전체 경로를 지정하지 않아도 <code>bash</code>를 실행하는 게 가능합니다.</p>
<pre><code>$ docker run -it ubuntu:latest bash
root@fe53262caaad:/#</code></pre>
<p>이번에는 <code>bash</code> 명령어만 지정했을 뿐인데, 컨테이너에서 bash 셸이 실행되었습니다. 이 명령어는 어떤 원리로 실행될까요?</p>
<p>리눅스에서는 명령어를 찾을 때 PATH 환경변수에 의존합니다. 경로 없이 실행항 명령어는 PATH 환경변수의 <code>:</code> 문자로 구분된 우선적으로 탐색을 합니다. 이 경로들에 해당 명령어가 있으면 실행이 되고, 없으면 실패합니다. 이는 리눅스의 기본 동작입니다. 그럼 <code>ubuntu:latest</code>의 <code>$PATH</code> 환경변수를 출력해보겠습니다.</p>
<pre><code>$ docker run -it ubuntu:latest bash -c 'echo $PATH'
/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin</code></pre>
<p><code>/bin/bash</code> 명령어가 있는 <code>/bin</code> 경로가 있는 것을 확인할 수 있습니다. 즉, 전체 경로를 사용하지 않아도, <code>bash</code> 셸을 실행할 수 있습니다. 즉, 어떤 명령어를 실행할 때는, 전체 경로를 알고 있거나, $PATH 환경변수 안에 있어야합니다.</p>
<h2 id="bash-명령어가-없는-이미지들-busybox-alpine-등">bash 명령어가 없는 이미지들: busybox, alpine 등</h2>
<p>일반적인 리눅스 배포판 이미지들은 <code>bash</code> 셸을 포함하고 있으면, PATH 환경변수 값도 적절하게 설정되어있습니다. 하지만, busybox나 alpine과 같은 경량 이미지의 경우 bash 명령어가 아예 포함되어있지 않습니다.</p>
<pre><code>$ docker run -it alpine:latest bash
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: "bash": executable file not found in $PATH: unknown.
ERRO[0000] error waiting for container: context canceled</code></pre>
<p>이 때는 bash 대신에 sh을 실행하는 방법이 있습니다. sh은 Bash 셸보다 심플한 셸 프로그램입니다.</p>
<pre><code>$ docker run -it alpine:latest sh
/ #</code></pre>
<p>프롬프트가 약간 다르지만, 컨테이너에 셸이 실행된 것을 확인할 수 있습니다. 셸을 실행한 김에 <code>sh</code> 명령어의 위치와 <code>PATH</code> 환경변수도 확인해보겠습니다.</p>
<pre><code>/ # which sh
/bin/sh
/ # echo $PATH
/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin</code></pre>
<p>이를 통해서 <code>sh</code> 명령어가 <code>/bin/sh</code>에 있고, PATH 환경변수에 <code>/bin</code>이 잘 설정된 것을 확인할 수 있습니다.</p>
<p>그럼 bash 명령어는 정말로 없을까요? <code>find</code> 명령어 <code>bash</code>를 찾아보겠습니다.</p>
<pre><code>/ # find / -name bash
/ #</code></pre>
<p>검색 결과가 없는 것을 알 수 있습니다. <code>which</code>와 <code>$PATH</code> 환경변수, 그리고, <code>find</code>는 명령어 문제를 해결하는 가장 중요한 명령어들이니 한 번씩 실행하면서 결과를 직접 확인해보시기 바랍니다.</p>
<h2 id="bash를-직접-설치해서-사용하기">bash를 직접 설치해서 사용하기</h2>
<p>일단 sh이 있으면 셸 작업을 할 수 있습니다. 필요한 경우 <code>bash</code> 바이너리를 구하거나, 패키지 매니저로 직접 설치해서 사용할 수 있습니다. 예를 들어 <code>alpine</code>에서는 패키지 매니저 <code>apk</code>로 <code>bash</code>를 설치하고 사용할 수 있습니다.</p>
<pre><code>$ docker run -it alpine:latest sh
/ # apk add bash
fetch https://dl-cdn.alpinelinux.org/alpine/v3.19/main/aarch64/APKINDEX.tar.gz
fetch https://dl-cdn.alpinelinux.org/alpine/v3.19/community/aarch64/APKINDEX.tar.gz
(1/4) Installing ncurses-terminfo-base (6.4_p20231125-r0)
(2/4) Installing libncursesw (6.4_p20231125-r0)
(3/4) Installing readline (8.2.1-r2)
(4/4) Installing bash (5.2.21-r0)
Executing bash-5.2.21-r0.post-install
Executing busybox-1.36.1-r15.trigger
OK: 12 MiB in 19 packages
/ # bash
4f8013c671ac:/#</code></pre>
<p>필요하다면 bash 셸이 설치된 이미지를 미리 만들어두는 것도 방법입니다. 다음 파일을 Dockerfile에 저장합니다.</p>
<pre><code>FROM alpine:latest
RUN apk add bash</code></pre>
<p>다음 명령어로 <code>apline:bash</code> 이미지를 빌드합니다.</p>
<pre><code>$ docker build -t alpine:bash .</code></pre>
<p>이제 <code>alpine</code> 기반의 이미지에서도 <code>bash</code> 셸을 사용할 수 있습니다.</p>
<pre><code>$ docker run -it alpine:bash bash
56578f816b3c:/#</code></pre>
<h2 id="bash도-sh도-없는-경우">bash도 sh도 없는 경우</h2>


<p>아주 극단적인 경량화나 보안 상의 이유로 bash나 sh 모두 없는 이미지도 있습니다. 이런 경우에도 셸을 실행하는 것이 불가능한 것은 아닙니다만, 상당히 까다롭습니다. 왜냐면 어떤 명령어를 실행하기 위해서는 적절한 디렉터리 구조와 라이브리 파일 등을 적절하게 배치해두어야하기 때문입니다. 이런 이미지들은 이런 구조가 없을 가능성이 높습니다.</p>
<p>단순히 셸을 사용해야한다면, 리눅스 배포판 기반의 이미지를 사용하거나, 직접 이미지를 빌드해서 사용하는 것을 추천 드립니다.</p>
<h2 id="추천-문서">추천 문서</h2>
<p>도커 컨테이너에서 셸을 실행하거나 접속하는 방법에 대해서는 다음 글에서 상세히 소개합니다.</p>
<ul>
<li><a href="https://www.lainyzine.com/ko/article/how-to-access-a-docker-container/">도커 컨테이너에 접속하는 방법</a></li>
</ul>
<p>컨테이너를 실행하는 docker run 명령어에 대한 더 자세한 정보는 아래 글을 참고해주세요.</p>
<ul>
<li><a href="https://www.lainyzine.com/ko/article/docker-run/">docker run 컨테이너 실행 완전 가이드</a></li>
</ul>


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

LZ: 프로그래머 가이드

LainyZine

도커 컨테이너에서 bash 셸을 실행할 때 에러가 발생하는 경우가 있습니다. 이 글에서는 컨테이너에서 bash 셸을 실행하는 방법과 실패하는 이유와 해결방법에 대해서 알아봅니다.
전체 기사는 이 링크에서 읽을 수 있습니다.

docker 실행 시 bash 에러 해결 방법

댓글