도커 이미지 복사 자동화: buildx imagetools vs skopeo 실전 비교

Overview

CI/CD 환경이나 사내 레지스트리를 운영하다 보면, 외부 Docker Hub, GCR, ghcr.io 등에서 사용하는 이미지를 내부 레지스트리(Harbor, Nexus 등)로 복사해 관리할 필요가 생긴다.

 

 

특히 다음과 같은 상황에서 유용하다.

• 외부 이미지의 pull 제한 우회 (Docker Hub Rate Limit)
• 인터넷이 제한된 환경(사내망)에서 외부 의존성 제거
• 이미지 신뢰도 확보 및 보안 감사 용이성

 

 

이런 목적에 사용되는 대표적인 툴은 다음 두 가지이다.

• docker buildx imagetools
• skopeo copy

 

 

 

 

 

 

 

 

---

 

 

`docker buildx imagetools create`

 

예시

docker buildx imagetools create \
  --tag harbor.somaz.link/library/node:latest \
  node:latest

 

 

 

특징

• Docker CLI 기반, 멀티플랫폼 이미지 통째로 복사 가능
• manifest list를 그대로 가져옴
• Docker Hub pull limit 회피 불가 (로그인 필요)

 

 

장점

• Docker 설치만으로 사용 가능
• buildx 활성화하면 곧바로 사용 가능

 

 

단점

• layer-level 캐시 재활용은 불가
• 일부 프록시 이미지에서 실패 사례 있음

 

 

 

 

 

 

`skopeo copy`: 더 정교한 복사

 

 

예시

docker buildx imagetools create \
  --tag harbor.somaz.link/library/node:latest \
  node:latest

 

 

 

 

특징

• 이미지의 메타데이터, 레이어별로 세밀하게 복사 가능
• `--src-creds`, `--dest-creds`, `--all` 옵션 지원
• OCI, dir, docker-archive 등 다양한 스토리지 형식도 복사 가능

 

 

장점

• 인증, 사설 레지스트리, 미러 복사에 최적화
• Docker 없이도 사용 가능

 

 

단점

• 학습 난이도 약간 있음
• Docker Desktop 사용자에겐 생소할 수 있음

 

 

 

 

buildx vs skopeo 요약 비교

항목	buildx imagetools	skopeo
설치 난이도	낮음 (Docker만 필요)	약간 있음 (별도 설치)
지원 플랫폼	Docker registry 기반만	다양한 이미지 형식
인증 옵션	약함 (Docker config 기준)	매우 강력 (--creds)
복사 정밀도	단순한 전체 복사	레이어 단위 복사 가능
멀티플랫폼 이미지	지원	지원 (--all)

 

 

 

어떤 툴을 선택해야 할까?

상황	추천 툴
간단한 Docker 이미지 복사 자동화	`docker buildx imagetools`
프라이빗 레지스트리 간 복사 / 인증 필요 / 고급 컨트롤	`skopeo`
OCI 아카이브 또는 디스크 백업/복원 등도 필요	`skopeo`

 

 

 

 

 

실전 스크립트 예제

 

buildx 기반 자동 복사 스크립트

#!/bin/bash
images=(
  "alpine:latest"
  "node:latest"
  "refinedev/node:18"
  "gcr.io/kaniko-project/executor:v1.23.0-debug"
)

for image in "${images[@]}"; do
  docker buildx imagetools create \
    --tag "harbor.somaz.link/library/${image,,}" \
    "$image"
done

 

 

 

skopeo 기반 자동 복사 스크립트 (로그인 필요)

#!/bin/bash

SRC_USER="docker_user"
SRC_PASS="docker_password"
DST_USER="harbor_user"
DST_PASS="harbor_password"

images=(
  "docker://alpine:latest"
  "docker://node:latest"
  "docker://refinedev/node:18"
  "docker://gcr.io/kaniko-project/executor:v1.23.0-debug"
)

for image in "${images[@]}"; do
  name=$(basename "$image")
  skopeo copy \
    --src-creds "$SRC_USER:$SRC_PASS" \
    --dest-creds "$DST_USER:$DST_PASS" \
    "$image" \
    "docker://harbor.somaz.link/library/$name"
done

• 참고: basename을 그대로 쓰면 `executor:v1.23.0-debug` 같은 이름이 보존된다.

 

 

 

 

---

 

 

 

 

 

마무리

외부 이미지 의존성이 늘어나는 현대의 개발·운영 환경에서, 이미지 복사 자동화는 단순한 편의성을 넘어서 보안성, 가용성, 속도 개선까지 영향을 미치는 중요한 인프라 구성 요소이다.

 

 

 

이번 글에서 소개한 `docker buildx imagetools` 와 `skopeo` 는 각각의 강점이 뚜렷하며, 상황에 따라 선택적으로 사용할 수 있다.

• 간단한 복사 자동화나 멀티플랫폼 이미지 통째 복사에는 `buildx imagetools`
• 인증 정보 제어, 복사 대상 형식 다양성, 고급 커스텀 작업이 필요할 땐 `skopeo`

 

 

CI/CD 파이프라인 안에 이미지 복사 작업을 넣고 싶다면, 위에서 소개한 예제 스크립트를 참고해 자신만의 자동화 방식을 구성해보세요.

이미지 복사도 결국 신뢰성과 유연성이 핵심이다.

 

 

내부 레지스트리를 제대로 활용하려면, 이런 기초 도구에 대한 이해는 필수이다.

 

 

 

 

 

 

 

 

---

Reference

https://docs.docker.com/buildx/working-with-buildx/#imagetools

https://github.com/containers/skopeo

https://github.com/containers/skopeo/blob/main/docs/skopeo.1.md

https://goharbor.io/docs/2.13.0/