GitHub 오픈소스 탐험

소프트웨어 개발에서 코드의 품질과 배포의 효율성을 높이는 데 있어 CI/CD(지속적인 통합 및 지속적인 배포)는 필수적인 요소입니다. 최근 많은 개발자들이 GitHub Actions를 통해 CI/CD 파이프라인을 구축하고 있으며, 그 핵심에 위치한 것이 바로 GitHub Actions Runner입니다. 이 오픈소스 프로젝트는 GitHub Actions의 워크플로우에서 작업을 실행하는 애플리케이션으로, 사용자의 환경에 맞게 셀프 호스팅할 수 있는 유연성을 제공합니다. 이번 포스트에서는 GitHub Actions Runner의 주요 기능과 설치 방법, 그리고 실무에서 어떻게 활용할 수 있는지를 살펴보겠습니다.

GitHub Actions Runner란?

GitHub Actions Runner는 GitHub Actions의 작업을 실행하는 애플리케이션입니다. GitHub의 호스팅된 가상 환경에서 실행되거나, 사용자가 직접 관리하는 서버에서 셀프 호스팅할 수 있습니다. 이로 인해 개발자는 다양한 환경에서 CI/CD 파이프라인을 유연하게 설정하고 관리할 수 있습니다. 특히, 특정한 환경에서의 테스트를 요구하는 프로젝트나, 보안상의 이유로 내부 서버에서 작업을 수행해야 하는 경우에 유용합니다.

주요 기능 및 특징

유연한 셀프 호스팅: 사용자는 자신의 서버에 Runner를 설치하여 특정 환경에서 작업을 실행할 수 있습니다. 이를 통해 특정 라이브러리나 도구가 설치된 환경에서만 필요한 작업을 수행할 수 있습니다.
다양한 운영체제 지원: Windows, macOS, Linux 모든 운영체제에서 사용할 수 있어 플랫폼에 구애받지 않고 CI/CD 파이프라인을 구축할 수 있습니다.
비용 절감: 셀프 호스팅 Runner를 사용함으로써 GitHub의 유료 서비스를 사용할 필요 없이, 개발자는 자원을 효율적으로 관리할 수 있습니다.
커스터마이징: Runner의 설정을 통해 다양한 빌드 및 배포 환경을 손쉽게 구성할 수 있으며, 필요에 따라 추가적인 도구를 설치하여 사용할 수 있습니다.

설치 및 기본 사용법

1. 설치 준비

먼저 GitHub Actions Runner를 설치하기 위한 사전 준비가 필요합니다. 다음의 링크에서 운영체제에 맞는 설치 가이드를 참조하세요:

2. Runner 다운로드 및 설치

아래는 Linux 시스템에서 Runner를 설치하는 기본 예제입니다.

# 필요한 패키지 설치
sudo apt-get install -y software-properties-common
sudo add-apt-repository ppa:git-core/ppa
sudo apt-get update
sudo apt-get install -y git

# GitHub에서 Runner 다운로드
mkdir actions-runner && cd actions-runner
curl -o actions-runner-linux-x64.tar.gz -L https://github.com/actions/runner/releases/download/v2.300.0/actions-runner-linux-x64-2.300.0.tar.gz
tar xzf ./actions-runner-linux-x64.tar.gz

# Runner 설정
./config.sh --url https://github.com/{your-username}/{your-repo} --token YOUR_RUNNER_TOKEN

# Runner 실행
./run.sh

위 스크립트에서 {your-username}과 {your-repo}는 본인의 GitHub 사용자명과 저장소명을 입력해야 하며, YOUR_RUNNER_TOKEN은 GitHub에서 생성한 Runner 등록 토큰입니다.

3. GitHub Actions 워크플로우 설정

Runner를 설치한 후, GitHub 저장소의 .github/workflows 폴더에 아래와 같은 YAML 파일을 생성하여 CI/CD 파이프라인을 설정할 수 있습니다.

name: CI

on:
  push:
    branches:
      - main

jobs:
  build:
    runs-on: self-hosted
    steps:
      - name: 체크아웃 코드
        uses: actions/checkout@v2
      
      - name: 빌드
        run: |
          echo "Building the project..."
          # 여기에 빌드 명령어를 추가하세요.
      
      - name: 테스트
        run: |
          echo "Running tests..."
          # 여기에 테스트 명령어를 추가하세요.

이 YAML 파일은 main 브랜치에 푸시가 발생할 때마다 셀프 호스팅 Runner에서 빌드 및 테스트 작업을 실행합니다.

실무에서의 활용 시나리오

GitHub Actions Runner는 다양한 실무 시나리오에서 유용하게 활용될 수 있습니다. 예를 들어, 기업 내부에서 보안 정책에 따라 코드가 외부 서버에서 실행되지 않도록 해야 할 때, 셀프 호스팅 Runner를 통해 안전한 환경에서 CI/CD 파이프라인을 구축할 수 있습니다. 또한, 특정 라이브러리나 도구가 필요한 경우(예: 특정 버전의 JDK나 데이터베이스) Runner의 환경을 쉽게 커스터마이징하여 사용할 수 있습니다.

비슷한 도구와의 비교

GitHub Actions Runner 외에도 Jenkins, CircleCI, Travis CI와 같은 CI/CD 도구가 존재합니다. 이들 도구는 각각의 장단점이 있지만, GitHub Actions는 GitHub와의 통합이 원활하여 GitHub 저장소와의 연동에 있어 가장 간편하게 사용할 수 있습니다. 또한, GitHub Actions Runner는 셀프 호스팅 기능을 제공하여, 사용자가 자신의 환경에서 직접 제어할 수 있도록 해줍니다.

마무리

GitHub Actions Runner는 CI/CD 자동화를 위해 필수적인 도구로, 유연한 환경에서의 작업 실행을 통해 개발자에게 많은 이점을 제공합니다. 특히, 보안이나 환경에 대한 요구가 있는 경우 셀프 호스팅 Runner를 통해 이를 해결할 수 있습니다. 개발자라면 반드시 한 번 사용해보아야 할 도구입니다.

더 자세한 내용은 GitHub Actions Runner 공식 페이지를 방문해보세요.

CI/CD 자동화를 위한 GitHub Actions Runner 활용하기