[Infra] Docker, Jenkins를 이용하여 MSA 프로젝트 CI/CD 구축하기(2) - Jenkins 설치

이 시리즈에서는 MSA 프로젝트를 생성한 뒤, Docker와 Jenkins를 이용하여 CI/CD를 구축하는 과정을 설명하도록 하겠다.

 

이전 포스팅에서는 Docker를 설치와 수동 배포 과정과 자동 배포의 필요성에 대해 설명했었다.

 

https://programmingiraffe.tistory.com/123

[Infra] Docker, Jenkins를 이용하여 MSA 프로젝트 CI/CD 구축하기(1) - Docker 설치

 

 

 

 

 

 

이번 포스팅에서는 지속적 통합과 자동 배포를 위해 필요한 Jenkins 설치 과정에 대해 설명하도록 하겠다.

 

 

 

 

 

💻 환경

• OS : Window
• Server : AWS EC2
• Backend : Spring boot, Spring Cloud(Gateway, Eureka), Gradle, Java11
• Deploy : Docker, Dockerhub, Jenkins
• Git : Gitlab

 

 

 

 

 

📐 프로젝트 구조도

아키텍처(수정됨)

 

 

 

 

 

CI/CD 과정

 

 

 

1. 소스코드가 해당 브랜치에 push 된다. (푸쉬 이벤트 발생)
2. 프로젝트 내의 Jenkinsfile을 읽어 실행한다.
3. Git에 있는 프로젝트를 Clone해, 빌드를 한다.
4. jar 파일이 생성되고, 도커 이미지로 빌드한다.
5. 도커 이미지를 도커 허브에 업로드 한다.
6. 지금 도커에서 run 되고 있는 해당 이미지를 중지하고, 삭제시킨다.
7. 그리고 도커 허브에 있던 새 이미지를 받아 run 한다.
8. Spring 서버가 도커 컨테이너로 AWS에 배포된다.

 

 

 

 

Jenkins를 이용하면, 위와 같은 과정을 자동으로 실행할 수 있다.

 

 

 

 

 

🤵 Jenkins 설치

Docker in docker 방식으로 Jenkins를 설치했다.

 

 

• 젠킨스 설치시 아래 옵션을 추가해 도커의 소켓 파일 마운트

sudo mkdir /home/opendocs/jenkins
sudo docker run \\
--name jenkins \\
-d \\
-p 8080:8080 \\
-p 50000:50000 \\
-v /home/opendocs/jenkins:/var/jenkins_home \\
-v /var/run/docker.sock:/var/run/docker.sock \\
-u root \\
jenkins/jenkins:lts

 

 

 

• Jenkins 컨테이너 접속

docker exec -it jenkins /bin/bash

 

 

 

• Jenkins 안 Docker 설치

이걸 안하면 Jenkins 안에 Docker가 없기 때문에 나중에 docker 명령어를 실행할 수 없다며 에러가 뜬다.

 

# Docker 설치
## - Old Version Remove
apt-get remove docker docker-engine docker.io containerd runc
## - Setup Repo
apt-get update
apt-get install \\
    ca-certificates \\
    curl \\
    gnupg \\
    lsb-release
mkdir -p /etc/apt/keyrings
curl -fsSL <https://download.docker.com/linux/debian/gpg> | gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo \\
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] <https://download.docker.com/linux/debian> \\
  $(lsb_release -cs) stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null
## - Install Docker Engine
apt-get update
apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

 

 

 

 

 

🤵 Jenkins 접속

• 도메인주소:8080 으로 접속한다.

Jenkins 설치 시, 포트 번호를 다르게 설정해줬으면 그 포트 번호를 붙여준다.

 

 

 

 

암호를 입력해줘야 하는데, 빨강색 글씨로 나온 경로로 접속해서 관리자 비밀번호를 알아내야 한다.

 

 

 

• 관리자 비밀번호 알아내기

cat /var/jenkins_home/secrets/initialAdminPassword

 

 

 

• 플러그인 설치

Install suggested plugins을 선택한다.

 

 

 

• Jenkins URL 설정

Save and Finish를 누르고 마치면 된다.

 

 

 

 

 

다음 포스팅에서 GitLab Webhook과 Jenkinsfile을 활용하여 배포 파이프라인 구축을 구축하는 방법을 설명하도록 하겠다.