Миграция с 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
| Jenkins | GitVerse CI/CD |
|---|---|
Jenkinsfile | .gitverse/workflows/*.yml |
pipeline | Workflow |
agent | jobs.<job_id>.runs-on |
agent { docker ... } | jobs.<job_id>.container |
stages / stage | jobs или группы steps |
steps | jobs.<job_id>.steps |
sh, bat | steps[*].run |
post | Шаги с if: always(), success(), failure() |
Директивы
| Jenkins | GitVerse CI/CD |
|---|---|
environment | env |
credentials | secrets |
parameters | on.workflow_dispatch.inputs |
triggers | on |
cron | on.schedule |
when | jobs.<job_id>.if или steps[*].if |
options { timeout(...) } | timeout-minutes |
tools | Actions настройки среды или инструменты раннера |
parallel | Независимые jobs |
matrix / axes | strategy.matrix |
input | workflow_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 buildJenkins использует 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 testneeds задает зависимости только внутри одного 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, Раннеры, Секреты и переменные.