[리눅스 한 학기 살기 #6] Docker로 Jenkins 실행하기: CI/CD 개념과 초기 설정
TL;DR (세 줄 요약)
- 서버에 Jenkins를 직접 설치하면 8080번 포트가 이미 쓰이고 있거나, JDK 버전이 맞지 않거나, 지울 때 파일이 남는 문제가 생깁니다. Docker 컨테이너 안에서 실행하면 이런 충돌을 피할 수 있습니다.
- Jenkins의 설정과 작업 데이터는
/var/jenkins_home에 저장됩니다. 이 디렉터리를 볼륨으로 연결해 두면 컨테이너를 지워도 데이터가 남습니다.docker run한 줄에 이름, 포트, 볼륨, 재시작 정책을 모두 적습니다. 초기 비밀번호는docker exec로initialAdminPassword파일을 읽어서 얻습니다.
이 글은 "리눅스 한 학기 살기" 과제의 6주 차 기록입니다. CI/CD가 무엇인지 설명하고, Docker로 Jenkins를 실행해서 첫 빌드를 돌리는 과정까지 다룹니다.
1. CI와 CD는 무엇인가요?

- CI(Continuous Integration, 지속적 통합): 여러 사람이 올린 코드를 자주 합치고, 합칠 때마다 빌드와 테스트를 자동으로 실행합니다. 코드끼리 충돌하는 문제를 일찍 찾는 것이 목적입니다.
- CD(Continuous Delivery, 지속적 전달): 테스트를 통과한 결과물을 언제든 배포할 수 있는 상태로 자동으로 준비합니다. 실제 배포는 사람이 승인한 뒤에 할 수 있습니다.
- 지속적 배포(Continuous Deployment): 사람의 승인 없이 운영 환경까지 자동으로 배포합니다.
빌드는 소스 코드를 실행할 수 있는 결과물로 만드는 일이고, 배포는 그 결과물을 사용자가 쓰는 서버에 올리는 일입니다.
Jenkins는 "무엇을 언제 실행할지"를 정해 두고 그대로 실행하는 서버 프로그램입니다. 코드를 가져와 빌드하고, 테스트를 실행하고, 결과물을 옮기는 일을 순서대로 실행하고 로그를 남깁니다.
2. Jenkins를 컨테이너에서 실행하면 무엇이 좋은가요?
Docker 컨테이너는 이미지에 들어 있는 파일과 프로세스만 따로 실행합니다. 컨테이너 바깥과는 포트 연결(-p)과 볼륨(-v)으로만 이어집니다.
- 격리: Jenkins가 쓰는 JDK와 라이브러리가 호스트(컨테이너를 실행하는 컴퓨터)의 것과 섞이지 않습니다.
- 재현성: 같은 이미지 태그를 쓰면 어느 서버에서도 같은 버전이 실행됩니다.
- 정리: 지울 때 컨테이너와 이미지만 지우면 됩니다. 남는 것은 볼륨뿐입니다.
- 이동: 이미지와 볼륨만 옮기면 다른 서버에서 같은 상태로 시작할 수 있습니다.
3. Docker는 어떻게 설치하나요?
# 공식 저장소로 설치 (Ubuntu)
sudo apt update
sudo apt install -y ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo $VERSION_CODENAME) stable" | sudo tee /etc/apt/sources.list.d/docker.list
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
# sudo 없이 쓰기
sudo usermod -aG docker $USER && newgrp docker
docker run hello-world
Docker 공식 저장소를 추가하고 Docker를 설치하는 명령어입니다. 각 단계의 뜻은 이 연재의 5편에서 자세히 설명했습니다. 마지막 두 줄은 현재 사용자를 docker 그룹에 넣어 sudo 없이 docker 명령어를 쓸 수 있게 하고, hello-world 컨테이너로 설치를 확인합니다.
4. Jenkins 컨테이너는 어떻게 실행하나요?
docker pull jenkins/jenkins:lts-jdk17
docker run -d \
--name jenkins \
--restart=on-failure \
-p 8080:8080 \
-p 50000:50000 \
-v jenkins_home:/var/jenkins_home \
jenkins/jenkins:lts-jdk17
docker pull은 이미지를 내려받고, docker run은 이미지로 컨테이너를 만들어 실행합니다. 옵션의 뜻은 다음과 같습니다.
| 옵션 | 뜻 |
-d | 백그라운드에서 실행합니다. 로그는 docker logs jenkins로 봅니다. |
--name jenkins | 컨테이너 이름을 jenkins로 정합니다. |
-p 8080:8080 | 웹 화면에 접속하는 포트입니다. 앞의 숫자가 호스트 포트, 뒤의 숫자가 컨테이너 포트입니다. 호스트의 8080번이 이미 사용 중이면 9090:8080처럼 앞의 숫자를 바꿉니다. |
-p 50000:50000 | 에이전트가 컨트롤러에 접속하는 TCP 포트입니다. 에이전트는 Jenkins의 지시를 받아 빌드를 실제로 실행하는 컴퓨터입니다. SSH 에이전트만 쓰면 생략할 수 있습니다. |
-v jenkins_home:/var/jenkins_home | 설정, 작업, 플러그인이 저장되는 경로를 볼륨에 연결합니다. 컨테이너를 지워도 데이터가 남습니다. |
--restart=on-failure | 오류로 종료되면 자동으로 다시 시작합니다. |
5. Jenkins 초기 설정은 어떻게 하나요?
- 웹 브라우저에서
http://서버IP:8080에 접속합니다. Unlock Jenkins 화면이 나옵니다. - 아래 명령어로 초기 비밀번호를 읽어서 입력합니다.
- 추천 플러그인 설치(Install suggested plugins)를 선택합니다. 플러그인은 Jenkins에 기능을 추가하는 확장 프로그램입니다.
- 관리자 계정을 만듭니다.
- Jenkins URL을 확인하고 시작합니다.
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
# 또는
docker logs jenkins 2>&1 | grep -A2 "Please use the following password"
첫 번째 명령어는 실행 중인 컨테이너 안에서 비밀번호 파일의 내용을 출력합니다. 두 번째 명령어는 컨테이너 로그에서 비밀번호가 적힌 부분을 찾습니다. 둘 중 하나만 쓰면 됩니다.
6. 제대로 동작하는지 어떻게 확인하나요?
- New Item → Freestyle project → 이름 입력 → OK를 누릅니다.
- Build Steps → Add build step → Execute shell을 선택합니다.
echo "Hello World"를 입력하고 Save → Build Now를 누릅니다.- Build History에서 빌드 번호를 누르고, Console Output에서
Finished: SUCCESS가 나왔는지 확인합니다.
컨테이너의 상태는 아래 명령어로 확인합니다.
docker ps
docker logs -f jenkins
docker inspect -f '{{.State.Status}}' jenkins
docker ps: 실행 중인 컨테이너 목록을 보여 줍니다.docker logs -f jenkins: 로그를 계속 이어서 보여 줍니다.docker inspect: 컨테이너의 현재 상태(예: running)를 출력합니다.
자주 묻는 질문 (FAQ)
Q1. 컨테이너를 지우면 설정이 모두 사라지나요?
볼륨을 연결했다면 남습니다. -v jenkins_home:/var/jenkins_home으로 실행했다면 docker rm으로 컨테이너를 지워도 jenkins_home 볼륨에 데이터가 남습니다. 같은 볼륨으로 다시 실행하면 이전 상태로 시작합니다. 볼륨까지 지우면(docker volume rm) 데이터도 사라집니다.
Q2. 8080 포트가 이미 사용 중이라고 나옵니다.
호스트 쪽 포트만 바꾸면 됩니다. -p 9090:8080으로 실행하고 http://서버IP:9090으로 접속합니다. 컨테이너 안쪽 포트는 8080 그대로 둡니다.
Q3. 컨테이너 안에서 docker 명령을 쓰려면 어떻게 하나요?
Jenkins가 이미지를 빌드해야 한다면, 호스트의 /var/run/docker.sock을 컨테이너에 연결하고 컨테이너 안에 docker 명령어를 설치하는 방법이 흔히 쓰입니다. 다만 이 소켓을 넘겨주면 컨테이너가 호스트의 Docker를 제한 없이 쓸 수 있게 됩니다. 권한과 보안에 미치는 영향을 이해한 뒤에 사용해야 합니다.
참고 자료
같은 주제의 다른 글: [리눅스 한 학기 살기 #4] 라즈베리파이 VPN: Tailscale과 WireGuard 비교, [리눅스 한 학기 살기 #5] 라즈베리파이 5(ARM64)에 Docker Engine 설치하기, [리눅스 한 학기 살기 #7] Vim 입문: 모드, 저장과 종료, 이동, 매크로, [리눅스 한 학기 살기 #8] ca-certificates란? 사내 CA 인증서 추가 방법, [리눅스 한 학기 살기 #9] tldr로 리눅스 명령어 예제 찾기: man과의 차이