Jenkins 튜토리얼 따라하기 : Docker + Guided Tour (1)

Posted Apr 25, 2025

By 띵석

views 5 min read

Docker 에서 Jenkins 실행하기

Docker Image & Container

Window11 환경에서 진행하였다.
Linux, Mac에서 Docker run 명령어는 Jenkins Handbook 참고

Jenkins Container와 Docker deamon Container간의 통신을 위해 Docker 네트워크를 설정해 준다

docker network create jenkins

Jenkins Container 안에서 Docker 명령을 실행하기 위해 docker:dind 이미지를 다운로드하고 실행한다

  
docker run --name jenkins-docker --rm --detach ^
  --privileged --network jenkins --network-alias docker ^
  --env DOCKER_TLS_CERTDIR=/certs ^
  --volume jenkins-docker-certs:/certs/client ^
  --volume jenkins-data:/var/jenkins_home ^
  --publish 2376:2376 ^
  docker:dind

--privileged : dind가 제대로 작동하기 위해 권한 설정
--volume jenkins-docker-certs:/certs/client : TLS 인증서를 위한 볼륨 마운트
--volume jenkins-data:/var/jenkins_home : Jenkins 데이터를 위한 볼륨 마운트

공식 Jenkins 이미지를 기반으로 Docker CLI를 추가한 Dockerfile을 만든다

  
FROM jenkins/jenkins
USER root
RUN apt-get update && apt-get install -y lsb-release
RUN curl -fsSLo /usr/share/keyrings/docker-archive-keyring.asc \
  https://download.docker.com/linux/debian/gpg
RUN echo "deb [arch=$(dpkg --print-architecture) \
  signed-by=/usr/share/keyrings/docker-archive-keyring.asc] \
  https://download.docker.com/linux/debian \
  $(lsb_release -cs) stable" > /etc/apt/sources.list.d/docker.list
RUN apt-get update && apt-get install -y docker-ce-cli
USER jenkins

Dockerfile을 기반으로 myjenkins 라는 이름으로 Docker 이미지를 빌드하고 실행시킨다

docker build -t myjenkins .

  
docker run --name jenkins --restart=on-failure --detach ^
  --network jenkins --env DOCKER_HOST=tcp://docker:2376 ^
  --env DOCKER_CERT_PATH=/certs/client --env DOCKER_TLS_VERIFY=1 ^
  --volume jenkins-data:/var/jenkins_home ^
  --volume jenkins-docker-certs:/certs/client:ro ^
  --publish 8080:8080 --publish 50000:50000 myjenkins

Docker Container 실행 모습

두 개의 Container를 별도로 띄우는 이유

Jenkins 자체는 Container 안에서 돌아가는 일반 앱
-> Jenkins가 실제로 빌드하고 테스트할 애플리케이션을 Docker Container로 띄우려면 Docker 엔진(docker CLI)이 필요하다
문제는 Docker안에 또 Docker를 설치하거나, 소켓을 공유해야 한다는 건데, 보안이나 권한 문제 등이 존재
이를 해결하기 위해 Jenkins가 사용할 Docker deamon을 따로 docker:dind(Docker in Docker)로 만들어서, Jenkins가 그 Container에 접근해서 작업을 진행한다
작동 과정
1. 웹 UI에서 파이프라인 생성
  - GitHub 저장소 연결 또는 Dockerfile 기반 프로젝트 설정
2. 파이프라인 실행 시
  - Jenkins 내부에서 docker CLI 명령어 실행
  - 환경 변수 DOCKER_HOST=tcp://docker:2376 설정에 따라 명령은 jenkins-docker Container의 Docker deamon에 전달
3. Container 생성 및 실행
  - jenkins-docker는 명령을 받아 Docker Container를 실행
4. 작업 완료 후 결과 보고
  - Jenkins가 로그/빌드 결과를 수집하여 UI에 표시

Host (Local)
├─ Docker Network: jenkins
│   ├─ jenkins-blueocean      ← Jenkins 앱 (명령 내림)
│   └─ jenkins-docker         ← Docker deamon (명령 실행)
└─ 빌드 Container          ← 실제로 여기 생성됨

Jenkins에서 작업하는 Container는 실제로 Jenkins Container 내부나, Docker deamon Container 내부가 아닌, “호스트 머신(Local)”에 띄워진다

Jenkins 초기 설정

Jenkins의 password key를 확인하기 위해 다음 명령어를 입력

docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword 

아래와 같이 직접 Container에 접속해서 확인할 수도 있다

docker ps
docker logs <docker-container-name>

http://localhost:8080/ 에서 Jenkins UI를 확인할 수 있다

password key를 붙여넣는다

Install suggested plugins 선택

관리자 계정 생성

Jenkins URL 설정

지금은 별다른 변경 없이 그대로 진행하였다

설정 완료

Pipeline 구현

Docker Pipeline plugin 설치

우측 상단의 Manage Jenkins 를 클릭하여 관리 페이지로 간 후, Plugins 클릭

Available plugins 클릭 → Docker Pipeline 입력 → Install을 체크하고 설치를 진행한다

설치 과정이 표시되면 아래로 스크롤해서 Jenkins 재시작 을 선택한다

Installed plugins 에서 Docker Pipeline plugin이 설치된 것을 확인할 수 있다

Repository 설정

repo의 root 경로에 Jenkinsfile 을 생성한다

Jenkinsfile example link : https://www.jenkins.io/doc/pipeline/tour/hello-world/#examples

  
pipeline {
    agent { docker { image 'node:22.14.0-alpine3.21' } }
    stages {
        stage('build') {
            steps {
                sh 'node --version'
            }
        }
    }
}