Jenkins에서 Git 연동하기

1. Git 플러그인 설치하기

• Jenkins 메인 화면에서 ‘Manage Jenkins’ 클릭
• ‘Manage Plugins’ 들어가서 ‘Available’ 탭에서 Git plugin 검색
• 체크하고 설치! 설치가 끝나면 Jenkins 재시작

2. 자격 증명(Credentials) 등록하기

• ‘Manage Jenkins’ → ‘Manage Credentials’ 들어가
• Global (Domain 없음) 선택 후 Add Credentials 클릭
• Kind: Username with password (또는 SSH 키 사용하려면 SSH Username with private key)
• Username: Git 계정 ID, Password: 비밀번호 또는 Token
• ID는 기억하기 쉽게 설정해

3. 새 Job 생성

• Jenkins 대시보드에서 ‘New Item’ 클릭
• 이름 정하고 Freestyle project 선택 후 OK

4. Git 저장소 설정

• Job 설정화면 들어가서 ‘Source Code Management’ 섹션으로
• Git 선택 → Repository URL 입력 (ex. https://github.com/username/repo.git)
• Credentials에서 방금 등록한 ID 선택
• 브랜치: 기본 브랜치 이름 (master 또는 main)

5. 빌드 트리거 설정

• ‘Build Triggers’ 섹션으로 가
• ‘Poll SCM’ 체크하면 커밋 있을 때마다 자동 빌드
  • 예: H/5 * * * * → 5분마다 검사
• 또는 ‘GitHub hook trigger for GITScm polling’ 체크하면 Webhook으로 자동 실행

6. 빌드(Build) 단계 정의

• ‘Build’ 섹션에서 ‘Add build step’
• 예: 쉘 스크립트 실행할 거면 ‘Execute shell’ → 아래 같은 커맨드 입력:

#!/bin/bash
echo "Git 코드 가져오는 중..."
git --version
# 필요한 빌드 스크립트 넣어

 

7. 빌드 후(Post-build) 설정

• ‘Post-build Actions’ 섹션에서
• 이메일 발송, 테스트 리포트, 아카이브, Slack 연동 등 옵션 선택 가능

8. Job 저장 & 실행

• 설정 다 끝났으면 아래 ‘Save’ 클릭
• 저장소 변경이나 수동 빌드 버튼 눌러서 빌드 잘 되는지 확인

 

참고 팁

• SSH 방식이 더 안전하고 편해. HTTPS는 토큰/비밀번호 자주 바뀌는 번거로움 있음.
• Webhook URL은 http://<JENKINS_URL>/github-webhook/ 형태야. GitHub 저장소 Settings → Webhooks에 등록해줘.
• 빌드 로그는 Console Output에서 볼 수 있어. 오류 나면 그 로그 자세히 분석해!