diff --git a/README.md b/README.md index 0e5607d..5c6caec 100644 --- a/README.md +++ b/README.md @@ -81,14 +81,86 @@ git push -u origin main ## 2. Gitea Runner (설치 완료 — VM 방식) 전용 VM(`soo-runner`)에 act_runner를 직접 설치하여 systemd 서비스로 운영. +기존 K8s 파드(DinD sidecar) 방식에서 VM 직접 설치로 전환. -- **호스트**: `ssh ubuntu@runner` (호스트명: `soo-runner`) -- **Runner 이름**: `soo-runner` -- **바이너리**: `/usr/local/bin/act_runner` -- **작업 디렉토리**: `/opt/act_runner/` -- **서비스**: `/etc/systemd/system/act_runner.service` (enabled, auto-restart) -- **Labels**: `ubuntu-latest`, `ubuntu-22.04` (Docker), `self-hosted` (Host) -- **Gitea instance**: `https://gitea.inje-private.com` +| 항목 | 값 | +|------|-----| +| 호스트 | `ssh ubuntu@runner` (호스트명: `soo-runner`) | +| OS | Ubuntu 22.04.5 LTS | +| IP | `10.0.0.67` | +| Runner 이름 | `soo-runner` | +| act_runner | v0.3.0 (`/usr/local/bin/act_runner`) | +| Docker | v29.3.0 | +| 작업 디렉토리 | `/opt/act_runner/` | +| 서비스 | `/etc/systemd/system/act_runner.service` | +| Labels | `ubuntu-latest`, `ubuntu-22.04` (Docker), `self-hosted` (Host) | + +### 2-1. VM 설치 과정 + +```bash +# 1. Docker 설치 +sudo apt-get update +sudo apt-get install -y ca-certificates curl gnupg +sudo install -m 0755 -d /etc/apt/keyrings +curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg +echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null +sudo apt-get update && sudo apt-get install -y docker-ce docker-ce-cli containerd.io +sudo usermod -aG docker ubuntu + +# 2. act_runner 바이너리 설치 +curl -sL https://gitea.com/gitea/act_runner/releases/download/v0.3.0/act_runner-0.3.0-linux-amd64 -o act_runner +chmod +x act_runner +sudo mv act_runner /usr/local/bin/ + +# 3. 작업 디렉토리 생성 +sudo mkdir -p /opt/act_runner +sudo chown ubuntu:ubuntu /opt/act_runner +``` + +### 2-2. Gitea 연동 (Runner 등록) + +```bash +# 1. Gitea에서 Runner 등록 토큰 발급 +# Gitea > 저장소 Settings > Actions > Runners > "Create new Runner" 에서 토큰 복사 +# 또는 사이트 전역: Site Administration > Actions > Runners + +# 2. Runner 등록 +cd /opt/act_runner +act_runner register --no-interactive \ + --instance https://gitea.inje-private.com \ + --token \ + --name soo-runner \ + --labels "ubuntu-latest:docker://catthehacker/ubuntu:act-22.04,ubuntu-22.04:docker://catthehacker/ubuntu:act-22.04,self-hosted:host" +# → /opt/act_runner/.runner 파일 생성됨 +``` + +### 2-3. systemd 서비스 등록 + +```bash +# 서비스 파일 생성 +sudo tee /etc/systemd/system/act_runner.service > /dev/null <<'EOF' +[Unit] +Description=Gitea Act Runner +After=docker.service +Requires=docker.service + +[Service] +User=ubuntu +WorkingDirectory=/opt/act_runner +ExecStart=/usr/local/bin/act_runner daemon +Restart=always +RestartSec=5 + +[Install] +WantedBy=multi-user.target +EOF + +# 서비스 시작 및 자동 시작 등록 +sudo systemctl daemon-reload +sudo systemctl enable --now act_runner +``` + +### 2-4. 운영 명령어 ```bash # 상태 확인