Cicd on Joonlog

컨테이너 환경에서 Jenkins의 PHP CICD 파이프라인 구축하기

Thu, 20 Nov 2025 09:00:00 +0900

PHP 애플리케이션에 대한 CI/CD 파이프라인 설정 방법

환경

Git 리포지토리 및 컨테이너 레지스트리: GitLab
CI/CD: Jenkins
PHP 버전: 8.3
파이프라인을 컨테이너에서 동작시키기 위한 Jenkins Agent 도커 설정

파이프라인 설정

Git 리포지토리 연동
- Definition: Pipeline script from SCM
  - 파이프라인 구성에 필요한 스크립트를 SCM에서 가져오도록 설정
- SCM: Git
- Repository URL: Git 리포지토리 URL
- Credentials: Git 리포지토리에 접근 가능하도록 저장한 Credential
- Branch Specifier: */main

CI 파이프라인

컨테이너 이미지를 빌드하기 위한 Dockerfile도 Git 리포지토리에 있어야 함
PHP는 빌드 과정이 필요 없는 인터프리터 언어이기 때문에 소스 빌드 없이 이미지 빌드 → 이미지 푸시 과정만 필요
CI 완료 전 CD 파이프라인을 트리거

1. 환경

agent any로 jenkins agent 컨테이너를 파이프라인으로 사용

1
2
3
4
5
6
7
8
9


pipeline {
 agent any

 environment {
 APP_NAME = '<애플리케이션 명>'
 GITLAB_REGISTRY = '<컨테이너 레지스트리 URL>'
 GITLAB_PROJECT = '<Git 리포지토리 명>'
 GITLAB_CREDENTIAL_ID = '<저장한 Git PAT 토큰 ID>'
 }

2. Git 체크아웃

Git 리포지토리의 최신 커밋을 체크아웃
파이프라인 로그에 커밋 정보 출력

1
2
3
4
5
6
7


 stages {
 stage('Checkout') {
 steps {
 checkout scm
 sh 'git log -1 --oneline'
 }
 }

3. 컨테이너 이미지 빌드 및 레지스트리 푸시

Git 리포지토리에 있는 Dockerfile을 기반으로 이미지 빌드
Git 커밋 해시와 Jenkins 빌드 번호를 조합해서 태그 생성
GitLab PAT 토큰으로 로그인 후 푸시

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27


 stage('Docker Build & Push') {
 steps {
 script {
 def gitCommit = sh(returnStdout: true, script: 'git rev-parse --short HEAD').trim()
 def imageTag = "${env.BUILD_NUMBER}-${gitCommit}"
 def fullImage = "${GITLAB_REGISTRY}/${GITLAB_PROJECT}/${APP_NAME}"

 sh """
 docker build --no-cache -t ${fullImage}:${imageTag} .
 docker tag ${fullImage}:${imageTag} ${fullImage}:latest
 """

 withCredentials([usernamePassword(credentialsId: "${GITLAB_CREDENTIAL_ID}",
 usernameVariable: 'GITLAB_USER',
 passwordVariable: 'GITLAB_TOKEN')]) {
 sh """
 echo "\$GITLAB_TOKEN" | docker login ${GITLAB_REGISTRY} -u "\$GITLAB_USER" --password-stdin
 docker push ${fullImage}:${imageTag}
 docker push ${fullImage}:latest
 docker logout ${GITLAB_REGISTRY}
 """
 }

 echo "Docker image pushed: ${fullImage}:${imageTag}"
 echo "Docker image pushed: ${fullImage}:latest"
 }
 }

4. CD 파이프라인 트리거

CI 파이프라인이 완료 되기 전 CD 파이프라인을 동작하도록 트리거

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


 stage('Trigger CD') {
 steps {
 build job: '<CD 파이프라인 이름>',
 parameters: [
 string(name: 'IMAGE_TAG', value: 'latest'),
 string(name: 'DEPLOY_TARGET', value: 'ALL')
 ],
 wait: true, // CD 끝날 때까지 기다릴지
 propagate: true // CD 실패하면 이 Job도 실패로 처리할지
 }
 }
 }

5. 파이프라인 결과 체크

1
2
3
4
5
6
7
8
9


 post {
 success {
 echo "Build #${env.BUILD_NUMBER} succeeded for ${APP_NAME}"
 }
 failure {
 echo "Build #${env.BUILD_NUMBER} failed - check console output"
 }
 }
}

CD 파이프라인

Jenkins 서버에서 배포할 서버에 SSH로 접근 후 docker compose 파일을 기동하여 컨테이너 레지스트리의 이미지를 가져오는 방식으로 배포
배포할 서버가 여러 개일 경우를 고려해서 구성

환경

agent any로 jenkins agent 컨테이너를 파이프라인으로 사용
DB 접속정보 등 민감한 정보가 있는 .env 파일은 Jenkins Credential로 관리

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


pipeline {
 agent any

 parameters {
 string(name: 'IMAGE_TAG', defaultValue: 'latest', description: 'Docker image tag to deploy')
 choice(name: 'DEPLOY_TARGET', choices: ['WAS1', 'ALL'], description: 'WAS1: <WAS 서버 IP> | ALL: 전체 WAS 배포')
 }

 environment {
 WAS1_HOST = '<WAS1 서버 IP>'
 // WAS2_HOST = '<WAS2 서버 IP>' // TODO: WAS2 추가 시 활성화
 DEPLOY_PATH = '<배포 경로>'
 GITLAB_REGISTRY = '<컨테이너 레지스트리 URL>'
 GITLAB_PROJECT = '<Git 리포지토리명>'
 IMAGE_NAME = '<컨테이너 이미지 명>'
 DEPLOY_CREDENTIAL_ID = '<배포 서버 SSH 계정명>'
 GITLAB_CREDENTIAL_ID = '<저장한 Git PAT 토큰 ID>'
 TEACHER_ENV_FILE_CREDENTIAL_ID = '<Credential에 저장한 .env 파일 ID>'
 COMPOSE_FILE_LOCAL = 'docker-compose.yaml'
 }

1. Git 체크아웃

파이프라인이 “Pipeline script from SCM” 으로 되어 있기 때문에 가능
docker-compose.yaml 파일을 가져오기 위함

1
2
3
4
5
6
7


 stage('Checkout') {
 steps {
 // CD Job이 Pipeline from SCM로 설정돼 있다는 전제
 checkout scm
 sh "ls -al ${COMPOSE_FILE_LOCAL} || echo 'compose 파일 경로 확인 필요'"
 }
 }

2. 준비

배포할 이미지 태그 / 배포 대상 서버를 선택할 수 있게 설정
deployHosts: 배포 대상 호스트 목록

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


 stages {
 stage('Prepare') {
 steps {
 script {
 echo "Deploying image: ${GITLAB_REGISTRY}/${GITLAB_PROJECT}/${IMAGE_NAME}:${params.IMAGE_TAG}"
 echo "Deploy target: ${params.DEPLOY_TARGET}"

 def deployHosts = []
 if (params.DEPLOY_TARGET == 'WAS1') {
 deployHosts = [WAS1_HOST]
 } else if (params.DEPLOY_TARGET == 'ALL') {
 deployHosts = [WAS1_HOST]
 // TODO: WAS2 추가 시 -> deployHosts = [WAS1_HOST, WAS2_HOST]
 }

 env.DEPLOY_HOSTS = deployHosts.join(',')
 echo "Target servers: ${env.DEPLOY_HOSTS}"
 }
 }
 }

3. 배포

컨테이너 레지스트리에서 이미지 풀링
.env 파일을 Credential에서 배포 서버로 복사
git으로 체크아웃한 docker-compose 파일을 배포 서버로 복사
배포 경로에서 docker compose 명령어를 통한 애플리케이션 재기동

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63


 stage('Deploy') {
 steps {
 script {
 def hosts = env.DEPLOY_HOSTS.split(',')

 withCredentials([
 usernamePassword(credentialsId: "${DEPLOY_CREDENTIAL_ID}",
 usernameVariable: 'DEPLOY_USER',
 passwordVariable: 'DEPLOY_PASS'),
 usernamePassword(credentialsId: "${GITLAB_CREDENTIAL_ID}",
 usernameVariable: 'GITLAB_USER',
 passwordVariable: 'GITLAB_TOKEN'),
 // .env 전체를 파일로 받음
 file(credentialsId: "${TEACHER_ENV_FILE_CREDENTIAL_ID}",
 variable: '<env 변수명>')
 ]) {
 for (host in hosts) {
 echo "Deploying to ${host}..."

 sh """
 # 0) 임시 파일 경로(충돌 방지용)
 TMP_ENV=/tmp/env.\$(date +%s)
 TMP_COMPOSE=/tmp/compose.\$(date +%s).yaml

 # 1) .env / docker-compose.yaml 둘 다 /tmp 로 복사
 sshpass -p "\$DEPLOY_PASS" scp -o StrictHostKeyChecking=no "\$<env 변수명>" "\$DEPLOY_USER"@${host}:"\$TMP_ENV"

 sshpass -p "\$DEPLOY_PASS" scp -o StrictHostKeyChecking=no "${COMPOSE_FILE_LOCAL}" "\$DEPLOY_USER"@${host}:"\$TMP_COMPOSE"

 # 2) 서버 안에서 sudo로 최종 위치로 이동 + 권한 조정 + 컨테이너 재기동
 sshpass -p "\$DEPLOY_PASS" ssh -o StrictHostKeyChecking=no "\$DEPLOY_USER"@${host} "
 echo 'Apply .env & docker-compose.yaml...'

 # .env 교체
 sudo mv \$TMP_ENV ${DEPLOY_PATH}/.env
 sudo chown nginx:nginx ${DEPLOY_PATH}/.env

 # docker-compose.yaml 교체
 sudo mv \$TMP_COMPOSE ${DEPLOY_PATH}/docker-compose.yaml
 sudo chown root:root ${DEPLOY_PATH}/docker-compose.yaml

 echo 'Logging in to GitLab Registry...'
 echo '\$GITLAB_TOKEN' | sudo docker login ${GITLAB_REGISTRY} -u '\$GITLAB_USER' --password-stdin

 echo 'Pulling image: ${GITLAB_REGISTRY}/${GITLAB_PROJECT}/${IMAGE_NAME}:${params.IMAGE_TAG}'
 sudo docker pull ${GITLAB_REGISTRY}/${GITLAB_PROJECT}/${IMAGE_NAME}:${params.IMAGE_TAG}

 echo 'Redeploying containers...'
 export IMAGE_TAG=${params.IMAGE_TAG}

 sudo docker compose -f ${DEPLOY_PATH}/docker-compose.yaml down
 sudo docker compose -f ${DEPLOY_PATH}/docker-compose.yaml up -d

 sudo docker logout ${GITLAB_REGISTRY}
 "
 """

 echo "Deployment to ${host} completed."
 }
 }
 }
 }
 }

4. 헬스 체크

배포 완료 후 컨테이너 상태 점검

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30


 stage('Health Check') {
 steps {
 script {
 echo "Waiting for application to start..."
 sleep 10

 def hosts = env.DEPLOY_HOSTS.split(',')

 withCredentials([
 usernamePassword(credentialsId: "${DEPLOY_CREDENTIAL_ID}",
 usernameVariable: 'DEPLOY_USER',
 passwordVariable: 'DEPLOY_PASS')
 ]) {
 for (host in hosts) {
 echo "Health checking ${host}..."

 sh """
 sshpass -p "\$DEPLOY_PASS" ssh -o StrictHostKeyChecking=no "\$DEPLOY_USER"@${host} "
 # 컨테이너 상태 확인
 sudo docker ps | grep pj-1 || exit 1
 "
 """

 echo "${host} health check passed."
 }
 }
 }
 }
 }
 }

5. 파이프라인 결과 체크

1
2
3
4
5
6
7
8
9


 post {
 success {
 echo "Deployment succeeded - ${IMAGE_NAME}:${params.IMAGE_TAG} deployed to ${env.DEPLOY_HOSTS}"
 }
 failure {
 echo "Deployment failed - check console output"
 }
 }
}

컨테이너 환경에서 Jenkins의 Java CICD 파이프라인 구축하기

Thu, 13 Nov 2025 09:00:00 +0900

Java 1.8 애플리케이션에 대한 CI/CD 파이프라인 설정 방법

환경

Git 리포지토리 및 컨테이너 레지스트리: GitLab
CI/CD: Jenkins
Java 버전: 1.8
빌드 툴: Maven
파이프라인을 컨테이너에서 동작시키기 위한 Jenkins Agent 도커 설정

파이프라인 설정

Git 리포지토리 연동
- Definition: Pipeline script from SCM
  - 파이프라인 구성에 필요한 스크립트를 SCM에서 가져오도록 설정
- SCM: Git
- Repository URL: Git 리포지토리 URL
- Credentials: Git 리포지토리에 접근 가능하도록 저장한 Credential
- Branch Specifier: */main

CI 파이프라인

컨테이너 이미지를 빌드하기 위한 Dockerfile도 Git 리포지토리에 있어야 함
Java는 빌드 과정이 필요한 컴파일 언어이기 때문에 소스 빌드 → 이미지 빌드 → 이미지 푸시 과정이 필요

환경

agent any로 jenkins agent 컨테이너를 파이프라인으로 사용

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


pipeline {
 agent any

 environment {
 WAR_FILE = '<WAR파일명>'
 BUILD_PROFILE = '<개발/운영>'
 MAVEN_OPTS = '-Xmx1024m -XX:MaxPermSize=256m'

 // Docker & GitLab Registry settings
 DOCKER_IMAGE = '<이미지명>'
 GITLAB_REGISTRY = '<컨테이너 레지스트리 URL>'
 GITLAB_PROJECT = '<Git 리포지토리명>'
 GITLAB_CREDENTIAL_ID = '<저장한 Git PAT 토큰 ID>'
 }

소스코드 체크아웃

Git 리포지토리의 최신 커밋을 체크아웃
파이프라인 로그에 커밋 정보 출력

1
2
3
4
5
6
7


 stages {
 stage('Checkout') {
 steps {
 checkout scm
 sh 'git log -1 --oneline'
 }
 }

Maven 빌드

Maven 컨테이너를 사용해서 소스 빌드
로컬 ~/.m2 디렉토리를 컨테이너하고 공유해서 의존성 캐시 재사용

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25


 stage('Build') {
 agent {
 docker {
 image 'maven:3.9.11-eclipse-temurin-8'
 args '-v $HOME/.m2:/root/.m2'
 reuseNode true
 }
 }
 steps {
 script {
 def settingsParam = fileExists('settings.xml') ? '-s settings.xml' : ''

 sh """
 mvn clean package -P ${BUILD_PROFILE} -DskipTests=true ${settingsParam} \
 -Dmaven.compiler.source=1.8 \
 -Dmaven.compiler.target=1.8
 """

 sh """
 test -f target/${WAR_FILE} || (echo "WAR file not found" && exit 1)
 ls -lh target/${WAR_FILE}
 """
 }
 }
 }

Artifact 보관

빌드 메타데이터(commit, branch, build_time)를 build.properties로 저장
산출물을 Artifacts로 아카이빙
- Jenkins 콘솔에서 바로 WAR 파일 다운로드 가능

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21


 stage('Archive') {
 steps {
 script {
 def gitCommit = sh(returnStdout: true, script: 'git rev-parse --short HEAD').trim()
 def gitBranch = sh(returnStdout: true, script: 'git rev-parse --abbrev-ref HEAD').trim()
 def buildTime = sh(returnStdout: true, script: 'date "+%Y-%m-%d %H:%M:%S"').trim()

 writeFile file: 'build.properties', text: """BUILD_NUMBER=${env.BUILD_NUMBER}
BUILD_PROFILE=${BUILD_PROFILE}
GIT_COMMIT=${gitCommit}
GIT_BRANCH=${gitBranch}
BUILD_TIME=${buildTime}
"""
 }

 archiveArtifacts artifacts: "target/${WAR_FILE}, build.properties", fingerprint: true

 // WAR 파일을 workspace root로 복사 (Docker 빌드용)
 sh "cp target/${WAR_FILE} ."
 }
 }

컨테이너 이미지 빌드 및 레지스트리 푸시

Git 리포지토리에 있는 Dockerfile을 기반으로 이미지 빌드
Git 커밋 해시와 Jenkins 빌드 번호를 조합해서 태그 생성
GitLab PAT 토큰으로 로그인 후 푸시

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32


 stage('Docker Build & Push') {
 steps {
 script {
 def gitCommit = sh(returnStdout: true, script: 'git rev-parse --short HEAD').trim()
 def imageTag = "${env.BUILD_NUMBER}-${gitCommit}"
 def fullImageName = "${GITLAB_REGISTRY}/${GITLAB_PROJECT}/${DOCKER_IMAGE}"

 // Docker 이미지 빌드
 sh """
 docker build -t ${fullImageName}:${imageTag} .
 docker tag ${fullImageName}:${imageTag} ${fullImageName}:latest
 """

 // GitLab Container Registry 로그인 및 푸시
 withCredentials([usernamePassword(credentialsId: "${GITLAB_CREDENTIAL_ID}",
 usernameVariable: 'GITLAB_USER',
 passwordVariable: 'GITLAB_TOKEN')]) {
 sh """
 echo "\$GITLAB_TOKEN" | docker login ${GITLAB_REGISTRY} -u "\$GITLAB_USER" --password-stdin
 docker push ${fullImageName}:${imageTag}
 docker push ${fullImageName}:latest
 docker logout ${GITLAB_REGISTRY}
 """
 }

 echo "Docker image pushed: ${fullImageName}:${imageTag}"
 echo "Docker image pushed: ${fullImageName}:latest"
 }
 }
 }
 }
}

CD 파이프라인

Jenkins 서버에서 배포할 서버에 SSH로 접근 후 docker compose 파일을 기동하여 컨테이너 레지스트리의 이미지를 가져오는 방식으로 배포
배포할 서버가 여러 개일 경우를 고려해서 구성

환경

agent any로 jenkins agent 컨테이너를 파이프라인으로 사용

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18


pipeline {
 agent any

 parameters {
 string(name: 'IMAGE_TAG', defaultValue: 'latest', description: 'Docker image tag to deploy')
 choice(name: 'DEPLOY_TARGET', choices: ['WAS1', 'ALL'], description: 'WAS1: <IP/HOSTNAME> | ALL: 전체 WAS 배포')
 }

 environment {
 WAS1_HOST = '<WAS1 서버 IP>'
 // WAS2_HOST = '<WAS2 서버 IP>' // TODO: WAS2 추가 시 활성화
 DEPLOY_PATH = '<배포 경로>'
 GITLAB_REGISTRY = '<컨테이너 레지스트리 URL>'
 GITLAB_PROJECT = '<Git 리포지토리명>'
 IMAGE_NAME = '<컨테이너 이미지 명>'
 DEPLOY_CREDENTIAL_ID = '<배포 서버 SSH 계정명>'
 GITLAB_CREDENTIAL_ID = '<저장한 Git PAT 토큰 ID>'
 }

준비

배포할 이미지 태그 / 배포 대상 서버를 선택할 수 있게 설정
deployHosts: 배포 대상 호스트 목록

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


 stages {
 stage('Prepare') {
 steps {
 script {
 echo "Deploying image: ${GITLAB_REGISTRY}/${GITLAB_PROJECT}/${IMAGE_NAME}:${params.IMAGE_TAG}"
 echo "Deploy target: ${params.DEPLOY_TARGET}"

 def deployHosts = []
 if (params.DEPLOY_TARGET == 'WAS1') {
 deployHosts = [WAS1_HOST]
 } else if (params.DEPLOY_TARGET == 'ALL') {
 deployHosts = [WAS1_HOST]
 // TODO: WAS2 추가 시 -> deployHosts = [WAS1_HOST, WAS2_HOST]
 }

 env.DEPLOY_HOSTS = deployHosts.join(',')
 echo "Target servers: ${env.DEPLOY_HOSTS}"
 }
 }
 }

배포

컨테이너 레지스트리에서 이미지 풀링
배포 경로에서 docker compose 명령어를 통한 애플리케이션 재기동

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49


 stage('Deploy') {
 steps {
 script {
 def hosts = env.DEPLOY_HOSTS.split(',')

 withCredentials([
 usernamePassword(credentialsId: "${DEPLOY_CREDENTIAL_ID}",
 usernameVariable: 'DEPLOY_USER',
 passwordVariable: 'DEPLOY_PASS'),
 usernamePassword(credentialsId: "${GITLAB_CREDENTIAL_ID}",
 usernameVariable: 'GITLAB_USER',
 passwordVariable: 'GITLAB_TOKEN')
 ]) {
 for (host in hosts) {
 echo "Deploying to ${host}..."

 sh """
 sshpass -p "\$DEPLOY_PASS" ssh -o StrictHostKeyChecking=no \$DEPLOY_USER@${host} "
 cd ${DEPLOY_PATH}

 # GitLab Registry 로그인
 echo 'Logging in to GitLab Registry...'
 echo "\$GITLAB_TOKEN" | sudo docker login ${GITLAB_REGISTRY} -u "\$GITLAB_USER" --password-stdin

 # 이미지 Pull
 echo 'Pulling image: ${GITLAB_REGISTRY}/${GITLAB_PROJECT}/${IMAGE_NAME}:${params.IMAGE_TAG}'
 sudo docker pull ${GITLAB_REGISTRY}/${GITLAB_PROJECT}/${IMAGE_NAME}:${params.IMAGE_TAG}

 # 컨테이너 재배포
 echo 'Redeploying containers...'
 export IMAGE_TAG=${params.IMAGE_TAG}
 sudo docker compose down
 sudo docker compose up -d

 # 배포 확인
 echo 'Checking deployment status...'
 sudo docker compose ps

 # 로그아웃
 sudo docker logout ${GITLAB_REGISTRY}
 "
 """

 echo "Deployment to ${host} completed."
 }
 }
 }
 }
 }

헬스 체크

배포 완료 후 컨테이너 상태 점검

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32


 stage('Health Check') {
 steps {
 script {
 echo "Waiting for application to start..."
 sleep 10

 def hosts = env.DEPLOY_HOSTS.split(',')

 withCredentials([usernamePassword(credentialsId: "${DEPLOY_CREDENTIAL_ID}",
 usernameVariable: 'DEPLOY_USER',
 passwordVariable: 'DEPLOY_PASS')]) {
 for (host in hosts) {
 echo "Health checking ${host}..."

 sh """
 sshpass -p "\$DEPLOY_PASS" ssh -o StrictHostKeyChecking=no \$DEPLOY_USER@${host} "
 # 컨테이너 상태 확인
 sudo docker ps | grep main

 # 헬스체크 (옵션)
 # curl -f http://localhost:8080/health || exit 1
 "
 """

 echo "${host} health check passed."
 }
 }
 }
 }
 }
 }
}

Jenkins 파이프라인을 K8S Pod로 사용하기 위한 설정

Wed, 17 Sep 2025 09:00:00 +0900

Jenkins 파이프라인이 K8S pod로 사용되도록 설정

Helm으로 설치 시에는 하기 설정들이 자동으로 세팅되어 있으니 설정 불필요

Jenkins에 Kubernetes 플러그인 설치 확인
- Jenkins가 K8S API와 통신해서 pod(파이프라인 에이전트)를 생성/삭제 가능하도록 설정
Built-In-Node excutor 설정
- 파이프라인 에이전트를 k8s pod에서 동적으로 실행할거라 built-in-node(jenkins 서버 pod)의 Number of executors을 0으로 설정
K8S Configure
- Manage Jenkins > Clouds > New Cloud / Configure
- K8S URL로 Test Connection 확인
- Jenkins URL/Tunnel
  - Jenkins URL: http://jenkins.jenkins.svc.cluster.local:8080
  - Jenkins tunnel: jenkins-agent.jenkins.svc.cluster.local:50000
    - jenkins tunnel은 jnlp(파이프라인 에이전트 관리 pod)로 연결되는 FQDN 입력
    - jnlp 포트가 50000
  - url, tunnel에 도메인을 넣으면 IP가 바뀌더라도 연결 가능
    - K8S FQDN: 클러스터 DNS 규칙에 의해 만들어짐
      - FQDN 룰: <Service명>.<Namespace명>.svc.
      - cluster domain 기본값은 cluster.local
    - FQDN 예시
      - jenkins FQDN: jenkins.jenkins.svc.cluster.local
      - jenkins-agent FQDN: jenkins-agent.jenkins.svc.cluster.local
      1 2 3 4
      
      # kubectl get svc -n jenkins NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE jenkins ClusterIP 10.233.54.119 <none> 8080/TCP 11d jenkins-agent ClusterIP 10.233.57.212 <none> 50000/TCP 11d
Pod Template

파이프라인 에이전트가 K8S에서 Pod로 관리될 때의 Pod 설정을 정의