[CI/CD] Docker와 CI/CD 파이프라인 구축 - 실습편

🧷 CI/CD 란 무엇인가? - 이론편

개발 환경

AWS EC2 Free tier - Operating System : Ubuntu 24.04 Server
Docker - Docker Hub
Spring Boot 3.3.1 - Gradle, JDK17
GitHub - Action

---

1. GitHub Actions Repository Secret 설정

1. Github Repository -> Settings -> Secrets and Variables -> Actions
2. 아래 3가지 secrets 추가

Name : DOCKERHUB_USERNAME | Your DockerHub Username
Name : DOCKERHUB_PASSWORD | Your DockerHub Password
Name : APPLICATION_YML | Your SpringBoot Project application.yml Content

📌 Secret 설정을 왜 하는가?

---

2. Spring Boot 프로젝트에 Dokerfile 생성

# Dockerfile

# jdk17 Image Start
FROM openjdk:17

ARG JAR_FILE=build/libs/book-0.0.1-SNAPSHOT.jar
ADD ${JAR_FILE} book_Backend.jar
ENTRYPOINT ["java","-jar","book_Backend.jar"]

• FROM baseImage : Docker 이미지 빌드 시 사용할 기본 이미지 지정
• ARG(Build Argument) : JAR_FILE 변수를 정의해, 빌드 시 사용할 JAR 파일의 경로를 지정
• ADD(Add JAR File) : 지정된 JAR 파일을 이미지에 추가
• ENTRYPOINT : 컨테이너가 시작될 때 실행할 명령을 지정

이제 이 Dockerfile을 사용하여 Docker 이미지를 빌드하고 실행하면, 컨테이너 내에서 Java 17 환경에서 Spring Boot 애플리케이션이 실행된다!

📌 자세한 설명

---

3. Github Actions - CI

1. Github Repository -> Actions -> Java with Gradle -> Configure

name: Java CI with Gradle

on:
  push:
    branches: [ "develop" ]

permissions:
  contents: read

jobs:
  # Spring Boot 애플리케이션을 빌드하여 도커허브에 푸시하는 과정
  build-docker-image:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v3
    # 1. Java 17 세팅
    - name: Set up JDK 17
      uses: actions/setup-java@v3
      with:
        java-version: '17'
        distribution: 'temurin'

    # 2. application.yml 파일 생성
    - name: Create application.yml
      run: |
        mkdir -p src/main/resources
        echo "${{ secrets.APPLICATION_YML }}" > src/main/resources/application.yml

    # 3. Spring Boot 애플리케이션 빌드
    - name: Build with Gradle
      uses: gradle/gradle-build-action@67421db6bd0bf253fb4bd25b31ebb98943c375e1
      with:
        arguments: clean bootJar

    # 4. Docker 이미지 빌드
    - name: docker image build
      run: docker build -t ${{ secrets.DOCKERHUB_USERNAME }}/book_cicd_action .

    # 5. DockerHub 로그인
    - name: docker login
      uses: docker/login-action@v2
      with:
        username: ${{ secrets.DOCKERHUB_USERNAME }}
        password: ${{ secrets.DOCKERHUB_PASSWORD }}

    # 6. Docker Hub 이미지 푸시
    - name: docker Hub push
      run: docker push ${{ secrets.DOCKERHUB_USERNAME }}/book_cicd_action

• on : 트리거 이벤트를 정의

  • push: branches: [ "develop" ] : 'develop' 브랜치에 push 이벤트가 발생할 때 workflow 실행

• permissions : workflow에서 사용할 권한을 설정

  • contents: read : workflow는 저장소의 콘텐츠를 읽을 수 있는 권한을 가짐

• jobs : 작업(job)을 정의 (여러 개 정의 가능)

  • runs-on: ubuntu-latest : 최신 버전의 Ubuntu를 사용하는 가상 환경에서 실행
  • steps : 작업을 수행하기 위한 단계(step)들을 정의

---

4. EC2 Ubuntu 서버에 Docker 설치

#1. 프로그램 설치 전 Ubuntu 시스템 패키지 업데이트
sudo apt-get update

#2. 필요한 패키지 설치
sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common

#3. Docker의 공식 GPG키 추가
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

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

#5. 시스템 패키지 업데이트
sudo apt-get update

#6. Docker 설치
sudo apt-get install docker-ce docker-ce-cli containerd.io

#7. Docker 설치 확인
sudo systemctl status docker

위 사진과 같이 Active: active (running) 이 뜨면 Docker 설치 성공!

---

5. GitHub Actions Runner (self-hosted runner) 설정

1. Github Repository -> Settings -> Code and automation -> Actions -> Runners -> New self-hosted runner -> New self-hosted runner

2. Runner Image : Linux (Ubuntu를 사용하기 때문에) (+1서버에 N개 runner를 설치해도 잘 작동한다)

3. 아래 Download / Configure 에 나와있는 코드를 본인의 운영 환경(EC2 서버)에 접속해서 순차적으로 실행시키면 된다.

   

4. 마지막으로 아래 두 명령어를 실행한다.

sudo ./svc.sh install
sudo ./svc.sh start

📌 자세한 설명

---

6. GitHub Actions - CD

1. .github/workflows/gradle.yml 파일에 아래 코드를 입력한다.

# 위 과정에서 푸시한 이미지를 ec2에서 풀받아서 실행시키는 과정 
  run-docker-image-on-ec2:
    # build-docker-image (위)과정이 완료되어야 실행됩니다.
    needs: build-docker-image
    runs-on: self-hosted

    steps:
      # 1. 최신 이미지를 풀받습니다
      - name: docker pull
        run: sudo docker pull ${{ secrets.DOCKERHUB_USERNAME }}/book_cicd_action
      
      # 2. 기존의 컨테이너를 중지시킵니다
      - name: docker stop container
        run: sudo docker stop $(sudo docker ps -q) 2>/dev/null || true

      # 3. 최신 이미지를 컨테이너화하여 실행시킵니다
      - name: docker run new container
        run: sudo docker run --name github-actions-demo --rm -d -p 8080:8080 ${{ secrets.DOCKERHUB_USERNAME }}/book_cicd_action

      # 4. 미사용 이미지를 정리합니다
      - name: delete old docker image
        run: sudo docker system prune -f

초록색이 뜨면 성공!