03 Docker 이미지 관리

※ '시작하세요! 도커/쿠버네티스' 책과 교육을 통해 들은 내용, 공식 문서를 토대로 정리했습니다.

 

01 Docker 설치하기

이전 게시물을 참고하여 먼저 Docker를 설치하시면 됩니다.

Docker 설치가 끝났으면 이제부터 도커에서 사용하는 명령어들에 대해 알아보겠습니다.

오늘은 이미지 관리에 대해 알아보겠습니다.

이미지 검색

docker search [OPTIONS] TERM

Dockerfile을 작성하기 전에 필요한 이미지에 대해 찾아볼 필요가 있습니다.

위와 같이 명령어로 가능하지만 https://hub.docker.com/에서 찾아보는 편이 태그를 확인할 수 있어서 개인적으로 좋다고 생각하여 자세히 설명하지는 않겠습니다.

다만 이 때 태그는 무엇을 말하는 걸까요? 이미지 다운로드에서 살펴보겠습니다.

이미지 다운로드

docker image pull [OPTIONS] NAME[:TAG|@DIGEST]
# Aliases
docker pull

위 명령어는 registry에 있는 이미지를 가져올 때 사용하는 명령어입니다. 기본적으로 이미지는 Docker Hub에서 가져옵니다. 이 명령어는 Dockerfile을 run할 때 image가 로컬에 없다면 알아서 registry에서 찾으므로 사용할 일이 적을 것입니다.

이미지를 pull할 때 'Tag'나 'Digest'를 지정할 수 있습니다.

'Tag'는 사용자가 특정 이미지를 부여한 값입니다. 'Tag'를 지정하지 않으면 가장 최신 버전인 latest로 이미지를 다운로드 합니다. 그러므로 latest의 경우 다운로드 시점에 따라 버전이 바뀔 수 있으므로 'Tag'를 지정하여 사용하는 것이 좋습니다.

'Digest'는 변경이 불가능한 고유한 값입니다. 동일한 방식으로 생성된 이미지라면 동일한 digest가 생성됩니다. 빌드 중 이미지 레이어가 변한다면 digest 또한 변합니다. 이미지가 새로운 버전으로 바뀌기를 원치 않는다면 digest를 사용하여 항상 같은 버전의 이미지를 사용할 수 있습니다.

$ docker pull ubuntu:24.04
24.04: Pulling from library/ubuntu
31e907dcc94a: Pull complete
Digest: sha256:8a37d68f4f73ebf3d4efafbcf66379bf3728902a8038616808f04e34a9ab63ee
Status: Downloaded newer image for ubuntu:24.04
docker.io/library/ubuntu:24.04
$ docker images
REPOSITORY               TAG       IMAGE ID       CREATED        SIZE
ubuntu                   24.04     edbfe74c41f8   3 weeks ago    78.1MB

$ docker pull ubuntu@sha256:8a37d68f4f73ebf3d4efafbcf66379bf3728902a8038616808f04e34a9ab63ee
docker.io/library/ubuntu@sha256:8a37d68f4f73ebf3d4efafbcf66379bf3728902a8038616808f04e34a9ab63ee: Pulling from library/ubuntu
31e907dcc94a: Pull complete
Digest: sha256:8a37d68f4f73ebf3d4efafbcf66379bf3728902a8038616808f04e34a9ab63ee
Status: Downloaded newer image for ubuntu@sha256:8a37d68f4f73ebf3d4efafbcf66379bf3728902a8038616808f04e34a9ab63ee
docker.io/library/ubuntu@sha256:8a37d68f4f73ebf3d4efafbcf66379bf3728902a8038616808f04e34a9ab63ee
$ docker images
REPOSITORY               TAG       IMAGE ID       CREATED        SIZE
ubuntu                   <none>    edbfe74c41f8   3 weeks ago    78.1MB

이와 같이 'Tag' 대신 'Digest'를 사용할 수 있지만 보통 'Tag'를 많이 사용합니다.

옵션은 아래와 같이 있습니다.

Option	Description
-a, --all-tags	해당 이미지의 repository에 있는 태그된 모든 이미지를 다운로드
--disable-content-trust	기본값은 true. 이미지 검증을 하지 않음.
--platform	서버에서 여러 플랫폼을 사용할 수 있도록 플랫폼을 지정할 수 있음.
-q, --quiet	내용이 장황하게 출력되지 않도록 함.

---

이미지 목록 보기

docker image ls [OPTIONS] [REPOSITORY[:TAG]]
# Aliases
docker image list
docker images

기본 도커 이미지들은 상위 이미지, 저장소 및 태그, 크기를 보여줍니다. 

도커 이미지들은 각각의 캐시를 허용함으로써 재사용성을 높이고 디스크 사용량을 줄이며 'docker build' 시 속도를 높이는 중간 레이어들이 있습니다. 이러한 중간 레이어들은 기본적으로 보이지 않습니다.

`-a, --all` 옵션을 사용하면 중간 이미지도 모두 출력하여 볼 수 있습니다.

이외에도 아래와 같은 옵션이 있습니다.

Option	Description
-a, --all	모든 이미지 출력.(중간이미지도 포함)
--digests	digest를 출력
-f, --filter	조건에 따른 출력.
--format	사용자 지정 템플릿을 사용한 출력 형식. 템플릿을 사용한 출력 포맷에 대한 자세한 내용은 https://docs.docker.com/go/formatting/ 참조
--no-trunc	출력을 자르지 않음.
-q, --quiet	이미지 ID들만 보여줌.

---

이미지 삭제하기

docker image rm [OPTIONS] IMAGE [IMAGE...]
# ALiases
docker image remove
docker rmi

호스트 노드에서 하나 이상의 이미지들을 지울 수 있습니다.

이미지에 여러 태그가 있다면 태그를 매개 변수로 사용하면 태그만 제거됩니다. 이 경우 이미지를 지우고 싶다면 우선 태그를 먼저 지운 후에 이미지를 지워야 합니다.

이미지에 태그가 하나만 있으면 이미지와 태그가 모두 제거됩니다.

이미지는 태그가 아닌 ID, digest를 이용해서도 지울 수 있습니다.

이 때, 동일한 `Image ID`를 가진 이미지가 2개 이상인 경우 `Image ID`를 이용하여 삭제할 수 없으므로 `-f` 를 사용하여 모든 이미지를 삭제합니다.

아래는 아이디를 사용해서 지운 예시입니다.

$ docker images
REPOSITORY               TAG       IMAGE ID       CREATED        SIZE
ubuntu                   <none>    edbfe74c41f8   3 weeks ago    78.1MB
$ docker rmi edbfe74c41f8
Untagged: ubuntu@sha256:8a37d68f4f73ebf3d4efafbcf66379bf3728902a8038616808f04e34a9ab63ee
Deleted: sha256:edbfe74c41f8a3501ce542e137cf28ea04dd03e6df8c9d66519b6ad761c2598a
Deleted: sha256:f36fd4bb7334b7ae3321e3229d103c4a3e7c10a263379cc6a058b977edfb46de

옵션은 아래와 같이 있습니다.

Option	Description
-f, --force	이미지를 강제로 삭제.
--no-prune	태그를 가지지 않으면 지울 수 없음.

---

모든 이미지 삭제하기

docker image prune [OPTIONS]

 

모든 `dangling image`들을 지웁니다. 여기서 `dangling image`란 Repository가 none으로 표기되는 이미지입니다.

일반적으로 `dangling image`는 동일한 이름(Name&Tag)을 가진 다른 이미지를 생성하거나 Multi-Stage 빌드 중 생성된 중간 이미지인 상황에 발생합니다.

`-a`를 사용하는 경우 사용하지 않는 이미지도 모두 지웁니다.

Option	Description
-a, --all	dangling 이미지 이외에도 사용하지 않는 이미지 모두 제거함.
--filter	필터 값 제공.
-f, --force	확인 메시지 표시 안 함.

---

이미지 정보 조회

docker image inspect [OPTIONS] IMAGE [IMAGE...]

하나 이상의 이미지에 대한 자세한 정보를 보여준다.

$ docker image inspect ubuntu:24.04
[
    {
        "Id": "sha256:edbfe74c41f8a3501ce542e137cf28ea04dd03e6df8c9d66519b6ad761c2598a",
        "RepoTags": [
            "ubuntu:24.04"
        ],
        "RepoDigests": [
            "ubuntu@sha256:8a37d68f4f73ebf3d4efafbcf66379bf3728902a8038616808f04e34a9ab63ee"
        ],
        "Parent": "",
        "Comment": "",
        "Created": "2024-08-01T14:23:55.913663537Z",
        "DockerVersion": "24.0.7",
        "Author": "",
        "Config": {
            
                                           ...
                                           
        "RootFS": {
            "Type": "layers",
            "Layers": [
                "sha256:f36fd4bb7334b7ae3321e3229d103c4a3e7c10a263379cc6a058b977edfb46de"
            ]
        },
        "Metadata": {
            "LastTagTime": "0001-01-01T00:00:00Z"
        }
    }
]
$ docker inspect ubuntu:24.04 -f "{{ .Architecture }}"
amd64

기본적으로 명령어를 실행한 경우와 `-f`를 사용한 경우의 결과입니다.

옵션은 아래와 같습니다.

Option	Description
-f, --format	사용자 지정 템플릿을 사용한 출력 형식. 템플릿을 사용한 출력 포맷에 대한 자세한 내용은 https://docs.docker.com/go/formatting/ 참조

 

이상 기본적으로 사용하는 도커 이미지 관리 명령어들에 대해 알아보았습니다.

다음에는 컨테이너 관리에 대해 알아보겠습니다.