프리온보딩 BE 챌린지 8월 사전 과제 - CICD 파이프라인 구축

전체적인 CICD 파이프라인

개발 환경에서 GitHub Actions를 활용하여 손쉽게 CICD 파이프라인을 구축할 수 있다.

물론, self-hosted runner를 사용하면, 한번에 테스트와 배포를 진행할 수 있지만, 적당히 책임을 분산시켜서 운영해주는것이 좋다.

이 포스팅에서는 GitHub Actions를 활용하여 도커 이미지를 빌드하고, Docker Hub에 업로드한 후, Watchtower를 통해 개발 서버에 배포하는 방법을 설명한다.

flowchart LR;

    subgraph Local[로컬 개발 환경]
        direction TB
        A[개발] -->|Commit| A1[로컬 Git]
    end

    Local -->|Push| GitHub

    subgraph GitHub[GitHub]
        direction TB
        B[저장소] -->|GitHub Actions 실행| B1[테스트 진행]
        B1 -->|성공 시| B2[OCI 이미지 패키징]
    end

    GitHub -->|DockerHub에 업로드| DockerHub


    subgraph DockerHub[Docker Hub]
        direction TB
        D2[Main 이미지] ~~~ D3
        D3[Dev 이미지] ~~~ D4
        D4[Feature 이미지] 
    end

    subgraph Dev[개발 서버]
        direction TB
        Watchtower[Watchtower] -->|주기적 Polling 새로운 이미지 감지 | C[OCI 이미지 Pull]
        C --> D[컨테이너 교체]
    end

    DockerHub --- |Polling| Dev

Docker Hub

도커 허브에 이미지를 업로드 하기 위해서 먼저 레포지토리를 생성해야 한다.

여기서는 portfolio-server라는 이름으로 레포지토리를 생성했다.

GitHub Actions

설정 위치	Key	설명	example
Variable	DOCKER_USERNAME	Docker Hub ID	cmsong111
Secrets	DOCKER_PASSWORD	Docker Hub 토큰	dckr_pat_...

Dev Server

개발서버는 도커 환경의 온 프레미스 서버를 가정하고 작성했다.

services:
  watchtower:
    image: containrrr/watchtower:latest
    container_name: watchtower
    restart: always
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - WATCHTOWER_POLL_INTERVAL=30
      - WATCHTOWER_CLEANUP=true

services:
  portfolio-server:
    image: cmsong111/portfolio-server:latest
    container_name: portfolio-server
    restart: always
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=dev

새로운 이미지가 없을 떄

새로운 이미지가 없을 경우, 기존 컨테이너를 유지한다.

time="2025-03-25T11:40:35+09:00" level=info msg="Session done" Failed=0 Scanned=11 Updated=1 notify=no

새로운 이미지가 있을 때

새로운 이미지를 내려받은후, 해당 컨테이너를 삭제하고 새로운 컨테이너를 생성한다.

time="2025-03-25T11:40:20+09:00" level=info msg="Found new portainer/portainer-ce:latest image (7f10a26bfdda)"
time="2025-03-25T11:40:33+09:00" level=info msg="Stopping /portainer (6e0de4c471ef) with SIGTERM"
time="2025-03-25T11:40:34+09:00" level=info msg="Creating /portainer"
time="2025-03-25T11:40:35+09:00" level=info msg="Removing image 60ce692bb8b5"

Reference

GitHub - cmsong111/Wanted-PreOnBoarding-Backend-Challenge: 원티드 8월 프리온보딩 백엔드 챌린지 (게시글 CRUD)

원티드 8월 프리온보딩 백엔드 챌린지 (게시글 CRUD). Contribute to cmsong111/Wanted-PreOnBoarding-Backend-Challenge development by creating an account on GitHub.

github.com