Jenkins 실무 가이드 · Part 1

CI/CD와 Jenkins의 역할

수동 빌드와 배포를 줄이기 위해 Jenkins가 맡는 자동화 역할 이해하기

작성 기준2026년 7월

이 파트에서 다루는 내용

CI/CD가 필요한 이유Jenkins가 하는 일Controller와 AgentJob, Workspace, Plugin
01

Jenkins는 반복 작업을 서버에서 재현하는 도구입니다

Jenkins는 코드를 가져오고, 빌드하고, 테스트하고, 산출물을 만들고, 필요한 경우 배포까지 이어주는 자동화 서버입니다.

핵심은 내 PC에서 한 번 성공한 작업을 팀이 믿을 수 있는 서버에서 같은 순서로 반복하게 만드는 것입니다.

CI
Continuous Integration

코드 변경이 들어올 때마다 빌드와 테스트를 자동으로 실행해 문제를 빨리 찾습니다.

CD
Delivery / Deployment

검증된 산출물을 배포 가능한 상태로 만들거나, 승인 후 실제 환경에 반영합니다.

Jenkins
Automation Server

Git, 빌드 도구, 테스트, 배포 스크립트를 파이프라인으로 연결하는 실행 환경입니다.

02

Controller와 Agent를 구분해야 운영이 보입니다

Jenkins controller는 웹 UI, 설정, 큐, 작업 스케줄링을 담당합니다. 실제 빌드는 controller에서 직접 돌릴 수도 있지만, 실무에서는 agent로 분산하는 구성이 많습니다.

Agent는 실제 명령을 실행하는 작업 노드입니다. 빌드 도구와 런타임이 설치되어 있어야 하고, 워크스페이스와 캐시 관리도 agent 기준으로 봐야 합니다.

Controller
  • 사용자와 권한 관리
  • 작업 큐와 스케줄링
  • Jenkins 설정과 플러그인 관리
Agent
  • 빌드와 테스트 명령 실행
  • 워크스페이스 생성
  • 언어 런타임과 빌드 도구 보유
Workspace
  • 소스 체크아웃 위치
  • 빌드 산출물 임시 보관
  • 정리하지 않으면 디스크 사용량 증가
03

Plugin과 Credentials는 편하지만 통제가 필요합니다

  • Jenkins 기능 상당수는 플러그인으로 확장됩니다. Git 연동, Pipeline, Credentials, JUnit 리포트, 알림 등이 여기에 해당합니다.
  • 플러그인은 편하지만 업데이트, 호환성, 보안 이슈가 운영 리스크가 됩니다.
  • 배포 토큰, SSH 키, API 키는 Jenkins Credentials에 저장하고 로그에 직접 출력하지 않습니다.
  • Jenkins를 도입할 때는 빌드 성공뿐 아니라 권한, 백업, 플러그인 관리 기준까지 함께 잡아야 합니다.
운영 기준

Jenkins는 빌드 버튼이 아니라 사내 자동화 서버입니다. 접근 권한과 비밀정보 관리 기준 없이 쓰면 배포 사고로 이어질 수 있습니다.

체크

이 파트 완료 기준