☁️ 4단계: Docker 컨테이너화 배포 - 100-hours-a-week/7-team-ddb-wiki GitHub Wiki

pipeline {
  agent any // 모든 Jenkins 에이전트에서 실행 가능

  parameters {
    // Discord에서 배포 승인(✅ 버튼 클릭) 후 true로 바꿔 재실행
    booleanParam(name: 'APPROVED', defaultValue: false,
                 description: 'Discord ✅ 승인 후 true 로 재실행')
  }

  environment {
    // GCP 관련 설정
    PROJECT_ID     = 'my-gcp-project'
    REGION         = 'asia-northeast3'
    LOCATION       = 'asia-northeast3'
    MIG_NAME       = 'my-prod-mig'

    // Docker 이미지 및 서비스 설정
    SERVICE_NAME   = 'be' // Backend 서비스 식별자
    REPOSITORY     = 'ddb-backend' // GAR 내 저장소 이름 (실제 환경에 맞게 수정 필요)

    // Jenkins 빌드 번호를 이용한 이미지 태그 생성
    BUILD_NUMBER   = "${env.BUILD_NUMBER}"
    IMAGE_TAG      = "${SERVICE_NAME}:${BUILD_NUMBER}"
    FULL_IMAGE_TAG = "${LOCATION}-docker.pkg.dev/${PROJECT_ID}/${REPOSITORY}/${IMAGE_TAG}"
  }

  stages {

    stage('Git Checkout') {
      steps {
        // GitHub 저장소에서 main 브랜치 체크아웃
        git branch: 'main',
            url: 'https://github.com/100-hours-a-week/7-team-ddb-be.git'
      }
    }

    stage('Docker Build & Push (GAR)') {
      steps {
        withCredentials([file(credentialsId: 'GCP-SA-JSON', variable: 'GCLOUD_KEY')]) {
          sh '''
            // GCP 서비스 계정 인증
            gcloud auth activate-service-account --key-file=$GCLOUD_KEY

            // Google Artifact Registry 인증
            gcloud auth configure-docker ${LOCATION}-docker.pkg.dev --quiet

            // Docker 이미지 빌드 및 GAR로 푸시
            docker build -t $FULL_IMAGE_TAG .
            docker push $FULL_IMAGE_TAG
          '''
        }
      }
    }

    stage('Ask Approval (Discord)') {
      steps {
        // Discord에 승인 요청 메시지 전송 (버튼 포함)
        discordSend message: "Docker 이미지 태그 ${IMAGE_TAG} 배포 승인?",
                     buttons: '✅,❌',
                     webhookURL: credentials('Discord-Webhook')
      }
    }

    stage('Deploy to MIG (Docker)') {
      when { expression { params.APPROVED == true } } // Discord 승인 후에만 실행
      steps {
        withCredentials([file(credentialsId: 'GCP-SA-JSON', variable: 'GCLOUD_KEY')]) {
          sh '''
            set -e
            // GCP 인증
            gcloud auth activate-service-account --key-file=$GCLOUD_KEY

            // 현재 MIG가 사용하는 인스턴스 템플릿 이름 가져오기 (롤백 대비)
            OLD_TMPL=$(gcloud compute instance-groups managed describe $MIG_NAME \
                        --project=$PROJECT_ID --region=$REGION \
                        --format="value(versions[0].instanceTemplate.basename)")

            // 새로운 스타트업 스크립트 작성
            STARTUP_FILE="/tmp/startup-${BUILD_NUMBER}.sh"
            cat > $STARTUP_FILE <<EOF
#!/bin/bash
set -e
docker stop ddb-be || true
docker rm ddb-be || true
docker pull $FULL_IMAGE_TAG
docker run -d --name ddb-be -p 8080:8080 $FULL_IMAGE_TAG
EOF

            chmod +x $STARTUP_FILE

            // 새 인스턴스 템플릿 생성
            NEW_TMPL="tmpl-${MIG_NAME}-${BUILD_NUMBER}"
            gcloud compute instance-templates create $NEW_TMPL \
              --project=$PROJECT_ID \
              --region=$REGION \
              --machine-type=e2-small \
              --image-family=cos-stable \
              --image-project=cos-cloud \
              --boot-disk-size=10GB \
              --metadata-from-file startup-script=$STARTUP_FILE

            // MIG에 새로운 템플릿을 적용하여 롤링 업데이트 시작
            gcloud compute instance-groups managed rolling-action start-update $MIG_NAME \
              --project=$PROJECT_ID --region=$REGION \
              --version=template=$NEW_TMPL \
              --type=proactive \
              --max-surge=1 --max-unavailable=1 --min-ready=30

            // 안정성 검사: 일정 시간 내 MIG가 안정되지 않으면 롤백
            if ! gcloud compute instance-groups managed wait-until $MIG_NAME \
                  --project=$PROJECT_ID --region=$REGION \
                  --stable --timeout=900 ; then
              echo "❌ 새 버전 불안정 → 롤백 실행"
              gcloud compute instance-groups managed rolling-action start-update $MIG_NAME \
                --project=$PROJECT_ID --region=$REGION \
                --version=template=$OLD_TMPL \
                --type=proactive \
                --max-surge=1 --max-unavailable=1 --min-ready=30
              exit 1
            fi

            echo "✅ 배포 완료"
          '''
        }
      }
    }
  }

  post {
    success {
      // 빌드 성공 시 Discord 알림 전송
      withCredentials([string(credentialsId: 'Discord-Webhook', variable: 'DISCORD')]) {
        discordSend description: """
        제목 : ${currentBuild.displayName}
        결과 : ${currentBuild.result}
        실행 시간 : ${currentBuild.duration / 1000}s
        """,
        link: env.BUILD_URL,
        result: currentBuild.currentResult,
        title: "${env.JOB_NAME} : ${currentBuild.displayName} 성공",
        webhookURL: "$DISCORD"
      }
    }
    failure {
      // 빌드 실패 시 Discord 알림 전송
      withCredentials([string(credentialsId: 'Discord-Webhook', variable: 'DISCORD')]) {
        discordSend description: """
        제목 : ${currentBuild.displayName}
        결과 : ${currentBuild.result}
        실행 시간 : ${currentBuild.duration / 1000}s
        """,
        link: env.BUILD_URL,
        result: currentBuild.currentResult,
        title: "${env.JOB_NAME} : ${currentBuild.displayName} 실패",
        webhookURL: "$DISCORD"
      }
    }
  }
}

pipeline {
  agent any // 모든 Jenkins 에이전트에서 실행 가능

  parameters {
    // Discord에서 배포 승인 후 true로 변경하여 파이프라인 재실행
    booleanParam(name: 'APPROVED', defaultValue: false, description: 'Discord ✅ 승인 후 true로 재실행')
  }

  environment {
    // 서비스 식별자 및 GCP 관련 환경 변수
    SERVICE_NAME   = 'ai' // AI 서버 (FastAPI)
    PROJECT_ID     = 'my-gcp-project'
    REGION         = 'asia-northeast3'
    LOCATION       = 'asia-northeast3'
    MIG_NAME       = 'fastapi-prod-mig' // Managed Instance Group 이름
    REPOSITORY     = 'ddb-ai' // Docker 이미지 저장소 이름 (GAR)

		// Jenkins 빌드 번호를 이용한 이미지 태그 생성
    BUILD_NUMBER   = "${env.BUILD_NUMBER}"
    IMAGE_TAG      = "${SERVICE_NAME}:${COMMIT_HASH}-${BUILD_NUMBER}"
    FULL_IMAGE_TAG = "${LOCATION}-docker.pkg.dev/${PROJECT_ID}/${REPOSITORY}/${IMAGE_TAG}"
  }

  stages {

    stage('Git Checkout') {
      steps {
        // GitHub 저장소에서 코드 체크아웃 (main 브랜치)
        git branch: 'main', url: 'https://github.com/100-hours-a-week/7-team-ddb-ai.git'
      }
    }

    stage('Docker Build & Push (GAR)') {
      steps {
        // 서비스 계정 인증을 위해 GCP 키 파일 사용
        withCredentials([file(credentialsId: 'GCP-SA-JSON', variable: 'GCLOUD_KEY')]) {
          sh '''
            // GCP 인증 및 Docker 인증 구성
            gcloud auth activate-service-account --key-file=$GCP_KEY
            gcloud auth configure-docker ${LOCATION}-docker.pkg.dev --quiet

            // Docker 이미지 빌드 및 GAR로 푸시
            docker build -t $FULL_IMAGE_TAG .
            docker push $FULL_IMAGE_TAG
          '''
        }
      }
    }

    stage('Ask Approval (Discord)') {
      steps {
        // Discord에서 배포 승인 여부 요청 (✅ 버튼 클릭 필요)
        discordSend message: "[AI] Docker 이미지 태그 ${IMAGE_TAG} 배포 승인?",
                     buttons: '✅,❌',
                     webhookURL: credentials('Discord-Webhook')
      }
    }

    stage('Deploy to MIG (Docker)') {
      // Discord 승인 후에만 실행
      when { expression { params.APPROVED == true } }

      steps {
        // 다시 서비스 계정 인증 후 배포 실행
        withCredentials([file(credentialsId: 'GCP-SA-JSON', variable: 'GCP_KEY')]) {
          sh '''
            set -e
            gcloud auth activate-service-account --key-file=$GCP_KEY

            // 기존 MIG 템플릿 이름 저장 (롤백 대비)
            OLD_TMPL=$(gcloud compute instance-groups managed describe $MIG_NAME \
              --project=$PROJECT_ID --region=$REGION \
              --format="value(versions[0].instanceTemplate.basename)")

            // 새로운 스타트업 스크립트 생성 (기존 컨테이너 중지 → 새 이미지 실행)
            STARTUP_FILE="/tmp/startup-${BUILD_NUMBER}.sh"
            cat > $STARTUP_FILE <<EOF
#!/bin/bash
set -e
docker stop ddb-ai || true
docker rm ddb-ai || true
docker pull $FULL_IMAGE_TAG
docker run -d --name ddb-ai -p 8000:8000 $FULL_IMAGE_TAG
EOF

            chmod +x $STARTUP_FILE

            // 새 인스턴스 템플릿 생성
            NEW_TMPL="tmpl-${MIG_NAME}-${BUILD_NUMBER}"
            gcloud compute instance-templates create $NEW_TMPL \
              --project=$PROJECT_ID \
              --region=$REGION \
              --machine-type=e2-small \
              --image-family=cos-stable \
              --image-project=cos-cloud \
              --boot-disk-size=10GB \
              --metadata-from-file startup-script=$STARTUP_FILE

            // MIG 롤링 업데이트 실행
            gcloud compute instance-groups managed rolling-action start-update $MIG_NAME \
              --project=$PROJECT_ID --region=$REGION \
              --version=template=$NEW_TMPL \
              --type=proactive \
              --max-surge=1 --max-unavailable=1 --min-ready=30

            // 안정성 확인: 900초 내 안정되지 않으면 롤백
            if ! gcloud compute instance-groups managed wait-until $MIG_NAME \
                  --project=$PROJECT_ID --region=$REGION \
                  --stable --timeout=900 ; then
              echo "❌ 새 버전 불안정 → 롤백"
              gcloud compute instance-groups managed rolling-action start-update $MIG_NAME \
                --project=$PROJECT_ID --region=$REGION \
                --version=template=$OLD_TMPL \
                --type=proactive \
                --max-surge=1 --max-unavailable=1 --min-ready=30
              exit 1
            fi
          '''
        }
      }
    }
  }

  post {
    success {
      // 빌드 성공 시 Discord로 알림 전송
      withCredentials([string(credentialsId: 'Discord-Webhook', variable: 'DISCORD')]) {
        discordSend description: """
        제목 : ${currentBuild.displayName}
        결과 : ${currentBuild.result}
        실행 시간 : ${currentBuild.duration / 1000}s
        """,
        link: env.BUILD_URL,
        result: currentBuild.currentResult,
        title: "${env.JOB_NAME} : ${currentBuild.displayName} 성공",
        webhookURL: "$DISCORD"
      }
    }
    failure {
      // 빌드 실패 시 Discord로 알림 전송
      withCredentials([string(credentialsId: 'Discord-Webhook', variable: 'DISCORD')]) {
        discordSend description: """
        제목 : ${currentBuild.displayName}
        결과 : ${currentBuild.result}
        실행 시간 : ${currentBuild.duration / 1000}s
        """,
        link: env.BUILD_URL,
        result: currentBuild.currentResult,
        title: "${env.JOB_NAME} : ${currentBuild.displayName} 실패",
        webhookURL: "$DISCORD"
      }
    }
  }
}

pipeline {
  agent any // 어떤 Jenkins 노드에서도 실행 가능

  parameters {
    // Discord 수동 승인: ✅ 클릭 시 true로 설정 후 재실행
    booleanParam(name: 'APPROVED', defaultValue: false,
                 description: 'Discord ✅ 승인 후 true로 재실행')
  }

  environment {
    // 프론트엔드 서비스 설정
    SERVICE_NAME    = 'fe'
    PROJECT_ID      = 'my-gcp-project'
    REGION          = 'asia-northeast3'
    LOCATION        = 'asia-northeast3'
    MIG_NAME        = 'fe-prod-mig'
    REPOSITORY      = 'ddb-frontend' // Google Artifact Registry 저장소 이름

    // Jenkins 빌드 번호를 이용한 이미지 태그 생성
    BUILD_NUMBER    = "${env.BUILD_NUMBER}"
    IMAGE_TAG       = "${SERVICE_NAME}:${COMMIT_HASH}-${BUILD_NUMBER}"
    FULL_IMAGE_TAG  = "${LOCATION}-docker.pkg.dev/${PROJECT_ID}/${REPOSITORY}/${IMAGE_TAG}"
  }

  stages {

    stage('Git Checkout') {
      steps {
        // GitHub 저장소의 main 브랜치에서 소스코드 체크아웃
        git branch: 'main',
            url: 'https://github.com/100-hours-a-week/7-team-ddb-fe.git'
      }
    }

    stage('Docker Build & Push (GAR)') {
      steps {
        // GCP 인증을 위해 서비스 계정 키 파일 사용
        withCredentials([file(credentialsId: 'GCP-SA-JSON', variable: 'GCP_KEY')]) {
          sh '''
            // GCP 서비스 계정 활성화 및 GAR 인증 설정
            gcloud auth activate-service-account --key-file=$GCP_KEY
            gcloud auth configure-docker ${LOCATION}-docker.pkg.dev --quiet

            // Docker 이미지 빌드 및 Google Artifact Registry로 푸시
            docker build -t $FULL_IMAGE_TAG .
            docker push $FULL_IMAGE_TAG
          '''
        }
      }
    }

    stage('Ask Approval (Discord)') {
      steps {
        // Discord 알림: 배포 승인 요청 메시지
        discordSend message: "[FE] Docker 이미지 태그 ${IMAGE_TAG} 배포 승인?",
                     buttons: '✅,❌',
                     webhookURL: credentials('Discord-Webhook')
      }
    }

    stage('Deploy to MIG (Docker)') {
      // Discord 승인 시에만 배포 단계 진행
      when { expression { params.APPROVED == true } }
      steps {
        withCredentials([file(credentialsId: 'GCP-SA-JSON', variable: 'GCP_KEY')]) {
          sh '''
            set -e
            gcloud auth activate-service-account --key-file=$GCP_KEY

            // 현재 MIG에서 사용 중인 템플릿 이름 확인 (롤백 대비)
            OLD_TMPL=$(gcloud compute instance-groups managed describe $MIG_NAME \
              --project=$PROJECT_ID --region=$REGION \
              --format="value(versions[0].instanceTemplate.basename)")

            // 새 인스턴스를 위한 startup script 생성
            STARTUP_FILE="/tmp/startup-${BUILD_NUMBER}.sh"
            cat > $STARTUP_FILE <<EOF
#!/bin/bash
set -e
docker stop ddb-fe || true
docker rm ddb-fe || true
docker pull $FULL_IMAGE_TAG
docker run -d --name ddb-fe -p 3000:3000 $FULL_IMAGE_TAG
EOF

            chmod +x $STARTUP_FILE

            // 새로운 인스턴스 템플릿 생성
            NEW_TMPL="tmpl-${MIG_NAME}-${BUILD_NUMBER}"
            gcloud compute instance-templates create $NEW_TMPL \
              --project=$PROJECT_ID \
              --region=$REGION \
              --machine-type=e2-small \
              --image-family=cos-stable \
              --image-project=cos-cloud \
              --boot-disk-size=10GB \
              --metadata-from-file startup-script=$STARTUP_FILE

            // MIG 롤링 업데이트 실행
            gcloud compute instance-groups managed rolling-action start-update $MIG_NAME \
              --project=$PROJECT_ID --region=$REGION \
              --version=template=$NEW_TMPL \
              --type=proactive \
              --max-surge=1 --max-unavailable=1 --min-ready=30

            // 안정성 검사 실패 시 롤백
            if ! gcloud compute instance-groups managed wait-until $MIG_NAME \
                  --project=$PROJECT_ID --region=$REGION \
                  --stable --timeout=900 ; then
              echo "❌ 새 버전 불안정 → 롤백"
              gcloud compute instance-groups managed rolling-action start-update $MIG_NAME \
                --project=$PROJECT_ID --region=$REGION \
                --version=template=$OLD_TMPL \
                --type=proactive \
                --max-surge=1 --max-unavailable=1 --min-ready=30
              exit 1
            fi
          '''
        }
      }
    }
  }

  post {
    // 성공 시 Discord 알림
    success {
      withCredentials([string(credentialsId: 'Discord-Webhook', variable: 'DISCORD')]) {
        discordSend description: """
        제목 : ${currentBuild.displayName}
        결과 : ${currentBuild.result}
        실행 시간 : ${currentBuild.duration / 1000}s
        """,
        link: env.BUILD_URL,
        result: currentBuild.currentResult,
        title: "${env.JOB_NAME} : ${currentBuild.displayName} 성공",
        webhookURL: "$DISCORD"
      }
    }
    // 실패 시 Discord 알림
    failure {
      withCredentials([string(credentialsId: 'Discord-Webhook', variable: 'DISCORD')]) {
        discordSend description: """
        제목 : ${currentBuild.displayName}
        결과 : ${currentBuild.result}
        실행 시간 : ${currentBuild.duration / 1000}s
        """,
        link: env.BUILD_URL,
        result: currentBuild.currentResult,
        title: "${env.JOB_NAME} : ${currentBuild.displayName} 실패",
        webhookURL: "$DISCORD"
      }
    }
  }
}