From 573cdb99cb95c8d10e5a114c6e9c047ae63d373c Mon Sep 17 00:00:00 2001
From: happybell80 <happybell80@naver.com>
Date: Mon, 14 Jul 2025 18:24:40 +0900
Subject: [PATCH] Add organization-level runner configuration
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Document transition from individual to shared runner
- Include token generation and registration process
- Add troubleshooting for organization runner issues
- Record runner token: kn5nLcoJgHUh4vgdPTF2cjL9eOHPOArWIHGFJIQq

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 .../20250714_gitea_actions_setup.md           | 59 +++++++++++++++++++
 1 file changed, 59 insertions(+)

diff --git a/docs/troubleshooting/20250714_gitea_actions_setup.md b/docs/troubleshooting/20250714_gitea_actions_setup.md
index 3ce4198..4b86506 100644
--- a/docs/troubleshooting/20250714_gitea_actions_setup.md
+++ b/docs/troubleshooting/20250714_gitea_actions_setup.md
@@ -186,12 +186,71 @@ sudo -l
    sudo nginx -t
    ```
 
+## 조직 레벨 Runner 설정 (추가)
+
+### 개별 저장소 → 조직 공유 Runner 변경
+
+**배경**: 각 저장소마다 개별 runner를 설정하는 것보다 조직 단위 공유 runner가 효율적
+
+**절차**:
+
+1. **기존 runner 정리**:
+```bash
+killall act_runner
+rm -f .runner
+rm -f /etc/act_runner/.runner
+```
+
+2. **조직 runner 토큰 생성**:
+   - Gitea 웹 → Organizations → ivada_Ro-being → Settings → Actions → Runners
+   - "Add new runner" 클릭
+   - 조직 토큰 생성: `kn5nLcoJgHUh4vgdPTF2cjL9eOHPOArWIHGFJIQq`
+
+3. **조직 레벨 runner 등록**:
+```bash
+cd /etc/act_runner
+act_runner register
+# URL: http://localhost:3000
+# Token: kn5nLcoJgHUh4vgdPTF2cjL9eOHPOArWIHGFJIQq
+# Name: org-shared-runner
+# Labels: self-hosted
+```
+
+4. **실행**:
+```bash
+cd /etc/act_runner
+nohup act_runner daemon --config .runner > ~/org_runner.log 2>&1 &
+```
+
+**장점**:
+- ✅ 모든 조직 저장소에서 자동 사용 가능
+- ✅ 통합 관리 및 모니터링
+- ✅ Runner 리소스 효율적 활용
+- ✅ 권한 설정 간편
+
+**적용 저장소**:
+- nginx-infra
+- test (Python FastAPI)
+- frontend-base
+- api-base
+- 기타 모든 ivada_Ro-being 저장소
+
+### 트러블슈팅 (조직 Runner)
+
+**문제**: `runner registration token not found`
+**원인**: 토큰 만료 또는 잘못된 조직 설정
+**해결**: 새 토큰 생성 또는 조직 Actions 설정 확인
+
+**문제**: 조직 runner가 개별 저장소에서 인식 안됨
+**해결**: 저장소 Actions 설정에서 "Allow organization runners" 활성화
+
 ## 참고 자료
 
 - **Gitea Actions 문서**: https://docs.gitea.io/en-us/actions/
 - **act_runner GitHub**: https://github.com/nektos/act_runner
 - **Nginx 설정**: `/etc/nginx/sites-available/default`
 - **워크플로우 파일**: `.gitea/workflows/deploy.yml`
+- **조직 Runner 로그**: `~/org_runner.log`
 
 ---
 *이 문서는 Claude에 의해 자동 생성되었습니다.*
\ No newline at end of file