이전 목록으로
#GitHub Actions#CI/CD

GitHub Actions를 act로 로컬 디버깅하기

CI에 Push하기 전에 `act`로 GitHub Actions Workflow를 로컬 실행하는 방법과 Apple Silicon 아키텍처, Secret, 이벤트 입력, CI와 로컬 환경 차이를 정리한다.

Workflow 한 줄을 수정할 때마다 Commit과 Push를 반복하면 디버깅 주기가 길어진다. act는 GitHub Actions Runner와 비슷한 Docker 컨테이너에서 Job을 로컬 실행한다.

flowchart LR
    A[Workflow 수정] --> B[act 로컬 실행]
    B --> C{성공?}
    C -- 아니오 --> A
    C -- 예 --> D[Commit과 Push]
    D --> E[GitHub Hosted Runner 검증]

설치와 확인

brew install act
act --version
docker version
# 사용 가능한 Job 조회
act --list

# push 이벤트 실행
act push

# 특정 Job 실행
act -j test

Apple Silicon

Workflow가 GitHub의 ubuntu-latest amd64 환경을 전제로 하면 다음 옵션이 필요할 수 있다.

act --container-architecture linux/amd64

에뮬레이션 때문에 실제 CI보다 느릴 수 있으며, 아키텍처 의존 바이너리는 결과가 다를 수 있다.

Secret 전달

# .secrets.local
API_TOKEN=local-test-token
act --secret-file .secrets.local

.secrets.local은 반드시 .gitignore에 추가한다. 운영 Token 대신 권한과 만료 범위를 축소한 테스트용 Credential을 사용한다.

workflow_dispatch 입력

{
  "inputs": {
    "environment": "stage"
  }
}
act workflow_dispatch -e event.json

Flutter Workflow 예시

name: Flutter Check

on:
  pull_request:
  workflow_dispatch:

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5
      - uses: subosito/flutter-action@v2
        with:
          flutter-version: "<PINNED_VERSION>"
          cache: true
      - run: flutter pub get --enforce-lockfile
      - run: flutter analyze
      - run: flutter test

로컬 성공이 CI 성공을 보장하지 않는 이유

  • GitHub 서비스와 OIDC 동작이 완전히 같지 않다.
  • Runner Image에 사전 설치된 도구가 다르다.
  • macOS·iOS Job은 Linux Docker로 재현할 수 없다.
  • 네트워크, 권한, Cache 상태가 다르다.
  • 일부 Action은 Docker-in-Docker나 GitHub API에 의존한다.

따라서 act는 빠른 문법·Shell·의존성 검증 도구로 사용하고 최종 확인은 GitHub Hosted Runner에서 수행한다.

관련 문서

목록으로 돌아가기

다른 게시글

#Android#Flutter

현장 Flutter 앱 디버깅에 자주 쓴 ADB 명령어

기기 지정, Logcat, APK 설치, 파일 복사, 포트 reverse를 실기기 점검 흐름으로 정리한다.

#Android#Kotlin

Android 입력 장치 목록 조회하기: 키보드·마우스·HID 스캐너 구분

Android `InputManager`와 `InputDevice` API로 연결된 입력 장치를 조회하고, 키보드·포인터·외부 장치 여부를 판별하는 방법을 정리한다. USB·Bluetooth HID 바코드 스캐너를 일반 키보드와 구분할 때의 한계와 연결 변경 감지 방법도 함께 살펴본다.

#Android#Kotlin

Android 위치 권한과 FusedLocationProvider 실전 정리: 현재 위치·지속 추적·GPS 설정

Jetpack Compose 앱에서 Android 위치 권한을 요청하고, Fused Location Provider로 캐시 위치·일회성 현재 위치·지속 위치 업데이트를 처리하는 흐름을 정리한다. Android 12의 대략적·정확한 위치 선택, 백그라운드 위치 정책, GPS 설정 확인과 생명주기 연동까지 예제 코드로 살펴본다.