[Docker] 오프라인 환경에서 gitlab runner 기동 시, docker offline 설정하기

docker compose 로 gitlab runner를 기동하고, cicd를 구축할 경우 

오프라인 환경이라면, gitlab-runner-helper라는 docker image를 pull할 수 없고, alpine:latest 라는 image를 pull할 수 없다는 오류가 발생한다.

이럴 때 아래와 같은 작업이 필요하다.

 

먼저, 수동으로 이미지를 tar 파일로 다운로드하여, docker load 해준다.

## docker image 가져오는 방법(Mac -> VM)
docker pull --platform linux/amd64 gitlab/gitlab-runner-helper:latest
docker save -o gitlab-runner-helper-amd64.tar gitlab/gitlab-runner-helper:latest

docker pull --platform linux/amd64 alpine:latest
docker save -o alpine_latest.tar alpine:latest

## VM으로 해당 tar 파일 전송 후, 명령어 수행
docker load -i gitlab-runner-helper-amd64.tar
docker load -i alpine_latest.tar

## 이미지가 정상 로드 되었는지 확인
docker images

 

gitlab runner config 파일을 찾아서, 오프라인 pull 모드를 설정해 준다.

# volume 설정 했을 경우, config에 해당하는 경로의 파일로 열기(sudo 권한 필요)
sudo vi /data001/dev/gitlab-runner/config/config.toml

# 또는 내부 container 접속하여, 아래 경로로 접속
sudo vi /etc/gitlab-runner/config.toml

# 파일 수정
[[runners]]
  (...)
  executor = "docker"
  [runners.docker]
    (...)
    pull_policy = "never" # 핵심
    helper_image = "gitlab/gitlab-runner-helper:latest" # 여기에 helper docker image명칭(+ version)

 

출처

- https://stackoverflow.com/questions/67620001/what-is-gitlab-gitlab-runner-helper-docker-image-used-for