[Jenkins] Pipeline으로 웹 배포하기 (Jenkinsfile)

Pipeline으로 웹 배포하기 (Jenkinsfile)

---

💡 젠킨스에서 새로운 아이템 생성하기

✅ ➕ 새로운 Item

새로운 아이템 클릭하기

 

✔️ 젠킨스에서 아이템이란?

새롭게 정의할 작업을 말한다.

모든 작업의 정의와 순서를 모아둔 전체 작업을 프로젝트라고 하며, 프로젝트를 생성하는 방식에는 Freestyle, Pipeline등이 있다.

이렇게 프로젝트를 정의하고 생성하는 것을 아이템이라고 한다.

 

💡 Pipeline

새로운 아이템 클릭 후 나오는 화면

✔️ Pipeline이란?

젠킨스에서 지원하는 고유의 Pipeline 문법으로 코드를 작성해 작업을 정의하는 프로젝트이다.

깃허브와 같은 코드 저장소에 애플리케이션 코드를 올릴 때 Pipeline 코드로 작성한 파일을 함께 올려두면 애플리케이션 코드와 배포를 함께 관리할 수 있어 관리 편리성이 높다.

 

Pipeline은 고유의 문법으로 작성된 코드 또는 이러한 내용을 담고 있는 파일로 이루어져 있다. 파이프라인 문법을 토해 젠킨스는 코드로 작성한 내용이 실제 동작하는 작업이 되는 코드로서의 파이프라인을 구현할 수 있다.

 

젠킨스 Pipeline은 크게 두 가지 문법으로 코드를 작성할 수 있다.

첫 번째는 스크립트 문법이고  두 번째는 선언적인 문법이다.

쿠버네티스 상에서 젠킨스 에이전트를 설정할 때 스크립트 문법을 사용하면 익숙하지 않는 젠킨스의 고유 문법으로 작성해야 한다.

하지만 선언적 문법을 사용하면 우리가 이미 익숙한 야믈을 그대로 사용할 수 있으므로 선언적인 문법을 사용하는 것을 권장한다.

 

✅ Pipeline script from SCM

외부 저장소에서 선언적인 문법으로 작성된 파일을 가지고 오기 위해서.

위와 같이 설정 후 저장

💡 Jenkinsfile

✔️ Jenkinsfile의 구성요소

Jenkinsfile의 구조

🧷 pipeline

선언적인 문법이 시작하는 부분

 

🧷 agent

작업을 수행할 에이전트를 지정하고 필요한 설정을 하는 부분으로 아래와 같은 것들이 있다.

    사용 가능한 에이전트를 젠킨스가 임의로 지정하는 any

    특정 레이블과 일치하는 에이전트 노드를 지정하는 label

    에이전트 노드의 이미지를 도커로 지정하는 docker

    에이전트 노드를 쿠버네티스 파드로 지정하는 kubernetes

 

🧷 stages

stage를 모아서 정의

 

🧷 stage

step들을 정의하는 영역

젠킨스에서 빌드가 진행될 때 stage별로 진행 단계를 확인할 수 있다.

 

🧷 steps

stage 내부에서 실제 작업 내용을 작성하는 영역

step 영역 내부에서 script, sh, git과 같은 작업을 통해 실제로 동작하게 된다.

 

pipeline {
  agent any
  stages {
    stage('git scm update') {
      steps {
        git url: 'https://github.com/YoonHakyoung/cicdtest.git', branch: 'main'
      }
    }
    stage('docker build and push') {
      steps {
        sh '''
        sudo docker build -t yoonhakyoung/cicdtest:1.0 .
        sudo docker push yoonhakyoung/cicdtest:1.0
        '''
      }
    }
    stage('deploy kubernetes') {
      steps {
        sh '''
        ansible master -m command -a 'kubectl create deployment pl-bulk-prod --image=yoonhakyoung/cicdtest:1.0'
        ansible master -m command -a 'kubectl expose deployment pl-bulk-prod --type=LoadBalancer --port=80 --target-port=80 --name=pl-bulk-prod-svc'
        '''
      }
    }
  }
}

 

- 'git scm update' : 깃허브로부터 소스 코드를 내려받은 단계

- 'docker build and push' : 컨테이너 이미지 빌드하고, 빌드한 이미지를 레지스트리에 저장

- 'deploy kubernetes' : 이미지를 pl-bulk-prod로 배포하고, 배포한 파드를 로드밸런서 타입으로 노출

 

✅ 지금 빌드

 

아래 Build History에서 #1이 추가되는 것 확인 가능

 

작업이 성공하면 우측에서 각 스테이지 별 단계와 성공 여부 소요 시간과 같은 정보 확인 가능.