Github Actions 톺아보기

 

 

Github Actions의 기본 개념

 

일단 Github Actions는 소프트웨어 개발 워크플로우를 자동화할 수 있는 CI/CD 도구임

=> 코드가 변경될 때마다 빌드, 테스트, 배포 등의 작업을 자동으로 실행할 수 있음

 

Github Actions는  Github 내에서 바로 실행되기에 추가 설정이 적어 난이도가 비교적 쉽고 

PR이나 커밋, 이슈, 태그 등 다양한 Github의 이벤트에 반응이 가능함!

(퍼블릭 레포지토리 기준으로 무료임)

 

구성 요소

 

우선 한 번 쭉 읽어보고 밑의 예제 코드를 살펴보면 이해가 더 쉬움

 

Workflow

 

Github Actions에서 실행되는 자동화된 프로세스로 .github/workflows/ 디렉토리에 .yml 파일로 정의됨

=> 하나 이상의 Job으로 구성되고 push, pull_request와 같은 특정 이벤트에 의해 실행됨

 

Job

 

Workflow 내에서 실행되는 독립적인 작업 단위로 여러 개의 Step으로 구성됨

 

=> 서로 다른 Job은 기본적으로 병렬로 실행되지만, needs 키워드를 사용하면 특정 Job이 끝난 후 실행되도록 의존 관계를 설정할 수 있음

 

 

Step

 

Job 내에서 순차적으로 실행되는 개별 작업 단위 

 

=> 실행할 명령어를 포함하거나 Action을 사용할 수 도 있음

 

 

Action

 

Step에서 사용할 수 있는 개별적인 실행 단위임

=> GitHub에서 제공하는 공식 Action을 사용할 수 도 있고 커뮤니티에서 만든 Action 혹은 직접 만든 Action도 사용 가능

 

 

Runner

 

Job을 실행하는 가상 머신 또는 컨테이너임

 

=> GitHub에서 제공하는 GitHub-hosted runner를 사용할 수 도 있고 self-hosted runner(자체 호스팅 환경)을 구성할 수 도 있음

 

(Github Actions는 ubuntu, windows, macos 등의 다양한 Runner를 사용할 수 있다는 장점이 있음!!)

 

 

예제 코드

 

name: Spring Boot CI/CD  # Workflow 이름

on:
  push:
    branches:
      - main  # main 브랜치에 push될 때 실행

jobs:
  build: # 첫 번째 Job
    runs-on: ubuntu-latest  # Runner (Ubuntu 사용)

    steps:
      - name: 코드 체크아웃 # (GitHub Actions Runner에 레포지토리의 소스 코드 가져오는 과정임)
        uses: actions/checkout@v4  # 레포지토리 코드 가져오기 
        #(actions/checkout은 이 과정을 자동으로 수행하는 공식 GitHub Action임 @v4는 버전)

      - name: JDK 17 설치
        uses: actions/setup-java@v3  # OpenJDK 17 설치
        # actions/setup-java는 Java 환경(JDK)를 설정하는 역할
        with:
          distribution: 'temurin' # OpenJDK 기반의 무료 JDK 배포판
          java-version: '17'

      - name: Gradle 실행하여 빌드
        run: ./gradlew build  # ✅ Gradle로 Spring Boot 빌드

  deploy: # 두 번째 Job
    runs-on: ubuntu-latest
    needs: build  # build Job이 성공해야 실행됨

    steps:
      - name: 서버에 배포
        run: echo "서버에 JAR 배포 (실제 서버 배포 명령어 작성 필요)"