[Docker] 도커로 Jenkins😀 서버 만들어보기

 

 

이번 포스팅에서는 Docker를 사용해 Jenkins 서버를 구축하고,

Jenkins 내부에서 Docker 명령어를 사용할 수 있도록 설정하는 방법을 다룹니다. CI/CD 파이프라인 구축을 준비하는 단계로 활용할 수 있습니다.

 

---

1. Jenkins 컨테이너 실행

Jenkins를 Docker 컨테이너에서 실행하려면 먼저 Jenkins 이미지를 가져오고, 컨테이너를 기동해야 합니다.

 

1.1 Docker 설치 확인

먼저, Docker가 설치되어 있는지 확인합니다. 설치되지 않았다면 Docker 공식 문서를 참고하여 설치하세요.

docker --version

 

1.3 Jenkins 컨테이너 실행

Jenkins 컨테이너를 실행할 때 Docker 소켓 공유를 통해 컨테이너 내부에서도 Docker 명령어를 사용할 수 있도록 설정합니다.

docker run -v /var/run/docker.sock:/var/run/docker.sock \
           -v jenkins_home:/var/jenkins_home \
           -p 7070:8080 \
           --name jenkins-container \
           -d jenkins/jenkins:lts

 

• -v /var/run/docker.sock:/var/run/docker.sock
  호스트의 Docker 소켓을 컨테이너에 공유합니다.
• -v jenkins_home:/var/jenkins_home
  Jenkins 데이터를 지속적으로 저장할 수 있도록 볼륨을 설정합니다.
• -p 7070:8080
  호스트의 포트 7070을 컨테이너의 포트 8080에 매핑합니다.
• --name jenkins-container
  컨테이너 이름을 jenkins-container로 지정합니다.

💡 참고:Docker 컨테이너는 백그라운드에서 실행되므로 -d 옵션을 사용합니다.

---

 

2. Jenkins 초기 설정

2.1 Jenkins 웹 인터페이스 접속

브라우저에서 아래 URL로 접속합니다

http://localhost:7070

 

2.2 초기 관리자 비밀번호 확인

Jenkins를 처음 실행하면 초기 비밀번호를 요구합니다. 아래 명령어로 확인하세요.

docker exec -it jenkins-container cat /var/jenkins_home/secrets/initialAdminPassword

 

2.3 플러그인 설치

Jenkins 웹 UI에 로그인한 후, 권장 플러그인을 설치합니다.

필요에 따라 Pipeline, Git, Docker 관련 플러그인을 추가로 설치하세요.

---

 

3. Jenkins 컨테이너 내부에서 Docker 명령어 사용하기

Jenkins 내부에서 Docker 명령어를 사용하려면 Docker CLI를 설치해야 합니다. 또한 권한 문제를 해결하기 위해 몇 가지 설정이 필요합니다.

 

3.1 Jenkins 컨테이너에 Root 권한으로 접속

docker exec -it -u root jenkins-container /bin/bash

 

💡 참고: -u root 옵션으로 Root 사용자로 접속합니다.

 

3.2 Docker CLI 설치

컨테이너 내부에서 다음 명령어를 순서대로 실행하세요.

# 패키지 업데이트
apt-get update

# 필수 패키지 설치
apt-get install -y apt-transport-https ca-certificates curl gnupg2 software-properties-common

# Docker GPG 키 추가
curl -fsSL https://download.docker.com/linux/debian/gpg | apt-key add -

# Docker 저장소 추가
add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/debian $(lsb_release -cs) stable"

# 패키지 목록 업데이트
apt-get update

# Docker CLI 설치
apt-get install -y docker-ce-cli

 

 

 

3.3 Docker 권한 문제 해결

권한 문제로 Docker 명령어가 작동하지 않을 수 있습니다. 아래 명령어로 소켓 권한을 설정하세요.

sudo chmod 666 /var/run/docker.sock

---

 

4. Jenkins와 Docker 연동 테스트

모든 설정이 완료되면 Jenkins 내부에서 Docker 명령어가 정상적으로 작동하는지 확인합니다.

 

4.1 Docker 상태 확인

컨테이너 내부에서 다음 명령어를 실행합니다.

docker ps

 

Docker 컨테이너 목록이 출력되면 연동이 성공적으로 완료된 것입니다.

---

 

5. Jenkins와 CI/CD 환경 준비

Jenkins에서 Docker를 활용해 CI/CD 파이프라인을 구축할 준비가 완료되었습니다.

다음 단계에서는 다음과 같은 작업을 진행할 수 있습니다

1. GitHub에서 코드 가져오기
2. Docker 이미지 빌드 및 컨테이너 실행
3. 자동 배포 파이프라인 구성

 

마무리

이번 포스팅에서는 Docker 환경에서 Jenkins 서버를 구축하고, 내부에서 Docker 명령어를 사용할 수 있도록 설정하는 방법을 알아봤습니다. Jenkins를 활용해 CI/CD 파이프라인을 구축하고자 한다면, 이 과정을 기반으로 자동화 시스템을 설계해 보세요