Быстрый старт: создаем workflow

Info

Создадим ваш первый workflow, рассмотрим его основные составляющие, а также научимся запускать workflow на разных типах раннеров.

Что такое workflow?

Workflow — это YAML-файл с инструкциями, которые GitVerse выполняет при определенных событиях, например при push в репозиторий. Workflow описывается в формате YAML и хранится в каталоге .gitverse/workflows/ вашего репозитория.

Каждый файл внутри этой папки представляет отдельный workflow. GitVerse автоматически сканирует этот каталог и запускает workflow при срабатывании триггера, заданного в секции on файла.

Простейший пример workflow

Создайте файл .gitverse/workflows/hello.yaml в своем репозитории:

# Название workflow
name: Hello GitVerse
 
# workflow запускается при каждом git push в репозиторий
on: [push]
 
# определяет задачу с шагами, которые нужно выполнить
jobs:
  hello:
 
    # указывает среду выполнения (в данном случае — облачный раннер GitVerse)
    runs-on: ubuntu-latest
    # последовательность шагов: можно выполнять команды, запускать скрипты и использовать action (действия)
    steps:
      - name: Клонируем репозиторий
        uses: actions/checkout@v4
 
      - name: Приветствуем GitVerse
        run: echo "Привет, GitVerse"

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

Рассмотрим каждый блок этого workflow:

  • name — название workflow, отображается в интерфейсе CI/CD;
  • on: [push] — trigger (триггер), указывающий что workflow запускается при каждом push в репозиторий;
  • jobs.hello — job (задача) с именем hello. Каждая job выполняется на отдельном runner;
  • runs-on: ubuntu-latest — runner, на котором выполняется job. В данном случае это облачный раннер с Ubuntu;
  • steps — список step (шагов), выполняющихся последовательно внутри job;
  • uses: actions/checkout@v4 — готовый action (действие) для клонирования репозитория;
  • run: echo "..." — shell-команда, выполняющаяся на runner.

Проверим запуск

  1. Сделайте коммит и отправьте изменения в репозиторий:
git add .gitverse/workflows/hello.yaml
git commit -m "Добавлен первый CI/CD workflow"
git push

Этот push активирует триггер, и GitVerse автоматически запустит workflow на облачном раннере.

  1. Перейдите в раздел CI/CD на странице репозитория — там отображаются все запущенные workflow со статусами выполнения.

  2. Увидите запущенный workflow со статусом выполнения job и step. Нажмите на workflow, чтобы посмотреть логи выполнения каждого шага.

Что дальше?

После создания первого workflow продолжите изучение CI/CD на GitVerse:

  • обратите внимание на наш репозиторий с примерами workflow — от базовых кейсов до деплоя разработок в облачные сервисы;

  • продолжайте изучать раздел «Практические руководства», чтобы ознакомиться с реальными примерами CI/CD в GitVerse: сборка, тестирование, работа с артефактами, кэширование, деплой.

Вид графа

Связанные страницы