Миграция с Jenkins

Jenkins и GitVerse CI/CD позволяют автоматизировать сборку, тестирование и развертывание приложений. Несмотря на различия в конфигурации, большинство сценариев Jenkins Pipeline можно перенести в GitVerse CI/CD.

Введение

Обе системы используют схожие принципы организации CI/CD:

  • Jenkins использует stages и steps, GitVerse — jobs и steps;
  • обе платформы поддерживают параллельное выполнение заданий, матричные сборки и контейнеризацию;
  • Jenkins Agents и GitVerse Runners предоставляют среды выполнения задач;
  • команды сборки и тестирования обычно можно перенести без изменений.

Основные отличия

  • конфигурация. Jenkins использует Declarative Pipeline и Scripted Pipeline на Groovy. GitVerse описывает процессы в YAML-файлах, расположенных в .gitverse/workflows/;
  • инфраструктура. Jenkins требует управления сервером и агентами. GitVerse предоставляет облачные раннеры и поддерживает собственные (self-hosted) и организационные раннеры;
  • выполнение. В Jenkins этапы могут использовать общее рабочее пространство. В GitVerse каждое задание (job) выполняется в отдельной среде. Для передачи файлов между jobs используйте артефакты.

Сопоставление возможностей

Организация Pipeline

JenkinsGitVerse CI/CD
Jenkinsfile.gitverse/workflows/*.yml
pipelineWorkflow
agentjobs.<job_id>.runs-on
agent { docker ... }jobs.<job_id>.container
stages / stagejobs или группы steps
stepsjobs.<job_id>.steps
sh, batsteps[*].run
postШаги с if: always(), success(), failure()

Директивы

JenkinsGitVerse CI/CD
environmentenv
credentialssecrets
parameterson.workflow_dispatch.inputs
triggerson
cronon.schedule
whenjobs.<job_id>.if или steps[*].if
options { timeout(...) }timeout-minutes
toolsActions настройки среды или инструменты раннера
parallelНезависимые jobs
matrix / axesstrategy.matrix
inputworkflow_dispatch для ручного запуска

Важно: workflow_dispatch позволяет вручную запускать workflow с параметрами, но не является прямой заменой input, приостанавливающего выполнение Jenkins Pipeline до подтверждения.

Последовательное и параллельное выполнение

В Jenkins этапы stages обычно выполняются последовательно. В GitVerse независимые jobs могут выполняться параллельно.

Чтобы задать последовательность выполнения, используйте needs:

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - run: echo "Build"
 
  test:
    needs: build
    runs-on: ubuntu-latest
    steps:
      - run: echo "Test"
 
  deploy:
    needs: test
    runs-on: ubuntu-latest
    steps:
      - run: echo "Deploy"

Для ограничения параллелизма матричных заданий предусмотрен strategy.max-parallel.

Примеры миграции

1. Запуск по расписанию

Jenkins

pipeline {
  agent any
  triggers {
    cron('H/15 * * * 1-5')
  }
  stages {
    stage('Build') {
      steps {
        sh 'make build'
      }
    }
  }
}

GitVerse CI/CD

name: Scheduled Build
 
on:
  schedule:
    - cron: '*/15 * * * 1-5'
 
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: make build

Jenkins использует H для распределения запусков по времени. В GitVerse применяется стандартное cron-выражение с явным указанием минут. Минимальный интервал составляет 15 минут для облачных раннеров и 5 минут для собственных.

2. Переменные окружения

Jenkins

pipeline {
  agent any
  environment {
    MAVEN_PATH = '/usr/local/maven'
  }
  stages {
    stage('Build') {
      steps {
        sh '$MAVEN_PATH/bin/mvn package'
      }
    }
  }
}

GitVerse CI/CD

jobs:
  build:
    runs-on: ubuntu-latest
    env:
      MAVEN_PATH: /usr/local/maven
    steps:
      - uses: actions/checkout@v4
      - run: $MAVEN_PATH/bin/mvn package

Путь к Maven должен существовать на выбранном раннере. Конфиденциальные данные из Jenkins Credentials следует перенести в секреты GitVerse и использовать через ${{ secrets.NAME }}.

3. Зависимости между заданиями

Jenkins

pipeline {
  agent any
  triggers {
    upstream(
      upstreamProjects: 'build-lib',
      threshold: hudson.model.Result.SUCCESS
    )
  }
  stages {
    stage('Test') {
      steps {
        sh 'make test'
      }
    }
  }
}

GitVerse CI/CD

Если сборка и тестирование объединены в один workflow:

jobs:
  build-lib:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: make build
 
  test:
    needs: build-lib
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: make test

needs задает зависимости только внутри одного workflow. Для запуска отдельных workflow или проектов потребуется другой механизм оркестрации.

4. Матричные сборки

Jenkins

pipeline {
  agent none
  stages {
    stage('Test') {
      matrix {
        axes {
          axis {
            name 'PLATFORM'
            values 'linux', 'macos'
          }
        }
        agent { label "${PLATFORM}" }
        stages {
          stage('Run tests') {
            steps {
              sh 'npm ci'
              sh 'npm test'
            }
          }
        }
      }
    }
  }
}

GitVerse CI/CD

name: Matrix Tests
 
on: [push, pull_request]
 
jobs:
  test:
    runs-on: [self-hosted, "${{ matrix.platform }}"]
 
    strategy:
      fail-fast: false
      matrix:
        platform: [linux, macos]
 
    steps:
      - uses: actions/checkout@v4
 
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
 
      - run: npm ci
      - run: npm test

Для выполнения примера необходимо зарегистрировать self-hosted раннеры с соответствующими метками linux и macos.

Дополнительные рекомендации

При переносе сложных Pipeline учитывайте следующие особенности:

  • плагины Jenkins: замените их готовыми Actions, shell-скриптами или собственными действиями;
  • shared Libraries: используйте переиспользуемые workflow (workflow_call) или собственные Actions;
  • артефакты: вместо archiveArtifacts, stash и unstash используйте механизмы публикации и получения артефактов;
  • Docker: облачные раннеры GitVerse не предоставляют доступ к docker.sock. Для сценариев, которым необходим Docker daemon, используйте self-hosted раннеры.

Дополнительная информация: Синтаксис workflow, Раннеры, Секреты и переменные.