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


</header>
<nav>
<ul>
<li><a href="#docker-hub%EC%97%90%EC%84%9C-%EC%9D%B4%EB%AF%B8%EC%A7%80-%EA%B2%80%EC%83%89%ED%95%98%EA%B8%B0">Docker Hub에서 이미지 검색하기</a></li>
<li>
<a href="#docker-search-%EB%AA%85%EB%A0%B9%EC%96%B4">docker search 명령어</a>
<ul>
<li><a href="#limit-%EA%B2%80%EC%83%89-%EA%B2%B0%EA%B3%BC-%EC%B6%9C%EB%A0%A5-%EA%B0%9C%EC%88%98">–limit: 검색 결과 출력 개수</a></li>
<li><a href="#filter-%EA%B2%80%EC%83%89-%EA%B2%B0%EA%B3%BC-%ED%95%84%ED%84%B0%EB%A7%81">–filter: 검색 결과 필터링</a></li>
<li><a href="#no-trunc">–no-trunc</a></li>
</ul>
</li>
<li><a href="#%EC%B6%94%EC%B2%9C-%EB%AC%B8%EC%84%9C">추천 문서</a></li>
</ul>
</nav>
<p>하나의 Docker 이미지는 특정 애플리케이션을 실행하기 위한 파일 집합이라고 할 수 있습니다. 도커 이미지만 준비되어있다면, 아무리 설치가 어려운 애플리케이션도 명령어 하나로 실행할 수 있습니다. 도커 이미지는 직접 만들 수도 있습니다만, Docker Hub에서 제공하는 공식 이미지와 사용자들이 공개해둔 이미지들을 사용할 수도 있습니다.</p>
<p>이 글에서는 Docker Hub에서 이미지를 검색하는 방법을 알아봅니다.</p>
<h2 id="docker-hub에서-이미지-검색하기">Docker Hub에서 이미지 검색하기</h2>
<p>도커 허브의 상단 검색폼에서 도커 이미지를 검색해볼 수 있습니다.</p>
<ul>
<li><a href="https://hub.docker.com/">Docker Hub</a></li>
</ul>
<figure>
<img src="https://www.lainyzine.com/ko/article/searching-for-images-with-the-docker-search-command/assets/image.png" alt="Docker Hub에서 nginx를 검색한 결과">
</figure>
<p>도커 허브에서는 Extentions와 Plugins도 제공하고 있어서, 이미지만 보고 싶다면 왼쪽 Products 필터에서 Images만 체크해줍니다.</p>
<p>또한 왼쪽 사이드 바에서 확인할 수 있듯이 신뢰할 수 있는 컨텐츠(Trusted Content), 운영체제(Operating Systems), 아키텍처(Architectures)로 이미지를 필터링할 수 있습니다.</p>
<p>Docker Hub에 공개된 이미지라면 어떤 이미지든지 사용할 수 있습니다만, 보안을 위해서 몇 가지를 기억해주세요.</p>
<ul>
<li>먼저 신뢰할 수 있는 컨텐츠를 최우선적으로 사용해주세요.</li>
<li>신뢰할 수 있는 컨텐츠가 없다면 프로젝트에서 공식적으로 제공하는 도커 이미지를 사용해주세요.</li>
<li>그 외의 이미지를 사용해야한다면, Dockerfile을 검토하거나 직접 빌드해서 사용하는 걸 추천합니다.</li>
</ul>
<p>공개된 이미지를 사용하는 것은 편리합니다만, 잠재적인 보안 문제나 악성 코드를 포함하고 있을 수 있으니 항상 주의가 필요합니다.</p>
<div>
<p>
신뢰할 수 있는 컨텐츠와 Docker 공식 이미지
</p>
<div>

<p>도커 공식 이미지(Docker Official Image)는 믿고 사용할 수 있습니다. 신뢰할 수 있는 컨텐츠는 도커 공식 이미지를 포함한 더 넓은 개념입니다. 인증된 발행자(Verified Publisher)는 Docker에서 직접 제공하지는 않지만 Docker에 의해서 검증된 발행자가 업로드한 이미지를 의미합니다. Sponsored OSS는 Docker에서 지원하고 있는 오픈소스 프로젝트를 의미합니다.</p>
<p>도커 공식 이미지에 대해서는 다음 글에서 더 자세히 소개합니다.</p>
<ul>
<li><a href="https://www.lainyzine.com/ko/article/understanding-docker-hub-and-docker-official-images/">Docker Hub와 Docker 공식 이미지의 이해</a></li>
</ul>

</div>
</div>
<h2 id="docker-search-명령어">docker search 명령어</h2>
<p>커맨드라인에서도 <code>docker search</code> 명령어로 이미지를 검색할 수 있습니다. 아래는 <code>nginx</code> 이미지를 검색해본 결과입니다.</p>
<pre><code>$ docker search nginx
NAME                                              DESCRIPTION                                     STARS     OFFICIAL   AUTOMATED
nginx                                             Official build of Nginx.                        19000     [OK]
bitnami/nginx                                     Bitnami nginx Docker Image                      173                  [OK]
nginxproxy/acme-companion                         Automated ACME SSL certificate generation fo…   123
nginxinc/nginx-unprivileged                       Unprivileged NGINX Dockerfiles                  121
nginxproxy/nginx-proxy                            Automated Nginx reverse proxy for docker con…   103
ubuntu/nginx                                      Nginx, a high-performance reverse proxy &amp; we…   98
...</code></pre>
<p>검색 결과는 이미지 이름(NAME), 이미지 설명(DESCRIPTION), 별 개수(STARS), 공식 이미지 여부(OFFCIAL), 자동화 빌드 사용 여부(AUTOMATED)를 포함합니다. 기본 정렬은 별 개수 순입니다.</p>
<p>여기서부터는 docker search의 주요한 옵션들을 설명합니다.</p>
<h3 id="limit-검색-결과-출력-개수">–limit: 검색 결과 출력 개수</h3>


<p>limit 옵션은 검색 결과에서 출력할 개수를 지정합니다. 0은 무제한이며, 기본값은 0입니다. <code>--limit</code> 옵션을 사용하는 예제입니다.</p>
<pre><code>$ docker search nginx --limit 1
NAME      DESCRIPTION                STARS     OFFICIAL   AUTOMATED
nginx     Official build of Nginx.   19000     [OK]</code></pre>
<h3 id="filter-검색-결과-필터링">–filter: 검색 결과 필터링</h3>
<p>filter 옵션을 사용해서 검색 결과를 필터링할 수 있습니다. 사용가능한 필터는 다음과 같습니다.</p>
<table>
<thead>
<tr>
<th>필터 이름</th>
<th>설명</th>
</tr>
</thead>
<tbody>
<tr>
<td>stars</td>
<td>별 개수(지정된 수 이상)</td>
</tr>
<tr>
<td>is-automated</td>
<td>자동화 빌드 사용 여부(true or false)</td>
</tr>
<tr>
<td>is-official</td>
<td>공식 이미지 여부(true or false)</td>
</tr>
</tbody>
</table>
<p>아래는 <code>stars</code> 필터를 사용하는 예제입니다. 별 개수가 150개 이상인 이미지를 보여줍니다.</p>
<pre><code>$ docker search --filter stars=150 nginx
NAME            DESCRIPTION                  STARS     OFFICIAL   AUTOMATED
nginx           Official build of Nginx.     19000     [OK]
bitnami/nginx   Bitnami nginx Docker Image   173                  [OK]</code></pre>
<p>다음은 공식 이미지만 검색하는 예제입니다.</p>
<pre><code>$ docker search --filter is-official=true nginx
NAME      DESCRIPTION                                     STARS     OFFICIAL   AUTOMATED
nginx     Official build of Nginx.                        19000     [OK]
unit      Official build of NGINX Unit: Universal Web …   12        [OK]</code></pre>
<h3 id="no-trunc">–no-trunc</h3>
<p>이 옵션을 사용하면 이미지 설명을 자르지 않고, 전부 출력합니다.</p>
<h2 id="추천-문서">추천 문서</h2>


<p>다음은 docker serach 명령어의 공식 레퍼런스 문서입니다.</p>
<ul>
<li><a href="https://docs.docker.com/engine/reference/commandline/search/">docker search | Docker Docs</a></li>
</ul>

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

LZ: 프로그래머 가이드

LainyZine

Docker Hub에서 이미지를 검색하는 방법과 docker search 명령어의 사용법을 알아봅니다.
전체 기사는 이 링크에서 읽을 수 있습니다.

도커 허브에서 이미지 검색(docker search)

댓글