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

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

 

구글링 하면서 독학을 했고, 무수한 삽질과 이전 프로젝트들의 문서와 주변 동기들의 도움을 받은 끝에 내 프로젝트의 환경에 맞게 CI/CD를 구축할 수 있었다! 부족한 부분도 있지만(무중단 배포 X, docker-compse 사용 X, 보안 신경 못씀) 스스로 Docker, Jenkins의 개념을 공부하고, 바로 팀 프로젝트에 적용했다는 점에서 좋았다.

 

삽질하면서 배운 것을 안 까먹고자, 그리고 누군가에게 도움이 되고자 과정을 정리해보려고 한다.

 

 

 

 

 

3개의 포스팅에 나눠서 다음과 같은 내용으로 진행될 것이다.

1. Docker 설치하기 + 수동 배포

2. 자동 배포를 위한 Jenkins 설치하기

3. GitLab Webhook과 Jenkinsfile 활용하여 배포 파이프라인 구축하기

 

 

 

 

 

💻 환경

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

 

 

 

 

📐 프로젝트 구조도

아키텍처(수정됨)

• 백엔드 6개(그림상에는 5개 맞음), DB 2개, Jenkins(Docker in docker로 했다) 총 9개의 컨테이너를 만들 것이다.
• GitLab에서 push 이벤트가 발생할 때마다 해당 마이크로 서비스가 자동으로 배포되도록 할 것이다.

 

 

 

 

CI/CD 과정

 

 

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

 

 

 

 

 

이 포스팅에서 다루는 내용은 4~8까지의 과정으로 Docker 설치를 하고, 우선 도커로 수동으로 배포하는 방법이다.

그리고 다음 포스팅에서 Jenkins를 설치해서 1~3 과정을 실행하고, 4~8을 자동으로 배포하는 과정을 다룬다.

 

 

 

 

 

---

🐳 Docker 설치

Ubuntu 서버에 Docker를 설치한다. 설치 과정은 공식 문서를 참고했다.

(https://docs.docker.com/engine/install/ubuntu/)

 

 

 

• apt 패키지 업데이트 및 설치

sudo apt-get update
sudo apt-get install \
    ca-certificates \
    curl \
    gnupg

 

• Docker GPG key 추가

sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

 

• 저장소 설정

echo \
  "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

 

• Docker Engine 설치

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

 

 

 

 

 

 

🐳 Dockerfile 작성

Spring Cloud(Gateway, Eureka) Service와 각각의 마이크로 서비스들은 모두 동일한 환경인 Gradle, Java11에서 돌아간다. 그래서 하나의 Dockerfile를 만들어줬다.

 

 

 

FROM openjdk:17-ea-11-jdk-slim
VOLUME /tmp
ARG JAR_FILE=build/libs/*jar
COPY ${JAR_FILE} app.jar
ENTRYPOINT ["java", "-jar", "app.jar"]

 

Java11 jdk로 빌드를 할 것이다. Spring boot 프로젝트를 빌드하게 되면 `build/libs` 아래 jar 파일이 생성된다. 생성된 jar 파일을 `app.jar` 파일이라는 이름으로 복사해 Docker의 image로 만들겠다는 의미이다.

 

• `FROM` : 이미지의 이름(Docker Hub에서 검색해서 찾으면 됨)
• `VOLUME` : 가상의 디렉토리
• `COPY` : 현재 디렉토리의 파일 → 컨테이너 내로 복사
• `ENTRYPOINT` : 이미지가 실행될 때 수행할 커맨드

 

 

 

 

 

Dockerfile이 위치하는 경로는 Spring boot 프로젝트 바로 아래이다.

 

 

 

 

 

 

여기까지 한다면 아래의 명령어들을 통해 원격 서버에 수동 배포가 가능하다.

 

 

 

 

 

수동 배포 과정

(프로젝트의 터미널에서)

• 프로젝트에서 이미지 생성

docker build -t [Docker Hub 계정]/[이미지 이름]

 

• Docker Hub에 이미지 업로드

docker push [Docker Hub 계정]/[이미지 이름]

 

 

 

(Ubuntu에서)

• Docker 이미지 가져오기

docker pull [Docker Hub 계정]/[이미지 이름]

 

• Docker 이미지 실행

docker run --name [컨테이너 이름] -d -p [포트번호]:[포트번호] [Docker hub 계정]/[이미지 이름]

 

 

 

 

 

자동 배포의 필요성

 개별 프로젝트에 변경 사항이 생길 때마다 기존의 Docker 컨테이너를 중단시키고, 지우고, 새로 Docker 이미지를 만들고, 업로드하고, 실행시켜 배포하는 일은 번거롭다. 이를 자동으로 처리해 줄 필요성이 느껴진다.

 

 그리고 매번 로컬에서 명령어를 쳐서 수동으로 배포를 할 수가 없다. 변경된 부분을 Git 저장소로 push 할 때마다 최종본인 그 버전으로 배포를 하고 싶다.

 

 지속적 통합과 자동 배포를 해야 하는데, 이를 하기 위해서는 Jenkins를 사용해야 한다. 다음 포스팅에서 Jenkins를 설치하고, Webhook을 통한 CI/CD를 구축하는 방법에 대해 설명하도록 하겠다.