GitHub Actions self-hosted runner에서 docker-in-docker 권한 거부

Question

사내 self-hosted GitHub Actions runner를 EC2에 구축했습니다. 일반 워크플로는 잘 돌아가는데 docker build 단계에서 permission denied while trying to connect to the Docker daemon socket at /var/run/docker.sock이 발생합니다.

runner 사용자를 docker 그룹에 추가하고 newgrp docker도 했는데 그대로입니다. 어떻게 해결해야 하나요?

김영삼 · Accepted Answer

self-hosted runner의 docker 권한 이슈는 보통 두 단계가 모두 필요합니다 — 그룹 추가만으로는 충분하지 않은 경우가 많습니다.1) docker.sock 권한 영구 적용# runner 사용자 (예: actions-runner)를 docker 그룹에 추가 sudo usermod -aG docker actions-runner # 적용 — newgrp는 같은 셸에서만 유효 # runner 서비스를 재시작해야 그룹 변경이 반영됨 sudo systemctl restart actions.runner.-..service핵심: runner는 systemd 서비스로 등록되어 있는데, 서비스가 시작될 때 그룹이 결정됩니다. newgrp은 셸에서만 유효하고 서비스에 영향을 주지 않습니다. 반드시 서비스 재시작.2) systemd 서비스 자체에 명시적 SupplementaryGroups일부 환경에서는 그룹 추가만으로 부족합

댓글 0