Миграция с GitLab CI/CD

Info

В этом руководстве рассмотрим, как перенести CI/CD-процессы из GitLab в GitVerse: преобразовать конфигурацию pipeline в workflow, настроить условия запуска, задания, раннеры, переменные, секреты, кеширование и передачу артефактов.

GitLab CI/CD и GitVerse CI/CD решают похожие задачи, но используют разные форматы конфигурации.

В GitLab CI/CD задания обычно описываются в файле .gitlab-ci.yml. В GitVerse CI/CD используются отдельные YAML-файлы workflow, которые размещаются в каталоге .gitverse/workflows/.

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

Основные различия GitLab CI/CD и GitVerse CI/CD

GitLab CI/CDGitVerse CI/CD
.gitlab-ci.yml.gitverse/workflows/*.yaml
PipelineWorkflow
JobJob
stagesЗависимости между заданиями через needs
scriptШаги steps с командами run
before_scriptПодготовительные шаги в steps
after_scriptЗавершающие шаги с условиями if
rules, only, exceptТриггеры on и условия if
tagsruns-on
imagecontainer.image
variablesenv, vars, secrets
cacheactions/cache
artifactsactions/upload-artifact@v4
dependencies для артефактовneeds и actions/download-artifact@v4
when: manualworkflow_dispatch для ручного запуска workflow
allow_failurecontinue-on-error

Note

В таблице приведены ближайшие соответствия. Некоторые механизмы GitLab и GitVerse работают по-разному, поэтому сложные pipeline необходимо адаптировать с учетом их логики.

Подготовка к миграции

Перед переносом CI/CD:

  1. Перенесите исходный код проекта в репозиторий GitVerse.
  2. Изучите конфигурацию .gitlab-ci.yml и подключаемые файлы.
  3. Определите, какие задания должны выполняться последовательно, а какие — параллельно.
  4. Проверьте условия запуска pipeline: push, merge request, теги, расписания и ручной запуск.
  5. Подготовьте необходимые секреты и переменные в GitVerse.
  6. Выберите облачные или собственные раннеры.
  7. Проверьте зависимости от GitLab API, реестров пакетов, контейнеров и встроенных переменных CI_*.

Info

Рекомендуется сначала перенести сборку и тестирование, проверить их выполнение в GitVerse и только после этого настраивать публикацию артефактов и деплой.

Использование Actions

В GitVerse CI/CD можно использовать готовые переиспользуемые компоненты — экшены (actions). Они позволяют выполнять типовые операции — клонирование репозитория, настройку окружения, сборку, тестирование и публикацию артефактов — без необходимости писать собственные скрипты.

Action подключается внутри шага с помощью ключа uses:

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

Общий формат подключения:

uses: <владелец>/<репозиторий>@<ref>

Значение ref определяет, какую версию action необходимо использовать. Можно указать:

  • тег версии — например, @v4 или @v4.2.0. Подходит для использования опубликованных версий;
  • ветку — например, @main. Позволяет использовать актуальное состояние указанной ветки;
  • хеш коммита (SHA) — позволяет зафиксировать action на конкретном коммите независимо от последующих изменений веток и тегов.

Примеры:

steps:
  # По тегу версии
  - uses: actions/checkout@v4
 
  # По конкретному тегу релиза
  - uses: actions/checkout@v4.2.0
 
  # По ветке
  - uses: actions/checkout@main
 
  # По полному SHA коммита
  - uses: actions/checkout@8f4b7f84864484a7bf31766abe9204da3cbe65b3

Рекомендация: для воспроизводимых сборок и повышенной безопасности используйте полный SHA коммита. Если важно автоматически получать совместимые обновления action, удобнее указывать тег версии. Использование ветки может привести к изменению поведения workflow без изменения его конфигурации.

Подробнее см. «Синтаксис workflow».

Перенос простого pipeline

Рассмотрим pipeline из двух заданий: тестирование и сборка приложения.

Конфигурация GitLab CI/CD

Файл .gitlab-ci.yml:

stages:
  - test
  - build
 
test:
  stage: test
  script:
    - ./ci/test.sh
 
build:
  stage: build
  script:
    - ./ci/build.sh
  artifacts:
    paths:
      - dist/

В этом примере:

  • stages задает порядок выполнения этапов;
  • test запускает тесты;
  • build выполняется после завершения этапа test;
  • artifacts сохраняет файлы из каталога dist/.

Конфигурация GitVerse CI/CD

Создайте файл .gitverse/workflows/ci.yaml:

name: CI
 
on:
  push:
    branches:
      - main
 
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
 
      - name: Run tests
        run: sh ./ci/test.sh
 
  build:
    needs: test
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
 
      - name: Build application
        run: sh ./ci/build.sh
 
      - name: Upload artifact
        uses: actions/upload-artifact@v4
        with:
          name: build-output
          path: dist/

В GitVerse:

  1. on определяет события, запускающие workflow.
  2. jobs содержит задания.
  3. runs-on выбирает раннер для выполнения задания.
  4. steps описывает последовательность шагов.
  5. run выполняет команду.
  6. needs: test указывает, что сборка зависит от успешного завершения тестирования.
  7. actions/upload-artifact сохраняет результаты сборки.

Результат: при отправке изменений в ветку main GitVerse запускает тестирование. После успешного завершения тестов выполняется сборка, а файлы из dist/ сохраняются как артефакт.

Note

Пример предполагает, что в репозитории существуют скрипты ci/test.sh и ci/build.sh, а после сборки создается каталог dist/. При необходимости замените команды на команды вашего проекта.

Перенос условий запуска

В GitLab CI/CD условия запуска задаются с помощью workflow: rules, rules, only и except.

В GitVerse CI/CD для запуска workflow используется секция on, а для управления выполнением отдельных заданий и шагов — if.

Запуск при изменениях в определенной ветке

GitLab CI/CD:

build:
  script:
    - make build
  rules:
    - if: '$CI_COMMIT_BRANCH == "main"'

GitVerse CI/CD:

name: Build
 
on:
  push:
    branches:
      - main
 
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: make build

Workflow запускается при отправке изменений в ветку main.

Если workflow обрабатывает несколько событий, а ограничение требуется только для определенной job, можно использовать if:

jobs:
  build:
    if: ${{ gitverse.event_name == 'push' && gitverse.ref_name == 'main' }}
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: make build

Запуск при создании pull request

В GitLab CI/CD для pipeline запроса на слияние используется событие merge_request_event.

Пример GitLab:

test:
  script:
    - make test
  rules:
    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'

В GitVerse для запросов на слияние используется событие pull_request:

name: Pull Request Checks
 
on:
  pull_request:
    branches:
      - main
    types:
      - opened
      - reopened
      - synchronize
 
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: make test

Workflow запускается при открытии, повторном открытии и обновлении pull request, направленного в ветку main.

Note

В GitVerse поддерживаются не все типы событий pull_request. Перед переносом сложных сценариев ознакомьтесь с разделом Триггеры запуска workflow.

Запуск при изменении определенных файлов

В GitLab CI/CD можно использовать rules:changes:

build:
  script:
    - make build
  rules:
    - changes:
        - src/**/*

В GitVerse для фильтрации событий по измененным файлам используется paths:

name: Build Source
 
on:
  push:
    paths:
      - 'src/**'
 
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: make build

Workflow запускается при изменении файлов в каталоге src/.

Warning

В GitLab rules:changes управляет выполнением конкретного задания, а в GitVerse on.push.paths фильтрует запуск всего workflow. Если разные задания должны реагировать на изменения в разных каталогах, может потребоваться разделить их на несколько workflow.

Особенности переноса rules

В GitLab правила rules проверяются по порядку: первое совпавшее правило определяет поведение задания.

В GitVerse условия if используются для проверки выражений, а триггеры on — для выбора событий.

Поэтому сложные комбинации rules, when, changes и exists нельзя автоматически преобразовать в if без проверки логики.

Перенос этапов и зависимостей

В GitLab CI/CD порядок выполнения заданий обычно задается через stages:

stages:
  - build
  - test
  - deploy

В GitVerse CI/CD порядок выполнения можно задать через needs:

name: Pipeline
 
on:
  push:
    branches:
      - main
 
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"

Результат: задания выполняются последовательно:

build → test → deploy

Если зависимость needs не указана, задания могут выполняться параллельно.

Одно задание может зависеть от нескольких:

needs: [lint, test, build]

Info

В GitLab задания одного этапа обычно могут выполняться параллельно, а следующий этап ожидает завершения предыдущего. При переносе в GitVerse нужно явно указать зависимости, которые должны сохранять такой порядок.

Перенос команд script, before_script и after_script

В GitLab CI/CD команды выполняются через script, а подготовка и завершающие действия могут задаваться с помощью before_script и after_script.

Пример GitLab:

test:
  before_script:
    - echo "Preparing environment"
  script:
    - make test
  after_script:
    - echo "Cleaning up"

В GitVerse эти операции можно разделить на шаги:

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
 
      - name: Prepare environment
        run: echo "Preparing environment"
 
      - name: Run tests
        run: make test
 
      - name: Cleanup
        if: ${{ always() }}
        run: echo "Cleaning up"

Шаг с условием always() предназначен для выполнения завершающих команд независимо от результата предыдущих шагов.

Note

Поведение after_script в GitLab и шага с always() в GitVerse не полностью идентично. Например, при принудительном завершении раннера завершающие команды могут не выполниться.

Перенос раннеров и окружения выполнения

В GitLab CI/CD раннер часто выбирается по тегам:

build:
  tags:
    - linux
  script:
    - make build

В GitVerse используется параметр runs-on:

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

GitVerse поддерживает облачные, локальные и организационные раннеры.

Использование собственного раннера

Если для сборки необходимы специальные инструменты, доступ к внутренней сети или собственная инфраструктура, можно зарегистрировать self-hosted раннер.

Пример:

jobs:
  build:
    runs-on: [self-hosted, x64]
    steps:
      - uses: actions/checkout@v4
      - run: make build

Метки в runs-on должны соответствовать меткам зарегистрированного раннера.

Warning

GitLab Runner нельзя использовать в GitVerse без замены или перенастройки. Для выполнения заданий необходимо зарегистрировать поддерживаемый GitVerse Runner.

Подробнее: «Раннеры».

Использование контейнеров

В GitLab для запуска задания в контейнере используется image:

build:
  image: node:20
  script:
    - node --version

В GitVerse образ можно указать через container.image:

jobs:
  build:
    runs-on: ubuntu-latest
    container:
      image: node:20
    steps:
      - run: node --version

Note

Перед миграцией контейнерных заданий проверьте возможности выбранного раннера. Запуск задания в контейнере и выполнение команд docker build через Docker daemon — разные сценарии. Для Docker-сборок может потребоваться собственный раннер.

Перенос переменных и секретов

В GitLab CI/CD переменные можно задавать в YAML-файле или настройках проекта.

В GitVerse для работы со значениями используются:

  • env — переменные окружения, заданные в workflow;
  • vars — неконфиденциальные переменные из настроек репозитория или организации;
  • secrets — конфиденциальные значения из настроек репозитория или организации.

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

GitLab CI/CD:

variables:
  APP_ENV: production

GitVerse CI/CD:

env:
  APP_ENV: production

Переменные можно задавать на уровне workflow, job или отдельного шага:

jobs:
  build:
    runs-on: ubuntu-latest
    env:
      APP_ENV: production
    steps:
      - run: echo "$APP_ENV"

Переменные из настроек репозитория

Создайте переменную в разделе:

Настройки репозитория → Секреты и переменные

Затем используйте ее через контекст vars:

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Show application version
        env:
          APP_VERSION: ${{ vars.APP_VERSION }}
        run: echo "Version: $APP_VERSION"

Секреты

Токены, пароли и ключи необходимо сохранить как секреты GitVerse.

Например, если в настройках создан секрет API_TOKEN, его можно передать команде через переменную окружения:

jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - name: Publish application
        env:
          API_TOKEN: ${{ secrets.API_TOKEN }}
        run: ./ci/publish.sh

Warning

Не сохраняйте конфиденциальные значения в vars и не указывайте их непосредственно в YAML-файле. Не выводите секреты в логи и не включайте их в артефакты.

При переносе переменных из GitLab также учитывайте:

  1. Переменные с настройками protected, masked и environment scope не следует считать автоматически эквивалентными секретам GitVerse.
  2. Необходимо отдельно проверить, какие workflow и ветки имеют доступ к секретам.
  3. Для секретов и переменных GitVerse запрещены некоторые префиксы, включая GITLAB_ и GITVERSE_.
  4. После миграции рекомендуется заменить токены, которые больше не должны использоваться в GitLab.

Подробнее: «Секреты и переменные».

Переменные типа File

В GitLab переменные типа File могут предоставляться заданию как путь к временному файлу.

Если в GitVerse необходимо создать файл из секрета, можно сохранить его содержимое в Base64 и восстановить во время выполнения задания:

steps:
  - name: Create certificate file
    env:
      CERT_B64: ${{ secrets.CERT_B64 }}
    run: |
      set -eu
      umask 077
      printf '%s' "$CERT_B64" | base64 --decode > certificate.pem

В примере CERT_B64 — секрет, содержащий закодированное содержимое сертификата.

Note

Base64 не является шифрованием. Значение необходимо хранить в secrets, а создаваемые файлы — защищать от несанкционированного доступа.

Замена встроенных переменных GitLab

В GitLab CI/CD доступны встроенные переменные CI_*, содержащие информацию о pipeline, репозитории и коммите.

В GitVerse для получения аналогичных данных используется контекст gitverse.

GitLab CI/CDGitVerse CI/CD
CI_COMMIT_SHA${{ gitverse.sha }}
CI_COMMIT_REF_NAME${{ gitverse.ref_name }}
CI_PROJECT_PATH${{ gitverse.repository }}
CI_PIPELINE_SOURCE${{ gitverse.event_name }} — ближайший аналог типа события

Пример использования контекста GitVerse:

name: Show Context
 
on:
  push:
 
jobs:
  info:
    runs-on: ubuntu-latest
    steps:
      - name: Show repository information
        env:
          REPOSITORY: ${{ gitverse.repository }}
          COMMIT_SHA: ${{ gitverse.sha }}
          REF_NAME: ${{ gitverse.ref_name }}
          EVENT_NAME: ${{ gitverse.event_name }}
        run: |
          echo "Repository: $REPOSITORY"
          echo "Commit: $COMMIT_SHA"
          echo "Ref: $REF_NAME"
          echo "Event: $EVENT_NAME"

Note

Значения контекстов зависят от события. Например, при обработке pull request ссылка на ветку и SHA коммита могут отличаться от ожидаемых при обычном push. Не все переменные CI_* имеют прямой аналог.

Подробнее: «Контекст GitVerse».

Перенос артефактов

В GitLab CI/CD артефакты задаются через artifacts:

build:
  script:
    - mkdir -p dist
    - echo "Build completed" > dist/result.txt
  artifacts:
    paths:
      - dist/

В GitVerse для сохранения файлов используется действие actions/upload-artifact, а для их загрузки — actions/download-artifact.

Сохранение и передача артефактов

name: Artifacts Example
 
on:
  workflow_dispatch:
 
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Create build result
        run: |
          mkdir -p dist
          echo "Build completed" > dist/result.txt
 
      - name: Upload artifact
        uses: actions/upload-artifact@v4
        with:
          name: build-output
          path: dist/
 
  verify:
    needs: build
    runs-on: ubuntu-latest
    steps:
      - name: Download artifact
        uses: actions/download-artifact@v4
        with:
          name: build-output
 
      - name: Verify artifact
        run: |
          find . -name result.txt -type f

Как это работает:

  1. Job build создает результат сборки.
  2. upload-artifact сохраняет файлы под именем build-output.
  3. Job verify ожидает завершения build.
  4. download-artifact загружает сохраненные файлы.
  5. Последний шаг проверяет наличие результата.

Info

Артефакты используются для сохранения результатов выполнения и передачи файлов между заданиями. Они не заменяют кеширование зависимостей.

При миграции также необходимо отдельно настроить обработку отчетов тестирования, покрытия кода и других данных, которые в GitLab передавались через artifacts:reports.

Подробнее: «Работа с артефактами».

Перенос кеширования зависимостей

В GitLab CI/CD кеш можно настроить с помощью cache:

cache:
  key:
    files:
      - package-lock.json
  paths:
    - .npm/

В GitVerse для кеширования используется действие actions/cache.

Пример для Node.js-проекта:

name: Node.js CI
 
on:
  push:
    branches:
      - main
 
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
 
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
 
      - name: Restore npm cache
        uses: actions/cache@v3
        with:
          path: ~/.npm
          key: ${{ runner.os }}-npm-${{ hashFiles('**/package-lock.json') }}
          restore-keys: |
            ${{ runner.os }}-npm-
 
      - name: Install dependencies
        run: npm ci
 
      - name: Run tests
        run: npm test

В этом примере:

  • actions/cache@v3 восстанавливает кеш npm;
  • key формируется с учетом операционной системы и хеша package-lock.json;
  • npm ci устанавливает зависимости;
  • после выполнения задания кеш может использоваться в следующих запусках.

Если подходящий кеш не найден, зависимости устанавливаются обычным способом.

Info

Рекомендуется включать в ключ кеша хеш файла зависимостей. Это позволяет создавать новый кеш при изменении состава пакетов.

Подробнее: «Кеширование зависимостей».

Перенос ручных запусков и расписаний

Ручной запуск workflow

В GitLab CI/CD для ручного запуска задания используется when: manual.

deploy:
  script:
    - ./ci/deploy.sh
  when: manual

В GitVerse для ручного запуска workflow используется workflow_dispatch:

name: Manual Deploy
 
on:
  workflow_dispatch:
 
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: sh ./ci/deploy.sh

Workflow можно запустить вручную через интерфейс GitVerse.

Note

workflow_dispatch запускает workflow целиком. Это не полный аналог ручного запуска отдельной job внутри уже выполняющегося GitLab pipeline.

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

В GitVerse расписание задается в YAML-файле workflow:

name: Scheduled Checks
 
on:
  schedule:
    - cron: "0 9 * * *"
 
jobs:
  check:
    runs-on: ubuntu-latest
    steps:
      - run: echo "Scheduled check"

В примере workflow запускается ежедневно в 09:00 UTC.

Info

Минимальный интервал запуска по расписанию составляет 15 минут для облачных раннеров и 5 минут для локальных и организационных раннеров.

При переносе расписаний из GitLab проверьте часовой пояс и ветку, из которой должен выполняться workflow.

Перенос дополнительных возможностей

Некоторые функции GitLab CI/CD требуют отдельной адаптации.

allow_failure

В GitLab:

lint:
  script:
    - make lint
  allow_failure: true

В GitVerse для подходящих сценариев можно использовать continue-on-error:

jobs:
  lint:
    runs-on: ubuntu-latest
    continue-on-error: true
    steps:
      - uses: actions/checkout@v4
      - run: make lint

Параметр позволяет не останавливать весь workflow из-за ошибки в задании.

Сервисные контейнеры

В GitLab CI/CD для запуска дополнительных сервисов используется services.

Например, интеграционные тесты могут требовать PostgreSQL или Redis.

При переносе таких заданий необходимо отдельно проверить доступность сервисных контейнеров в выбранном окружении GitVerse.

Если требуется Docker daemon, доступ к внутренней сети или специальная конфигурация контейнеров, может понадобиться собственный раннер.

Повторно используемые конфигурации

В GitLab CI/CD для переиспользования конфигурации применяются include, extends и другие механизмы.

В GitVerse можно использовать повторно используемые workflow с триггером workflow_call, а также собственные actions.

Пример вызываемого workflow:

name: Reusable Workflow
 
on:
  workflow_call:
 
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - run: echo "Running reusable workflow"

Модель переиспользования отличается от GitLab CI/CD, поэтому подключаемые конфигурации нужно переносить отдельно.

Пример полной миграции Node.js-проекта

Рассмотрим перенос pipeline, который запускает тесты, собирает приложение и сохраняет результаты сборки.

Исходная конфигурация GitLab CI/CD

Файл .gitlab-ci.yml:

workflow:
  rules:
    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
    - if: '$CI_COMMIT_BRANCH == "main"'
    - when: never
 
image: node:20
 
stages:
  - test
  - build
 
cache:
  key:
    files:
      - package-lock.json
  paths:
    - .npm/
 
test:
  stage: test
  script:
    - npm ci --cache .npm --prefer-offline
    - npm test
 
build:
  stage: build
  script:
    - npm ci --cache .npm --prefer-offline
    - npm run build
  artifacts:
    paths:
      - dist/

Этот pipeline:

  1. Запускается при создании pipeline для merge request или изменениях в ветке main.
  2. Использует Node.js 20.
  3. Кеширует зависимости npm.
  4. Выполняет тестирование.
  5. После тестирования собирает приложение.
  6. Сохраняет каталог dist/ как артефакт.

Конфигурация GitVerse CI/CD

Создайте файл .gitverse/workflows/ci.yaml:

name: Node.js CI
 
on:
  push:
    branches:
      - main
  pull_request:
    branches:
      - main
    types:
      - opened
      - reopened
      - synchronize
 
jobs:
  test:
    runs-on: ubuntu-latest
 
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
 
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
 
      - name: Restore npm cache
        uses: actions/cache@v3
        with:
          path: ~/.npm
          key: ${{ runner.os }}-npm-${{ hashFiles('**/package-lock.json') }}
          restore-keys: |
            ${{ runner.os }}-npm-
 
      - name: Install dependencies
        run: npm ci
 
      - name: Run tests
        run: npm test
 
  build:
    needs: test
    runs-on: ubuntu-latest
 
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
 
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
 
      - name: Restore npm cache
        uses: actions/cache@v3
        with:
          path: ~/.npm
          key: ${{ runner.os }}-npm-${{ hashFiles('**/package-lock.json') }}
          restore-keys: |
            ${{ runner.os }}-npm-
 
      - name: Install dependencies
        run: npm ci
 
      - name: Build application
        run: npm run build
 
      - name: Upload build artifact
        uses: actions/upload-artifact@v4
        with:
          name: build-output
          path: dist/

Результат: при push в ветку main или поддерживаемом событии pull request GitVerse запускает тестирование, затем сборку и сохранение артефакта.

Пример рассчитан на Node.js-проект с файлами package.json, package-lock.json, командами npm test, npm run build и результатом сборки в каталоге dist/.

Note

Это пример переноса типового pipeline, а не универсальное преобразование .gitlab-ci.yml. Для проектов с деплоем, динамическими pipeline, дополнительными сервисами и сложными условиями запуска потребуются дополнительные настройки.

Проверка после миграции

После создания workflow:

  1. Перейдите в репозиторий GitVerse.
  2. Откройте вкладку CI/CD.
  3. Убедитесь, что новый workflow отображается в списке.
  4. Выполните push в ветку, указанную в триггере.
  5. Проверьте последовательность выполнения заданий и их логи.
  6. Убедитесь, что артефакты сохраняются и доступны для скачивания.
  7. Проверьте работу кеширования при повторном запуске.
  8. Проверьте запуск pull request, если он используется.
  9. Убедитесь, что секреты не выводятся в логи и доступны только необходимым заданиям.
  10. Проверьте, что публикация и деплой не запускаются из недоверенных веток.

Warning

Перед отключением GitLab CI/CD рекомендуется выполнить несколько успешных запусков в GitVerse, включая сценарии с ошибками сборки, изменениями в pull request и повторным использованием артефактов.

Автоматизация миграции с помощью ИИ

Перенос небольших CI/CD-конфигураций можно выполнить вручную. Однако в крупных проектах с десятками заданий, сложными зависимостями, шаблонами и собственными скриптами такой подход становится слишком трудоемким.

Традиционные инструменты автоматической миграции тоже не всегда справляются с этой задачей. Они преобразуют синтаксис, но зачастую не учитывают весь контекст проекта: связи между заданиями, особенности инфраструктуры, зависимости от внешних сервисов и нестандартную логику выполнения. В результате автоматически перенесенные конфигурации могут потребовать значительной ручной доработки.

Для миграции сложных проектов рекомендуем использовать ИИ-инструменты. Они позволяют анализировать конфигурацию в контексте всего репозитория, учитывать особенности проекта и адаптировать CI/CD-процессы под возможности GitVerse.

Чтобы упростить работу с ИИ, воспользуйтесь нашим готовым навыком GitLab to GitVerse из Маркетплейса GitVerse. Он поможет ИИ-агенту при переносе CI/CD-конфигураций из GitLab в GitVerse.

После миграции обязательно проверьте корректность workflow и выполните тестовые запуски.

Дополнительная информация