CWLog - docker
개발 & 해킹 좋아하는 사람의 블로그
Zola
2025-07-11T00:00:00+00:00
https://blog.devcw.xyz/tags/docker/atom.xml
devcontainer 도입기
2025-07-11T00:00:00+00:00
2025-07-11T00:00:00+00:00
Unknown
https://blog.devcw.xyz/posts/dev-container/
<h2 id="baegyeong">배경<a class="anchor" aria-hidden="true" href="#baegyeong" hidden="">#</a>
</h2>
<p>근래에 회사에서 레거시 프로젝트를 수정하는 업무를 맡았다. 근데 스택이 너무 레거시 스택(자바 1.8, 톰캣, 오라클 11g)이라 초기 환경 설정이 힘들 것 같았다. 호스트에는 JDK 17이 깔려있는데 말이다.</p>
<p>스택은 트레이드오프에 따라 결정할 수 있으니 크게 거슬리는 건 없었는데, 진짜 문제는 기술 부채가 너무 심각했다.</p>
<ul>
<li><code>Maven</code>은 예전에 만들다 말았는지 컴파일 불가</li>
<li>내부 소스 상태는 컨벤션이라고는 볼 수 없는 코드</li>
<li>빌드가 이클립스에 한정적이어서 나머지 IDE에서는 빌드 불가</li>
</ul>
<p>이 중에서 제일 문제는 <strong>빌드가 이클립스에서만 가능하다는 것</strong>이다.</p>
<h2 id="haegyeol">해결<a class="anchor" aria-hidden="true" href="#haegyeol" hidden="">#</a>
</h2>
<p>해결책으로 나는 <code>devcontainer</code>를 도입했다. 실제로 사원 중에 VSC로 개발하는 인원이 대다수였고, 이클립스를 '제대로' 사용할 줄 아는 분은 없었다. 이때매 디버깅 시간도 오래 걸리고 잔버그로 고생하는 분들이 많았다.</p>
<p>기존 이클립스 IDE와 호환성을 유지하기 위해 다음과 같은 원칙을 준수했다:</p>
<ul>
<li>기존 스택의 버전을 동일하게 사용한다.</li>
<li>기존 스택의 설정을 그대로 유지한다.</li>
<li>IDE 설정을 건드리지 않는다.</li>
</ul>
<h2 id="guseong">구성<a class="anchor" aria-hidden="true" href="#guseong" hidden="">#</a>
</h2>
<p><code>devcontainer</code>를 구성하는 방법에는 일반적으로 두가지가 있다.</p>
<ul>
<li>컨테이너 이미지를 직접 만들어서 사용하는 방법</li>
<li>컨테이너 이미지를 사용하는 방법</li>
</ul>
<p>현재 유즈케이스에서는 따로 현대적인 스택도 아니고 이미지도 적다보니, 컨테이너 이미지를 직접 만드는 방법을 택했다.</p>
<p>우선 컨테이너 이미지를 입히기 전, 환경 구축을 먼저 해보자
프로젝트 루트에 <code>.devcontainer</code> 폴더를 만들고, 그 안에 <code>devcontainer.json</code> 파일을 만든다.</p>
<pre class="giallo" style="color-scheme: light dark; color: light-dark(#24292E, #E1E4E8); background-color: light-dark(#FFFFFF, #24292E);"><code data-lang="plain"><span class="giallo-l"><span>.devcontainer/</span></span>
<span class="giallo-l"><span>├── devcontainer.json</span></span>
<span class="giallo-l"><span>└── Dockerfile</span></span></code></pre>
<p>아래가 도커 이미지를 직접 만들어 쓰는 방법이고,</p>
<pre class="giallo" style="color-scheme: light dark; color: light-dark(#24292E, #E1E4E8); background-color: light-dark(#FFFFFF, #24292E);"><code data-lang="json"><span class="giallo-l"><span>{</span></span>
<span class="giallo-l"><span style="color: light-dark(#005CC5, #79B8FF);"> "</span><span style="color: light-dark(#005CC5, #79B8FF);">name</span><span style="color: light-dark(#005CC5, #79B8FF);">"</span><span>:</span><span style="color: light-dark(#032F62, #9ECBFF);"> "</span><span style="color: light-dark(#032F62, #9ECBFF);">devcontainer</span><span style="color: light-dark(#032F62, #9ECBFF);">"</span><span>,</span></span>
<span class="giallo-l"></span>
<span class="giallo-l"><span style="color: light-dark(#6A737D, #6A737D);"> //</span><span style="color: light-dark(#6A737D, #6A737D);"> 도커 이미지 빌드 설정 (직접 이미지를 빌드할 때)</span></span>
<span class="giallo-l"><span style="color: light-dark(#005CC5, #79B8FF);"> "</span><span style="color: light-dark(#005CC5, #79B8FF);">dockerFile</span><span style="color: light-dark(#005CC5, #79B8FF);">"</span><span>:</span><span style="color: light-dark(#032F62, #9ECBFF);"> "</span><span style="color: light-dark(#032F62, #9ECBFF);">Dockerfile</span><span style="color: light-dark(#032F62, #9ECBFF);">"</span><span>,</span></span>
<span class="giallo-l"><span style="color: light-dark(#005CC5, #79B8FF);"> "</span><span style="color: light-dark(#005CC5, #79B8FF);">context</span><span style="color: light-dark(#005CC5, #79B8FF);">"</span><span>:</span><span style="color: light-dark(#032F62, #9ECBFF);"> "</span><span style="color: light-dark(#032F62, #9ECBFF);">.</span><span style="color: light-dark(#032F62, #9ECBFF);">"</span><span>,</span></span>
<span class="giallo-l"></span>
<span class="giallo-l"><span style="color: light-dark(#6A737D, #6A737D);"> //</span><span style="color: light-dark(#6A737D, #6A737D);"> 도커 이미지 사용 설정 (이미지가 미리 빌드되어 있을 때)</span></span>
<span class="giallo-l"><span style="color: light-dark(#005CC5, #79B8FF);"> "</span><span style="color: light-dark(#005CC5, #79B8FF);">image</span><span style="color: light-dark(#005CC5, #79B8FF);">"</span><span>:</span><span style="color: light-dark(#032F62, #9ECBFF);"> "</span><span style="color: light-dark(#032F62, #9ECBFF);">devcontainer/devcontainer:latest</span><span style="color: light-dark(#032F62, #9ECBFF);">"</span><span>,</span></span>
<span class="giallo-l"></span>
<span class="giallo-l"><span style="color: light-dark(#6A737D, #6A737D);"> //</span><span style="color: light-dark(#6A737D, #6A737D);"> 위 둘 중 택일</span></span>
<span class="giallo-l"></span>
<span class="giallo-l"><span style="color: light-dark(#6A737D, #6A737D);"> //</span><span style="color: light-dark(#6A737D, #6A737D);"> ------- 추가 설정 -------</span></span>
<span class="giallo-l"></span>
<span class="giallo-l"><span style="color: light-dark(#6A737D, #6A737D);"> //</span><span style="color: light-dark(#6A737D, #6A737D);"> VSC 설정</span></span>
<span class="giallo-l"><span style="color: light-dark(#005CC5, #79B8FF);"> "</span><span style="color: light-dark(#005CC5, #79B8FF);">settings</span><span style="color: light-dark(#005CC5, #79B8FF);">"</span><span>:</span><span> {</span></span>
<span class="giallo-l"><span style="color: light-dark(#005CC5, #79B8FF);"> "</span><span style="color: light-dark(#005CC5, #79B8FF);">terminal.integrated.shell.linux</span><span style="color: light-dark(#005CC5, #79B8FF);">"</span><span>:</span><span style="color: light-dark(#032F62, #9ECBFF);"> "</span><span style="color: light-dark(#032F62, #9ECBFF);">/bin/bash</span><span style="color: light-dark(#032F62, #9ECBFF);">"</span><span>,</span></span>
<span class="giallo-l"><span style="color: light-dark(#005CC5, #79B8FF);"> "</span><span style="color: light-dark(#005CC5, #79B8FF);">java.home</span><span style="color: light-dark(#005CC5, #79B8FF);">"</span><span>:</span><span style="color: light-dark(#032F62, #9ECBFF);"> "</span><span style="color: light-dark(#032F62, #9ECBFF);">/usr/lib/jvm/java-17-openjdk-amd64</span><span style="color: light-dark(#032F62, #9ECBFF);">"</span><span>,</span></span>
<span class="giallo-l"><span> }</span><span>,</span></span>
<span class="giallo-l"></span>
<span class="giallo-l"><span style="color: light-dark(#6A737D, #6A737D);"> //</span><span style="color: light-dark(#6A737D, #6A737D);"> VSC 익스텐션 (devcontainer가 연결되면 자동으로 설치됨)</span></span>
<span class="giallo-l"><span style="color: light-dark(#005CC5, #79B8FF);"> "</span><span style="color: light-dark(#005CC5, #79B8FF);">extensions</span><span style="color: light-dark(#005CC5, #79B8FF);">"</span><span>:</span><span> [</span></span>
<span class="giallo-l"><span style="color: light-dark(#032F62, #9ECBFF);"> "</span><span style="color: light-dark(#032F62, #9ECBFF);">vscjava.vscode-java-pack</span><span style="color: light-dark(#032F62, #9ECBFF);">"</span><span>,</span></span>
<span class="giallo-l"><span> ]</span><span>,</span></span>
<span class="giallo-l"></span>
<span class="giallo-l"></span>
<span class="giallo-l"><span style="color: light-dark(#6A737D, #6A737D);"> //</span><span style="color: light-dark(#6A737D, #6A737D);"> 컨테이너 내부 포트를 호스트에 포워딩</span></span>
<span class="giallo-l"><span style="color: light-dark(#005CC5, #79B8FF);"> "</span><span style="color: light-dark(#005CC5, #79B8FF);">forwardPorts</span><span style="color: light-dark(#005CC5, #79B8FF);">"</span><span>:</span><span> [</span><span style="color: light-dark(#005CC5, #79B8FF);">8080</span><span>]</span><span>,</span></span>
<span class="giallo-l"></span>
<span class="giallo-l"><span style="color: light-dark(#6A737D, #6A737D);"> //</span><span style="color: light-dark(#6A737D, #6A737D);"> 컨테이너 내부 사용자 이름 (기본값은 root)</span></span>
<span class="giallo-l"><span style="color: light-dark(#005CC5, #79B8FF);"> "</span><span style="color: light-dark(#005CC5, #79B8FF);">remoteUser</span><span style="color: light-dark(#005CC5, #79B8FF);">"</span><span>:</span><span style="color: light-dark(#032F62, #9ECBFF);"> "</span><span style="color: light-dark(#032F62, #9ECBFF);">dev</span><span style="color: light-dark(#032F62, #9ECBFF);">"</span><span>,</span></span>
<span class="giallo-l"><span>}</span></span></code></pre>
<p>아래가 배포된 이미지를 사용하는 방법이다.</p>
<pre class="giallo" style="color-scheme: light dark; color: light-dark(#24292E, #E1E4E8); background-color: light-dark(#FFFFFF, #24292E);"><code data-lang="json"><span class="giallo-l"><span>{</span></span>
<span class="giallo-l"><span style="color: light-dark(#005CC5, #79B8FF);"> "</span><span style="color: light-dark(#005CC5, #79B8FF);">name</span><span style="color: light-dark(#005CC5, #79B8FF);">"</span><span>:</span><span style="color: light-dark(#032F62, #9ECBFF);"> "</span><span style="color: light-dark(#032F62, #9ECBFF);">devcontainer</span><span style="color: light-dark(#032F62, #9ECBFF);">"</span><span>,</span></span>
<span class="giallo-l"><span style="color: light-dark(#005CC5, #79B8FF);"> "</span><span style="color: light-dark(#005CC5, #79B8FF);">dockerFile</span><span style="color: light-dark(#005CC5, #79B8FF);">"</span><span>:</span><span style="color: light-dark(#032F62, #9ECBFF);"> "</span><span style="color: light-dark(#032F62, #9ECBFF);">Dockerfile</span><span style="color: light-dark(#032F62, #9ECBFF);">"</span><span>,</span></span>
<span class="giallo-l"><span style="color: light-dark(#005CC5, #79B8FF);"> "</span><span style="color: light-dark(#005CC5, #79B8FF);">context</span><span style="color: light-dark(#005CC5, #79B8FF);">"</span><span>:</span><span style="color: light-dark(#032F62, #9ECBFF);"> "</span><span style="color: light-dark(#032F62, #9ECBFF);">.</span><span style="color: light-dark(#032F62, #9ECBFF);">"</span><span>,</span></span>
<span class="giallo-l"></span>
<span class="giallo-l"><span style="color: light-dark(#6A737D, #6A737D);"> //</span><span style="color: light-dark(#6A737D, #6A737D);"> ------- 추가 설정 -------</span></span>
<span class="giallo-l"></span>
<span class="giallo-l"><span style="color: light-dark(#6A737D, #6A737D);"> //</span><span style="color: light-dark(#6A737D, #6A737D);"> VSC 설정</span></span>
<span class="giallo-l"></span>
<span class="giallo-l"><span style="color: light-dark(#005CC5, #79B8FF);"> "</span><span style="color: light-dark(#005CC5, #79B8FF);">image</span><span style="color: light-dark(#005CC5, #79B8FF);">"</span><span>:</span><span style="color: light-dark(#032F62, #9ECBFF);"> "</span><span style="color: light-dark(#032F62, #9ECBFF);">devcontainer/devcontainer:latest</span><span style="color: light-dark(#032F62, #9ECBFF);">"</span><span>,</span></span>
<span class="giallo-l"><span>}</span></span></code></pre>
<hr />
<p>특별한 경우를 제외하고는 <strong>유저의 권한은 <code>root</code>로 설정하지 않는 것이 보안에 바람직하다</strong>. 컨테이너 내부에서 <code>root</code> 권한으로 실행되는 프로세스가 해킹당할 경우, 호스트 시스템에도 <strong>심각한 보안 위험</strong>이 될 수 있기 때문이다. 따라서 일반적으로는 <code>remoteUser</code> 설정을 통해 일반 사용자 권한으로 실행하는 것이 권장된다. (참고: <a rel="external" href="https://code.visualstudio.com/remote/advancedcontainers/add-nonroot-user">https://code.visualstudio.com/remote/advancedcontainers/add-nonroot-user</a>)</p>
<p>이제 VSC의 확장 프로그램에서 <code>devcontainer</code>를 검색하고 받아주자</p>
<p><img src="../../images/devcontainer_extension.png" alt="devcontainer 익스텐션 사진" /></p>
<blockquote>
<p>저는 커서이기 때문에 해당 확장 프로그램을 설치함</p>
</blockquote>
<p>이제 프로젝트 루트에서 <code>Ctrl + Shift + P</code>를 눌러 <code>Dev Containers: Reopen in Container</code>를 선택하면 된다.</p>
<h2 id="gyeolron">결론<a class="anchor" aria-hidden="true" href="#gyeolron" hidden="">#</a>
</h2>
<p><code>devcontainer</code>도 만능은 아니다. 한 프로젝트 당 <code>GuestOS</code>를 하나씩 할당하기에 만약 여러 프로젝트를 킨다면 램을 비용이 꽤 든다.</p>
<p>좋은 점은 보안적으로 좋을 것이다. 유저를 제한해두면 해당 컨테이너 내에서 어떤 프로세스를 실행하더라도 호스트 시스템에 영향을 미치지 않는다. (제로데이 취약점이 있을수도 있긴 함)</p>
<h2 id="camjo">참조<a class="anchor" aria-hidden="true" href="#camjo" hidden="">#</a>
</h2>
<ul>
<li><a rel="external" href="https://code.visualstudio.com/remote/advancedcontainers/overview">https://code.visualstudio.com/remote/advancedcontainers/overview</a></li>
</ul>