젠킨스 완벽 가이드 - 설치부터 파이프라인 구축까지

English (N/A)
#Jenkins#CI/CD#DevOps

젠킨스를 처음 도입하거나, 기존 환경을 정비하려는 분들을 위해 실무에서 필요한 설정들을 한 곳에 모았다. 각 섹션은 개요만 담고, 세부 내용은 별도 포스트로 분리해 두었으니 필요한 부분을 찾아 참고하면 된다.

설치

젠킨스를 설치하려면 Java(JDK 17 이상)가 필요하다. Mac에서는 Homebrew로, Amazon Linux에서는 yum으로 설치할 수 있다.

설치 방법과 기존 환경 마이그레이션 팁은 아래 포스트에 정리해두었다.

관련 포스트: 젠킨스(Jenkins) 설치 가이드 - Mac, Amazon Linux

초기 설정

젠킨스 설치 후 가장 먼저 해야 할 설정들이다:

  • 초기 관리자 비밀번호 입력 (또는 보안 설정 초기화)
  • 동시 실행 설정 — 배포 작업이 무거우면 executor를 1개로 제한
  • 이메일 알림 설정 — Gmail SMTP 연동
  • 시스템 환경변수 — PATH 설정 및 nvm 권한 문제 해결

관련 포스트: 젠킨스 초기 설정 가이드

플러그인 설정

젠킨스의 강점은 풍부한 플러그인 생태계에 있다. 실무에서 자주 사용하는 플러그인들:

  • 기본 플러그인 — Suggested plugins, AWS Steps, Slack Notification
  • GitHub OAuth — GitHub 계정으로 로그인
  • Node.js 플러그인 — jenkins 유저 환경에서 Node.js 사용
  • 슬랙 알림 — 빌드 결과를 슬랙으로 전송
  • IP 바인딩 설정 — 외부 접근 허용

관련 포스트: 젠킨스 플러그인 설정 가이드

인증 정보 설정

젠킨스가 GitHub, AWS, 슬랙 등 외부 서비스와 연동하려면 인증 정보(Credential)를 등록해야 한다:

  • GitHub Personal Access Token — 프라이빗 저장소 접근
  • AWS Credentials — AWS 서비스 연동
  • 슬랙 인증 정보 — 슬랙 알림 연동

관련 포스트: 젠킨스 인증 정보 설정 가이드

파이프라인 생성

멀티 브랜치 프로젝트를 생성하고 Jenkinsfile로 빌드 파이프라인을 구성하는 방법이다:

  • 멀티 브랜치 프로젝트 — 특정 브랜치만 빌드하도록 필터링
  • Jenkinsfile 작성 — 파이프라인 스크립트
  • SSH 정보 생성 — 배포 서버 접속용

관련 포스트: 젠킨스 파이프라인 설정 가이드

참고

젠킨스 CI/CD의 전반적인 개념과 AWS EC2에서의 구축 사례는 아래 포스트에서 확인할 수 있다.

관련 포스트: Jenkins를 활용한 CI/CD 파이프라인 구축하기