ci/README.md

@@ -28,6 +28,9 @@ docker compose -f docker-compose.runner.yml --env-file .env logs -f runner
 #    "Runner registered successfully" 가 보이면 성공
 ```
 
+> 같은 PC 에 다른 저장소의 러너가 있다면 `RUNNER_NAME` 을 서로 다르게 짓습니다.
+> compose 프로젝트 이름과 컨테이너 이름이 모두 `RUNNER_NAME` 을 따르므로, 같으면 기존 러너를 덮어씁니다.
+
 저장소 **Settings → Actions → Runners** 에서 러너가 **Idle** 로 표시되면 준비 완료입니다.
 이후 푸시하면 Actions 탭에서 실행이 시작됩니다.
 

ci/docker-compose.runner.yml

@@ -5,6 +5,10 @@
 #
 # 사용법은 ci/README.md 참조.
 
+# compose 프로젝트 이름 — 지정하지 않으면 폴더 이름(ci)이 되어, 같은 PC 에서 다른 저장소의
+# ci/ 러너와 이름이 겹쳐 그 러너를 덮어쓸 수 있다. 러너 이름을 그대로 쓴다.
+name: ${RUNNER_NAME:-gitea-runner}
+
 services:
   runner:
     image: gitea/act_runner:latest