Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/dist/docs/ru-guide/ci-cd/github-actions.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ jobs:
- name: Verify EasyP version
run: |
which easyp
easyp version
easyp --version

- name: Lint
run: easyp lint
Expand Down Expand Up @@ -367,7 +367,7 @@ easyp generate -v
- name: Debug environment
run: |
env | sort
easyp version
easyp --version
```

## Переменные окружения (примерно)
Expand Down
2 changes: 1 addition & 1 deletion docs/dist/docs/ru-guide/ci-cd/gitlab.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ validate:
before_script:
- go install github.com/easyp-tech/easyp/cmd/easyp@latest
- echo "EasyP version:"
- easyp version
- easyp --version
# При необходимости: git fetch --all --tags
script:
- easyp lint
Expand Down
13 changes: 11 additions & 2 deletions docs/public/docs/ru-guide/ci-cd/github-actions.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@
## Зачем использовать EasyP в CI

Встраивание EasyP в GitHub Actions даёт:

- Единообразие правил линтинга и генерации между разработчиками.
- Автоматическое выявление несовместимых изменений (breaking changes) до мержа.
- Гарантию, что сгенерированный код не «устарел» относительно .proto.
Expand Down Expand Up @@ -49,7 +50,7 @@ jobs:
- name: Verify EasyP version
run: |
which easyp
easyp version
easyp --version

- name: Lint
run: easyp lint
Expand All @@ -61,6 +62,7 @@ jobs:
## Установка EasyP

Варианты:

1. Через `go install` (как в примере выше).
2. Использование заранее собранного бинаря (артефакт релиза).

Expand All @@ -74,6 +76,7 @@ jobs:
## Кэширование

Для ускорения повторных сборок можно кэшировать:

- Go модульный кеш (если используете генерацию с плагинами Go).
- Внешние зависимые Git-клонирования (папки `vendor` или содержимое `deps` при использовании `easyp mod download` / `easyp mod update`).
- Сгенерированный код (если он тяжёлый, но чаще генерируется заново).
Expand Down Expand Up @@ -115,6 +118,7 @@ easyp lint
```

Рекомендуется:

- В PR: всегда запускать.
- На main: можно запускать для верификации перед релизом.

Expand All @@ -132,6 +136,7 @@ easyp lint
EasyP может сравнивать текущее состояние против ветки / коммита / тега.

Примеры:

```bash
# Сравнить против origin/main
easyp breaking --against git-ref=origin/main
Expand Down Expand Up @@ -163,11 +168,13 @@ Workflow шаг:
## Генерация кода

Обычно для генерации:

```bash
easyp generate
```

Если нужно явно указать конфиг:

```bash
easyp --cfg easyp.yaml generate
```
Expand Down Expand Up @@ -356,18 +363,20 @@ jobs:
## Отладка

Если нужно больше логов:

```bash
easyp lint -v
easyp breaking -v --against git-ref=origin/main
easyp generate -v
```

Добавьте вывод окружения для диагностики:

```yaml
- name: Debug environment
run: |
env | sort
easyp version
easyp --version
```

## Переменные окружения (примерно)
Expand Down
3 changes: 2 additions & 1 deletion docs/public/docs/ru-guide/ci-cd/gitlab.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@

Документация по интеграции EasyP с GitLab CI находится в процессе подготовки.
Планируемые разделы:

- Быстрый старт (пример `.gitlab-ci.yml` для линтинга и проверки несовместимых изменений)
- Кэширование зависимостей и ускорение сборок
- Генерация кода и проверка актуальности артефактов
Expand All @@ -27,7 +28,7 @@ validate:
before_script:
- go install github.com/easyp-tech/easyp/cmd/easyp@latest
- echo "EasyP version:"
- easyp version
- easyp --version
# При необходимости: git fetch --all --tags
script:
- easyp lint
Expand Down
Loading