Привет, я junior DevOps-инженер

# Базовый образ для всех jobs — Docker с поддержкой DinD (Docker-in-Docker)
image: docker:24
services: [ docker:24-dind ]  # Docker-in-Docker — нужен для сборки образов

# CI_ переменные — автоматически заполняются GitLab'ом
variables:
  IMAGE:  $CI_REGISTRY_IMAGE:$CI_COMMIT_SHORT_SHA  # тег = короткий хеш коммита
  LATEST: $CI_REGISTRY_IMAGE:latest               # тег latest для последней версии

# Этапы пайплайна — выполняются строго по порядку
stages: [ lint, test, build, deploy ]

# ── ЭТАП 1: Проверка кода ──────────────────────────────────
lint:
  stage: lint
  image: node:20-alpine  # свой образ для этого job'а
  cache:
    key:   $CI_COMMIT_REF_SLUG  # ключ кеша = имя ветки
    paths: [ node_modules/ ]    # кешируем зависимости — ускоряет повторные запуски
  script: [ npm ci, npm run lint ]

# ── ЭТАП 2: Тесты с покрытием ─────────────────────────────
test:
  stage: test
  image: node:20-alpine
  script: [ npm ci, npm test -- --coverage ]
  coverage: '/Lines\s*:\s*(\d+\.?\d*)%/'  # regex для парсинга % покрытия

# ── ЭТАП 3: Сборка Docker-образа ──────────────────────────
build:
  stage: build
  before_script:
      # Логинимся в GitLab Container Registry (встроенный registry)
    - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
  script:
      # --cache-from $LATEST — переиспользуем слои предыдущего образа (быстрее)
    - docker build --cache-from $LATEST -t $IMAGE -t $LATEST .
    - docker push $IMAGE && docker push $LATEST  # пушим оба тега
  only: [ main ]  # только для ветки main

# ── ЭТАП 4: Деплой на сервер ──────────────────────────────
deploy:
  stage: deploy
  image: alpine  # лёгкий образ — только SSH клиент
  environment:
    name: production  # GitLab Environments — отображается в Deployments UI
    url:  https://projectforfamilystablelife.top
  before_script:
    - apk add --no-cache openssh-client  # устанавливаем SSH в alpine
    - eval $(ssh-agent -s) && echo "$SSH_KEY" | ssh-add -  # добавляем ключ в агент
    - ssh-keyscan $SSH_HOST >> ~/.ssh/known_hosts  # доверяем серверу (без интерактивного yes)
  script:
      # Один SSH-вызов: скачать образ и рестартовать через docker compose
    - ssh $SSH_USER@$SSH_HOST "docker pull $LATEST && docker compose up -d"
  only: [ main ]

# Синтаксис идентичен GitHub Actions — можно копировать конфиги без изменений
name: Deploy
on:
  push:
    branches: [ main ]

jobs:
  build-deploy:
    runs-on: ubuntu-latest  # нужен act_runner на вашем сервере
    steps:
            # Скачиваем код репозитория
      - uses: actions/checkout@v4
            # Настраиваем Node.js с кешем зависимостей
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: npm   # кешируем node_modules между запусками
            # Устанавливаем зависимости и запускаем тесты
      - run: npm ci && npm test
            # Авторизуемся в registry и собираем образ
      - name: Build & Push Docker
        run: |
          echo ${{ secrets.REG_TOKEN }} | docker login ${{ secrets.REGISTRY }} -u ${{ secrets.REG_USER }} --password-stdin
          docker build -t ${{ secrets.REGISTRY }}/app:latest .  # собираем образ
          docker push ${{ secrets.REGISTRY }}/app:latest          # пушим в Gitea registry
            # Деплоим на сервер через SSH (тот же action что в GitHub Actions)
      - uses: appleboy/ssh-action@v1.0.3
        with:
          host:     ${{{ secrets.SSH_HOST }}
          username: ${{{ secrets.SSH_USER }}
          key:      ${{{ secrets.SSH_KEY }}
          script:   docker pull ${{ secrets.REGISTRY }}/app:latest && docker compose up -d
            # Уведомление в Telegram если что-то пошло не так
      - name: Notify Telegram on fail
        if: failure()  # выполнить только при ошибке
        run: curl -s -X POST ${{ secrets.TG_URL }} -d "text=❌ Deploy failed: ${{ gitea.sha }}"

// Declarative Pipeline — современный синтаксис Jenkins
// Groovy DSL: похож на Kotlin/Java но для конфигурации пайплайна
pipeline {
    // Агент — где запускать. 'docker' = на Jenkins-ноде с лейблом 'docker'
  agent { label 'docker' }

  environment {
    IMAGE = "registry.example.com/my-app"
        // BUILD_NUMBER — автоинкремент, GIT_COMMIT[0..6] — первые 7 символов хеша
    TAG   = "${env.BUILD_NUMBER}-${env.GIT_COMMIT[0..6]}"
  }

  options {
    timeout(time: 30, unit: 'MINUTES')  // убить сборку если > 30 минут
    buildDiscarder(logRotator(numToKeepStr: '10'))  // хранить только 10 последних сборок
  }

  stages {
        // ── ЭТАП 1: Параллельные Lint и Test (одновременно!) ────
    stage('Lint & Test') {
      parallel {  // запускаем lint и test одновременно — экономим время
        stage('Lint') {
          steps {
                        // -v $PWD:/app монтируем код, -w /app = рабочая директория
            sh 'docker run --rm -v $PWD:/app -w /app node:20-alpine npm ci && npm run lint'
          }
        }
        stage('Test') {
          steps { sh 'docker run --rm -v $PWD:/app -w /app node:20-alpine sh -c "npm ci && npm test"' }
          post {
            always { junit 'junit.xml' }  // публикуем результаты тестов в UI Jenkins
          }
        }
      }
    }

        // ── ЭТАП 2: Сборка и публикация образа ──────────────────
    stage('Build & Push') {
      when { branch 'main' }  // выполнять только для ветки main
      steps {
        script {
                    // withRegistry — логинимся в registry используя credentials из Jenkins
          docker.withRegistry('https://registry.example.com', 'reg-creds') {
            def img = docker.build("${IMAGE}:${TAG}")
            img.push();       // пушим с тегом BUILD_NUMBER
            img.push('latest')  // и тег latest
          }
        }
      }
    }

        // ── ЭТАП 3: Деплой с ручным подтверждением ──────────────
    stage('Deploy') {
      when { branch 'main' }
            // !! ПАЙПЛАЙН ОСТАНАВЛИВАЕТСЯ и ждёт нажатия кнопки ─ ручной approve
      input { message "Deploy to production?"; ok 'Deploy' }
      steps {
                // sshagent — добавляет SSH-ключ из credentials Jenkins в агент
        sshagent(['deploy-key']) {
          sh "ssh $DEPLOY_HOST 'docker pull ${IMAGE}:latest && docker compose up -d'"
        }
      }
    }
  }

    // ── Всегда выполняется после пайплайна ──────────────────
  post {
    success { sh """curl -s "$TG_URL" -d "text=✅ ${JOB_NAME} #${BUILD_NUMBER} ok" """ }
    failure { sh """curl -s "$TG_URL" -d "text=❌ ${JOB_NAME} #${BUILD_NUMBER} failed" """ }
    always  { cleanWs() }  // очищаем рабочую директорию — экономим место на диске
  }
}