CD 파이프라인 구축

정의

CD : Continuous Deployment, 지속적 배포

필요한 이유/원하는 것

개발자의 변경 사항을 레포지토리에서 프로덕션으로 릴리스하는 것을 자동화하여 고객이 사용할 수 있도록 한다

동작 프로세스

CD 동작 프로세스

---

CD를 위한 Github Actions 구축 방법 정리

기본 정보는 CI 파이프라인 구축 을 참고

0. Github Actions에 Self-hosted Runner 등록

Self-hosted Runner 란?
Github Actions에서 사용자가 지정하는 로컬 컴퓨팅 자원으로 빌드를 수행하도록 설정하는 기능입니다.

1) Settings - Actions - Runners 이동 및 New self-hosted runner 클릭

2) runner로 등록한 자원에 맞게 환경 설정

우리는 Linux의 armx64 을 사용한다

3) runner로 등록한 자원으로 이동 후 명령어 실행

Download

• 폴더 생성

mkdir actions-runner && cd actions-runner

• 가장 최신의 Runner 패키지 다운로드

curl -o actions-runner-linux-arm64-2.317.0.tar.gz -L https://github.com/actions/runner/releases/download/v2.317.0/actions-runner-linux-arm64-2.317.0.tar.gz

• 다운로드 받은 압축 파일 압축 해제

tar xzf ./actions-runner-linux-arm64-2.317.0.tar.gz

Configure

• 저장소 연결

./config.sh --url [repository url] --token [github token]

• runner 프로그램 실행

nohup ./run.sh &

Using your self-hosted runner

• job 실행 환경 설정

runs-on: self-hosted

1. Secrets 추가

우리는 secrets.WORK_DIRECTORY 가 필요하니, WORK_DIRECTORY의 값을 설정한다.

2. 최상위 디렉터리에 .github/workflows/backend_cd.yml 파일 생성

build.yml 파일 이름은 가장 적절한 이름으로 네이밍한다.

3. build.yml 파일 작성

1)workflow 이름 설정

name: CI # workflow 이름

• workflow 이름을 적절하게 네이밍
• workflow 안에는 여러 개의 job이 존재

2) 실행조건 설정

설정된 브랜치로 push되면 jobs 실행

on: 
  push:
    branshes: # 설정된 브랜치
      - branch1 

설정된 브랜치로 pull-request 되면 jobs 실행

on: 
  pull_request:
    branshes: # 설정된 브랜치
      - branch1 

이 외에도 실행 조건은 다양하다.

3) jobs 설정

jobs:
  build: # jar 파일 빌드해주는 job
    # ...
  deploy: # 서버 배포를 해주는 job
    #...

jar 파일 빌드

job 명 : build

build:  
  runs-on: ubuntu-latest # 작업 환경: 가상 환경 우분투로
  env: # 필요한 환경 변수 제작 
    build-directory: ./backend  
  steps: # 입력된 작업 순서대로 실행
    # 작업 실행

서버 배포

job 명 : deploy

deploy:  
  needs: build # job 명이 build인 job이 성공하면 작동한다
  runs-on: self-hosted # 작업 환경: self-hosted runner 환경에서
  steps: # 입력된 작업 순서대로 실행
    # 작업 실행