빌드·배포 프로세스 자동화

개발 서버 배포가 빌드부터 전송·재기동까지 전부 사람 손으로 돌아가고 있었습니다. 한 번 배포하는 데 15~20분 — 그 시간 동안 다른 개발자들도 같이 눈치 보면서 기다렸고, 누가 언제 뭘 배포했는지 기록은 어디에도 안 남았습니다. 자주 배포하다 보면 명령어 오타나 환경 착각 같은 실수가 한 번씩 섞이고, 그럴 때마다 롤백·재배포 오버헤드가 덤으로 붙었습니다.

• 배포 1회 평균 15~20분

  빌드·전송·재기동을 순서대로 직접 수행

• 배포 이력 추적 불가

  누가 언제 뭘 배포했는지 확인 방법 없음

• 대기 시간 발생

  배포 중에는 다른 작업도 같이 멈춤

• 수동 작업 실수

  명령어 오타·환경 착각으로 장애가 간혹 발생

Jenkins Declarative Pipeline을 써서 빌드·배포 절차를 Jenkinsfile 하나에 정의했습니다. GitLab Webhook으로 특정 브랜치 푸시를 감지하고, Checkout → Build → Deploy 단계가 순차적으로 실행되도록 구성했습니다.

1. 01

   Jenkins를 Docker 컨테이너로 띄우기

   호스트 환경이 꼬이는 걸 피하려고 Jenkins를 Docker 컨테이너로 돌렸습니다. 작업·플러그인·자격증명은 볼륨으로 분리해서 재기동해도 설정이 그대로 유지되도록 구성했습니다.

2. 02

   GitLab Webhook 연결

   GitLab 저장소의 푸시 이벤트를 Jenkins로 넘겨받고, regexpFilterExpression으로 devtest 브랜치 푸시만 걸러서 빌드가 돌아가도록 필터링했습니다.

3. 03

   Jenkinsfile 작성

   Checkout → Build → Deploy 단계를 나눠 두어, 실패가 생기면 어느 단계에서 멈췄는지 바로 보이도록 했습니다. Deploy는 SSH로 WAR 파일을 보낸 뒤 서버측 deploy.sh를 실행해서 WAS 재기동까지 한 번에 처리합니다.

   Jenkinsfile

   groovy

   // Jenkins Declarative Pipeline - GitLab Webhook 연동 자동 배포
   pipeline {
       agent any
    
       triggers {
           GenericTrigger(
               genericVariables: [
                   [key: 'BRANCH_NAME', value: '$.ref'],
                   [key: 'EVENT_TYPE',  value: '$.event_name']
               ],
               regexpFilterExpression: '^refs/heads/devtest push$'
           )
       }
    
       stages {
           stage('Checkout') {
               steps {
                   git branch: 'devtest',
                       credentialsId: 'gitlab-ssh-key',
                       url: 'ssh://git@server/gitlab/goad.git'
               }
           }
    
           stage('Build') {
               steps {
                   sh 'mvn clean package -P staging'
               }
           }
    
           stage('Deploy') {
               steps {
                   sshPublisher(publishers: [
                       sshPublisherDesc(
                           configName: 'staging-server',
                           transfers: [sshTransfer(
                               sourceFiles: 'target/issga.war',
                               execCommand: '/home/deploy/deploy.sh'
                           )]
                       )
                   ])
               }
           }
       }
   }

4. 04

   GitLab 커밋에 빌드 상태 표시

   빌드 결과를 GitLab 커밋 상태로 되돌려 줘서, GitLab에서 커밋을 보면 빌드 성공/실패/진행 중 여부를 바로 확인할 수 있도록 했습니다.

• 배포 시간 20분 → 4분

  수동 15~20분 걸리던 작업이 자동 파이프라인으로 4분대까지 줄었습니다.

• 수동 작업 실수가 사라짐

  명령어 오타, 환경 착각처럼 사람이 개입해서 나던 실수들이 거의 없어졌습니다.

• 대기 시간 없이 다음 작업으로

  푸시하고 나면 파이프라인이 돌아가는 동안 개발자들은 바로 다음 작업으로 넘어갈 수 있습니다.

• Freestyle보다 Pipeline이 맞았다

  처음에는 Freestyle Job으로 시도했는데, 추적·재사용·확장 모두 Pipeline 쪽이 훨씬 편했습니다. 절차를 코드로 남기는 게 왜 중요한지 실감했습니다.