.gitlab-ci.yml → GitLab Runner(에이전트) 실행 → 결과를 GitLab UI에 표시

# .gitlab-ci.yml
stages:
  - install
  - test
  - build
  - deploy

variables:
  NODE_VERSION: "20"
  IMAGE_NAME: $CI_REGISTRY_IMAGE  # GitLab Container Registry 자동 변수

# 공통 설정 (앵커 재사용)
.node_template: &node_template
  image: node:20-alpine
  cache:
    key: $CI_COMMIT_REF_SLUG
    paths:
      - node_modules/

install:
  <<: *node_template
  stage: install
  script:
    - npm ci

test:
  <<: *node_template
  stage: test
  script:
    - npm test -- --coverage
  coverage: '/Statements\s*:\s*([\d.]+)%/'  # 커버리지 수치 파싱
  artifacts:
    reports:
      junit: coverage/junit.xml
    paths:
      - coverage/

build:
  <<: *node_template
  stage: build
  script:
    - npm run build
  artifacts:
    paths:
      - .next/
    expire_in: 1 hour

docker-build:
  stage: build
  image: docker:24
  services:
    - docker:24-dind
  script:
    - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
    - docker build -t $IMAGE_NAME:$CI_COMMIT_SHORT_SHA .
    - docker push $IMAGE_NAME:$CI_COMMIT_SHORT_SHA
    - docker tag $IMAGE_NAME:$CI_COMMIT_SHORT_SHA $IMAGE_NAME:latest
    - docker push $IMAGE_NAME:latest

deploy-staging:
  stage: deploy
  environment:
    name: staging
    url: https://staging.example.com
  script:
    - ssh deploy@staging "docker pull $IMAGE_NAME:latest && docker compose up -d"
  only:
    - develop

deploy-production:
  stage: deploy
  environment:
    name: production
    url: https://example.com
  script:
    - ssh deploy@production "docker pull $IMAGE_NAME:latest && docker compose up -d"
  only:
    - main
  when: manual  # 수동 승인 후 배포

CI_COMMIT_SHA          → 전체 커밋 해시
CI_COMMIT_SHORT_SHA    → 앞 8자리
CI_COMMIT_BRANCH       → 브랜치명
CI_REGISTRY            → GitLab Container Registry 주소
CI_REGISTRY_IMAGE      → 현재 프로젝트 이미지 경로
CI_ENVIRONMENT_NAME    → 배포 환경 이름

// Jenkinsfile
pipeline {
  agent any

  environment {
    IMAGE_NAME = 'registry.example.com/my-app'
    REGISTRY   = 'registry.example.com'
  }

  stages {
    stage('Install') {
      agent { docker { image 'node:20-alpine' } }
      steps { sh 'npm ci' }
    }

    stage('Test') {
      agent { docker { image 'node:20-alpine' } }
      steps {
        sh 'npm test -- --coverage'
      }
      post {
        always { junit 'coverage/junit.xml' }
      }
    }

    stage('Docker Build & Push') {
      steps {
        script {
          docker.withRegistry("https://${REGISTRY}", 'registry-creds') {
            def img = docker.build("${IMAGE_NAME}:${env.GIT_COMMIT[0..7]}")
            img.push()
            img.push('latest')
          }
        }
      }
    }

    stage('Deploy Staging') {
      when { branch 'develop' }
      steps {
        sshagent(['staging-ssh-key']) {
          sh 'ssh deploy@staging "docker pull ${IMAGE_NAME}:latest && docker compose up -d"'
        }
      }
    }

    stage('Deploy Production') {
      when { branch 'main' }
      input { message '프로덕션에 배포하시겠습니까?' }  // 수동 승인
      steps {
        sshagent(['prod-ssh-key']) {
          sh 'ssh deploy@production "docker pull ${IMAGE_NAME}:latest && docker compose up -d"'
        }
      }
    }
  }

  post {
    success { slackSend message: "✅ 빌드 성공: ${env.JOB_NAME}" }
    failure { slackSend message: "❌ 빌드 실패: ${env.JOB_NAME}" }
  }
}

# GitLab: 선언형 YAML → 읽기 쉬움, IDE 자동완성 지원
script:
  - npm ci
  - npm test

// Jenkins: Groovy DSL → 복잡한 로직 구현 가능
steps {
  script {
    def version = sh(script: 'cat package.json | jq -r .version', returnStdout: true).trim()
    currentBuild.displayName = "#${BUILD_NUMBER} - v${version}"
  }
}

# GitLab — 코드 안에서 선언
rules:
  - if: $CI_COMMIT_BRANCH == "main"
  - if: $CI_PIPELINE_SOURCE == "merge_request_event"
  - if: $CI_COMMIT_TAG                   # 태그 푸시 시
    when: never                           # 제외

// Jenkins — UI에서 설정하거나 코드로 선언
triggers {
  pollSCM('H/5 * * * *')  // 5분마다 변경 확인
  cron('0 2 * * *')        // 매일 새벽 2시
}
// 또는 Webhook 설정 (플러그인 필요)

# GitLab: 내장 캐시 + 아티팩트
cache:
  key: $CI_COMMIT_REF_SLUG
  paths:
    - node_modules/
    - .npm/

artifacts:
  paths:
    - dist/
  expire_in: 7 days

// Jenkins: 플러그인 또는 수동 구현
steps {
  // S3나 공유 볼륨에 수동으로 저장
  sh 'tar czf node_modules.tar.gz node_modules'
  s3Upload(bucket: 'my-cache', path: "cache/${env.BRANCH_NAME}/node_modules.tar.gz")
}