Jenkins 에이전트 사용자 권한 문제로 인한 배포 실패: 원인, 진단, 해결 및 예방 AI 생성 이미지: Jenkins 에이전트 사용자 권한 문제로 배포 실패한 경우 문제 개요 — 에이전트 사용자 권한 때문에 배포가 중단되는 현상 에이전트가 파이프라인을 실행하는 사용자 계정(예: jenkins, jenkins-agent, ci-user 등)이 대상 파일·디렉터리나 시스템 자원에 대해 읽기·쓰기·실행 권한을 갖지 못하면 빌드나 배포 단계가 즉시 실패하거나 중단된다. 흔한 사례로는 워크스페이스에 아티팩트가 기록되지 않음, SSH 키·인벤토리 파일에 접근 불가, 서비스 시작·재시작 권한 부족으로 롤아웃이 중단되거나 Docker 소켓(/var/run/docker.sock) 접근 거부 등이 있다. 특히 Jenkins 에이전트 사용자 권한 문제로 배포 실패한 경우 증상이 비슷하게 반복된다. 주요 영향: 파이프라인의 비정상 종료(종료 코드 오류, "Permission denied" 로그), 배포가 부분적으로만 적용되어 상태가 불완전하게 남는 일, 자동 롤백 실패, 운영 가동시간과 배포 일정 지연, 그리고 보안 설정 누락으로 인한 권한 남용 가능성 등이 있다. 실무 체크리스트 예: 에이전트의 UID/GID와 대상 파일 소유자 일치 여부 확인; 워크스페이스·아티팩트 디렉터리의 소유자 및 퍼미션 점검; SSH 키는 적절한 권한(예: 600)으로 제한; Docker 소켓과 관련 그룹 권한 확인; SELinux/AppArmor 거부 로그 확인. 진단 신호: 반복되는 "Permission denied" 에러, UID/GID 불일치, 파일 소유자·퍼미션 확인 결과, 그리고 SELinux 또는 AppArmor의 거부 메시지 등이 대표적이다. 대표적 원인들 — 파일·프로세스·네트워크·컨테이너 권한 관점 이 섹션에서는 Jenkins 에이전트 사용자 권한 문제로 배포 실패한 경우에 자주 발생하는 원인을 파일·프로세스·네트워크·컨...