# Rivet Docs

Собрана из репозитория: правки приходят туда же, куда код.

Полный текст базы одним файлом. Отдельные документы и их исходники — https://docs.rivet.gitaspen.ru/llms.txt

---

Документ: https://docs.rivet.gitaspen.ru/01-start/pipelines

---
title: Первый пайплайн в Rivet
summary: Подключите репозиторий, сохраните YAML и запустите пайплайн для выбранной ветки.
---

# Первый пайплайн в Rivet

1. Подключите репозиторий в Rivet. Для чтения приватного кода добавьте Git-токен с доступом на чтение. Для передачи результатов проверок подключается отдельный Git-токен с соответствующим разрешением.
2. Откройте «Пайплайны», выберите репозиторий и ветку. Вставьте YAML в редактор, проверьте его и сохраните версию.
3. Активируйте сохранённую версию на нужной ветке. Запустите её вручную на выбранном коммите и проверьте результаты всех заданий.
4. Включите автозапуск для проверенной конфигурации. Триггер описывает событие и ветку, на которых запускается пайплайн.

В YAML используйте ключ сервера из его карточки. Например, `server.build` обозначает сервер с ключом `build`. Укажите ключ сервера, который доступен вашему репозиторию.

```yaml
version: 3
name: Проверка исходников
triggers:
  - {id: manual, kind: manual, expression: ''}
jobs:
  check:
    server: server.build
    environment: {mode: host}
    script:
      - git rev-parse HEAD
```

У пайплайна есть собственная история версий в Rivet. При запуске Rivet закрепляет версию YAML и коммит кода. В истории запуска можно открыть журнал задания и проверить результат.

---

Документ: https://docs.rivet.gitaspen.ru/02-applications/rollouts

---
title: Выкладка и управление приложением
summary: Свяжите собранный образ с приложением и выберите контур и место размещения.
---

# Выкладка и управление приложением

У приложения есть один или несколько компонентов. Оно принадлежит продукту или рабочему пространству. Для приложения можно вести несколько контуров, например dev и prod.

Пайплайн собирает и публикует результат. Контур хранит своё место размещения, конфигурацию запуска и установленную версию. При выкладке выбирайте точный образ по digest из результата сборки.

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