레지스트리에 Docker-in-Docker로 인증하기

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

Docker-in-Docker를 사용할 때는
표준 인증 방법이 작동하지 않으며, 서비스와 함께 새 Docker 데몬이 시작됩니다.

옵션 1: docker login 실행

before_script에서 docker login을 실행합니다:

default:
  image: docker:24.0.5
  services:
    - docker:24.0.5-dind

variables:
  DOCKER_TLS_CERTDIR: "/certs"

build:
  stage: build
  before_script:
    - echo "$DOCKER_REGISTRY_PASS" | docker login $DOCKER_REGISTRY --username $DOCKER_REGISTRY_USER --password-stdin
  script:
    - docker build -t my-docker-image .
    - docker run my-docker-image /script/to/run/tests

Docker Hub에 로그인하려면 $DOCKER_REGISTRY를 비워두거나 제거하십시오.

옵션 2: 각 작업에 ~/.docker/config.json 마운트

GitLab Runner의 관리자라면
인증 구성을 포함하는 파일을 ~/.docker/config.json에 마운트할 수 있습니다.
그렇다면 러너가 가져오는 모든 작업은 이미 인증됩니다.
공식 docker:24.0.5 이미지를 사용하는 경우 홈 디렉터리는 /root 아래에 있습니다.

구성 파일을 마운트하면 ~/.docker/config.json을 수정하는 docker 명령은 실패합니다.
예를 들어, docker login은 실패합니다. 왜냐하면 파일이 읽기 전용으로 마운트되기 때문입니다.
읽기 전용에서 변경하지 마십시오. 이로 인해 문제가 발생할 수 있습니다.

다음은
DOCKER_AUTH_CONFIG
문서에 따른 /opt/.docker/config.json의 예입니다:

{
    "auths": {
        "https://index.docker.io/v1/": {
            "auth": "bXlfdXNlcm5hbWU6bXlfcGFzc3dvcmQ="
        }
    }
}

Docker

볼륨 마운트를 업데이트하여 파일을 포함합니다.

[[runners]]
  ...
  executor = "docker"
  [runners.docker]
    ...
    privileged = true
    volumes = ["/opt/.docker/config.json:/root/.docker/config.json:ro"]

Kubernetes

이 파일의 내용을 포함하는 ConfigMap을 생성합니다.
다음과 같은 명령으로 수행할 수 있습니다:

kubectl create configmap docker-client-config --namespace gitlab-runner --from-file /opt/.docker/config.json

볼륨 마운트를 업데이트하여 파일을 포함합니다.

[[runners]]
  ...
  executor = "kubernetes"
  [runners.kubernetes]
    image = "alpine:3.12"
    privileged = true
    [[runners.kubernetes.volumes.config_map]]
      name = "docker-client-config"
      mount_path = "/root/.docker/config.json"
      # GitLab Runner 13.5 이하에서 실행 중이라면 이 항목을 제거할 수 있습니다.
      sub_path = "config.json"

옵션 3: DOCKER_AUTH_CONFIG 사용

이미 DOCKER_AUTH_CONFIG 가 정의되어 있다면, 이 변수를 사용하여 ~/.docker/config.json에 저장할 수 있습니다.

이 인증을 여러 방법으로 정의할 수 있습니다:

다음 예제는 before_script를 보여줍니다.

앱니다. 동일한 명령은 구현하는 모든 솔루션에 적용됩니다.

default:
  image: docker:24.0.5
  services:
    - docker:24.0.5-dind

variables:
  DOCKER_TLS_CERTDIR: "/certs"

build:
  stage: build
  before_script:
    - mkdir -p $HOME/.docker
    - echo $DOCKER_AUTH_CONFIG > $HOME/.docker/config.json
  script:
    - docker build -t my-docker-image .
    - docker run my-docker-image /script/to/run/tests