사내 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도 했는데 그대로입니다. 어떻게 해결해야 하나요?
댓글 1
self-hosted runner의 docker 권한 이슈는 보통 두 단계가 모두 필요합니다 — 그룹 추가만으로는 충분하지 않은 경우가 많습니다.
1) docker.sock 권한 영구 적용
핵심: runner는 systemd 서비스로 등록되어 있는데, 서비스가 시작될 때 그룹이 결정됩니다.
newgrp은 셸에서만 유효하고 서비스에 영향을 주지 않습니다. 반드시 서비스 재시작.2) systemd 서비스 자체에 명시적 SupplementaryGroups
일부 환경에서는 그룹 추가만으로 부족합니다. systemd 서비스 정의에 직접 명시:
3) 검증
대안 — Docker Buildx + buildkitd-rootless
Docker daemon을 root로 굴리는 보안 부담이 큰 환경이라면 rootless 옵션도 있습니다.
더 큰 그림 — runner 격리
self-hosted runner는 동일 호스트에 여러 워크플로가 동거하면 보안·격리 문제가 큽니다. 권장 구조:
actions/runner-controller+ Kubernetes)실무 체크리스트:
id명령으로 docker 그룹 포함 확인SupplementaryGroups=dockeroverride 적용"권한 부여했는데 안 됨"의 99%는 서비스가 옛 그룹 컨텍스트로 살아있다입니다. 재시작 잊지 마세요.