From b6abc3d1185d93178c5e149e47c020cc84bbba45 Mon Sep 17 00:00:00 2001
From: ttipo <kysung114y@gmail.com>
Date: Wed, 4 Nov 2026 14:53:50 +0900
Subject: [PATCH] =?UTF-8?q?chore(ci):=20=EB=9F=AC=EB=84=88=20compose=20?=
 =?UTF-8?q?=ED=94=84=EB=A1=9C=EC=A0=9D=ED=8A=B8=20=EC=9D=B4=EB=A6=84?=
 =?UTF-8?q?=EC=9D=84=20=EB=9F=AC=EB=84=88=20=EC=9D=B4=EB=A6=84=EC=9C=BC?=
 =?UTF-8?q?=EB=A1=9C=20=EA=B3=A0=EC=A0=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

프로젝트 이름을 지정하지 않으면 폴더 이름(ci)이 되어, 같은 PC 에서 다른 저장소의
ci/ 러너와 이름이 겹쳐 그 러너를 덮어쓸 수 있다(2026-11-04 arasystem 러너와 같은 PC 에서 확인).
compose 파일에 name: ${RUNNER_NAME} 을 두어 -p 없이도 겹치지 않게 하고, README 에 이름을 다르게 지으라고 적었다.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 ci/README.md                 | 3 +++
 ci/docker-compose.runner.yml | 4 ++++
 2 files changed, 7 insertions(+)

diff --git a/ci/README.md b/ci/README.md
index 9147ae6..ecc49ac 100644
--- a/ci/README.md
+++ b/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 탭에서 실행이 시작됩니다.
 
diff --git a/ci/docker-compose.runner.yml b/ci/docker-compose.runner.yml
index 50f16c2..0c475f3 100644
--- a/ci/docker-compose.runner.yml
+++ b/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