Github Actions로 CI 자동화 구축1

Sang_WJ·2025년 5월 18일

Github Actions CI/CD 자동화 구축

목록 보기

1/2

팀 프로젝트를 진행하며 GitHub Actions를 활용해 CI 자동화를 구축하는 과정에서 생각보다 많은 시행착오를 겪었다.
이 글은 그 과정에서 겪었던 트러블슈팅과 설정 이슈들을 정리한 기록이다.
앞으로 나 자신은 물론, GitHub Actions를 처음 접하는 다른 팀원들도 같은 문제로 헤매지 않기를 바라는 마음에서 정리하게 되었고,
이 과정을 명확히 이해하고 넘어가는 것이 나중에 배포 환경까지 이어지는 데에도 훨씬 수월할 것이라 생각한다.

1. .env 값이 GitHub Actions에서 어떻게 주입되는가?

📁 .env 파일 예시

DB_DRIVER=com.mysql.cj.jdbc.Driver
DB_HOST=localhost
DB_PORT=3306
DB_NAME=test_db
DB_USERNAME=test_user
DB_PASSWORD=test_password

이런 값들은 일반적으로 application.yml이나 docker-compose.yml에서 ${} 형태로 사용된다.

🧩 GitHub Actions에서의 환경변수 주입 방식

# workflows.yml
- name: Build and Test
  env:
    DB_DRIVER: ${{ secrets.DB_DRIVER }}
    DB_HOST: ${{ secrets.DB_HOST }}
    DB_PORT: ${{ secrets.DB_PORT }}
    DB_NAME: ${{ secrets.DB_NAME }}
    DB_USERNAME: ${{ secrets.DB_USERNAME }}
    DB_PASSWORD: ${{ secrets.DB_PASSWORD }}
  run: ./gradlew clean build

👉 GitHub Actions에서는 .env 파일을 직접 불러오지 않고,
GitHub Settings > Secrets에 등록된 값들을 ${{ secrets.XXX }} 형태로 불러와 env:에 직접 주입한다.

🔄 반면 docker-compose.yml이나 application.yml에서는 .env를 자동으로 읽거나 ${}를 통해 참조한다.

2. services.mysql은 GitHub Actions 안에서 어떻게 동작하는가?

# workflows.yml
services:
  mysql:
    image: mysql:latest
    env:
      MYSQL_DATABASE: ${{ secrets.DB_NAME }}
      MYSQL_ROOT_PASSWORD: root
      MYSQL_USER: test_user
      MYSQL_PASSWORD: ${{ secrets.DB_PASSWORD }}
    ports:
      - 3306:3306

🔍 설명:
• GitHub Actions가 띄우는 임시 VM 안에서 MySQL 컨테이너를 구동한다.
• 이 컨테이너는 CI 과정 동안만 살아 있고, 워크플로우 종료 시 자동으로 종료된다.
• 위 설정은 MySQL 공식 Docker 이미지에서 인식 가능한 환경변수 이름을 따라야 하며,
문법은 MySQL Docker 이미지 문서 기준으로 작성해야 한다.

3. MySQL 설정 문법을 따라야 하는 이유

MySQL 공식 이미지가 docker-entrypoint.sh에서 인식하는 환경변수는 다음과 같다.

환경 변수 설명
MYSQL_ROOT_PASSWORD 루트 계정 비밀번호 (필수)
MYSQL_DATABASE 초기 생성할 DB 이름
MYSQL_USER 초기 생성할 일반 사용자
MYSQL_PASSWORD 해당 유저의 비밀번호

❗ 여기에 존재하지 않는 변수명(ex. DB_HOST)을 넣어도 MySQL 컨테이너는 무시하거나 에러를 낼 수 있음

4. application.yml과 docker-compose.yml, workflow.yml의 차이점 정리

항목 위치 주요 역할 .env 사용 방식
application.yml Spring Boot 내부 설정 애플리케이션 실행 설정 (DB, JPA 등) ${}로 참조 (Spring이 해석)
docker-compose.yml 로컬 개발 환경 구성 DB 등 서비스 컨테이너 정의 env_file: 또는 ${} 사용 가능
workflow.yml GitHub Actions 워크플로우 CI 자동화 프로세스 정의 env:로 명시적으로 선언
.env 루트 또는 도커 내부 변수 통합 저장 Spring과 Compose에서 자동 인식 or GitHub Secrets로 분리 등록