ci: Gitea Actions 러너 설정 추가
CI / Backend (lint · test · e2e · build) (push) Failing after 1m10s
CI / Frontend (lint · type-check · test) (push) Successful in 10m58s
CI / Flutter (analyze · test) (push) Has been cancelled
CI / 에러 코드 SSOT 동기화 검사 (push) Has been cancelled

CI 워크플로는 저장소에 있지만 실행 주체(러너)가 없어 동작하지 않는 상태였다.
러너가 없으면 워크플로는 "Waiting for a runner" 로 대기만 한다.

- ci/docker-compose.runner.yml — act_runner 를 별도 스택으로 분리.
  앱 스택은 개발할 때만 띄우지만 러너는 항상 켜져 있어야 하므로 생명주기가 다르다.
- ci/.env.example — 등록 토큰은 ci/.env 에만 두며 커밋되지 않는다.
- ci/README.md — 설치 절차, 증상별 문제 해결, 잡별 리소스 특성.
- 라벨 기본값이 워크플로의 runs-on(ubuntu-latest)과 일치하는지 교차 확인했다.
  불일치는 잡이 영원히 대기하는 가장 흔한 원인이다.

러너가 도커 소켓에 접근해 사실상 호스트 관리자 권한을 갖는다는 점도 문서에 명시했다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-09-17 22:23:37 +09:00
parent 20754edf26
commit ea46fe7817
6 changed files with 128 additions and 0 deletions
+20
View File
@@ -0,0 +1,20 @@
# ==========================================
# Gitea Actions 러너 설정
#
# 사용법: cp .env.example .env 후 토큰을 채운다.
# ⚠️ .env 는 커밋되지 않는다 (루트 .gitignore). 토큰을 이 예시 파일에 적지 말 것.
# ==========================================
# Gitea 인스턴스 주소 (끝에 / 없이)
GITEA_INSTANCE_URL=https://git.wandergo.net
# 등록 토큰 — 저장소 Settings → Actions → Runners → Create new Runner 에서 발급
# (여러 저장소에서 공용으로 쓰려면 관리자 화면의 인스턴스 레벨 토큰을 사용)
GITEA_RUNNER_REGISTRATION_TOKEN=
# 러너 식별 이름 — 여러 대를 띄운다면 구분되게 짓는다
RUNNER_NAME=gitea-runner
# 라벨: <워크플로의 runs-on>:docker://<잡을 실행할 이미지>
# ci.yml 이 ubuntu-latest 를 쓰므로 그대로 두면 된다.
RUNNER_LABELS=ubuntu-latest:docker://gitea/runner-images:ubuntu-latest