Jenkins 설치 가이드 (Kubernetes)¶
Kubernetes 환경에서 Jenkins를 설치하는 가장 표준적이고 권장되는 방법은 Helm Chart를 사용하는 것입니다.
1. Helm을 이용한 설치 (권장)¶
사전 준비¶
- Kubernetes 클러스터가 구축되어 있어야 합니다.
kubectl이 설치 및 설정되어 있어야 합니다.helm이 설치되어 있어야 합니다.
Jenkins Helm 리포지토리 추가¶
설치 (기본 설정)¶
위 명령어를 실행하면 jenkins라는 릴리스 이름으로 기본 설정의 Jenkins가 설치됩니다.
커스텀 설정 (values.yaml)¶
프로덕션 환경에서는 영구 볼륨(Persistence Volume), 서비스 타입(Service Type), 리소스 제한 등을 설정하기 위해 values.yaml을 수정해야 합니다.
-
기본 설정 파일 다운로드:
-
jenkins-values.yaml수정: - ServiceType: 기본값은
ClusterIP입니다. 외부 접속을 위해LoadBalancer또는NodePort로 변경하거나 Ingress를 설정합니다. - Persistence: 스토리지 클래스(StorageClass)와 크기를 환경에 맞게 조정합니다.
-
AdminPassword: 초기 관리자 비밀번호를 지정할 수 있습니다.
-
커스텀 설정으로 설치:
2. 설치 확인 및 접속¶
Pod 상태 확인¶
Running 상태가 될 때까지 기다립니다.
관리자 비밀번호 확인¶
Helm 차트로 설치 시 자동으로 생성된 비밀번호는 다음 명령어로 확인할 수 있습니다.
kubectl exec --namespace default -it svc/jenkins -c jenkins -- /bin/cat /run/secrets/additional/chart-admin-password && echo
접속¶
설정한 Service Type에 따라 접속 방법이 다릅니다.
- LoadBalancer:
kubectl get svc jenkins로 확인된EXTERNAL-IP와 포트(8080)로 접속. - NodePort: 노드 IP와 할당된 NodePort로 접속.
- Port-Forwarding (테스트용):
http://localhost:8080접속.
3. Kubernetes Plugin 설정¶
Kubernetes 위에 설치된 Jenkins의 가장 큰 장점은 동적 에이전트 프로비저닝입니다.
Kubernetes Plugin을 설정하면 빌드가 요청될 때마다 자동으로 Pod를 생성하여 빌드를 수행하고, 완료되면 Pod를 삭제합니다.
- Jenkins 관리 -> 플러그인 관리 ->
Kubernetes플러그인 설치 확인. - Jenkins 관리 -> 노드 관리 -> Configure Clouds 이동.
- Kubernetes 클러스터 정보 및 Pod 템플릿 설정.