---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://ytsaurus.tech/docs/en/flow/devops.md
  - https://ytsaurus.tech/docs/ru/flow/devops.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ytsaurus.tech/docs/ru/llms.txt

# Эксплуатация YTsaurus Flow

В этом разделе описано, как запустить пайплайн, проверить его состояние и разобраться с остановкой обработки. Команды предполагают, что у вас есть доступ к кластеру и права на узел пайплайна; вместо `//path/to/pipeline`, `<cluster>` и `<operation-id>` подставьте свои значения. Flow можно запускать в Linux-окружениях, если выполнены требования к среде выполнения и конфигурации, а из окружения есть сетевой доступ к используемым пайплайном кластерам YTsaurus и другим сервисам. Vanilla-операции приведены в документации как самый простой пример окружения, нативного для кластера YTsaurus.

## Развёртывание {#deployment}

Для первого запуска выполните [первичный деплой в Vanilla-операции](https://ytsaurus.tech/docs/ru/flow/devops/vanilla/initial-deploy.md). Контроллер и воркеры будут запущены как задачи одной операции. Для запуска из выпущенных образов Flow прочитайте [про запуск в docker-окружении](https://ytsaurus.tech/docs/ru/flow/devops/docker-environment.md): там описаны vanilla-джобы в docker-образах, контроллер и воркеры в Kubernetes, разрешение имени кластера и доступ к прокси извне. Flow по умолчанию создаёт и монтирует внутренние таблицы вместе с пайплайном. Если пайплайн использует внешний стейт, который вы обслуживаете самостоятельно, перед созданием таких таблиц выберите [тип таблиц внешнего стейта](https://ytsaurus.tech/docs/ru/flow/devops/state-tables-choice.md) с учётом доступности и стоимости.

## Запуск Flow {#launch-flow}

Создайте конфигурацию и запустите пайплайн по [инструкции для Vanilla](https://ytsaurus.tech/docs/ru/flow/devops/vanilla/initial-deploy.md#run). Перед запуском проверьте объекты и права, которые нужны новой версии.

## Инструкции по развёртыванию {#deployment-pages}

Для изменения действующего пайплайна используйте [операции](https://ytsaurus.tech/docs/ru/flow/devops/vanilla/pipeline-operations.md), [релизы](https://ytsaurus.tech/docs/ru/flow/devops/vanilla/releases.md), [настройку доступа](https://ytsaurus.tech/docs/ru/flow/devops/vanilla/security.md) и [логи](https://ytsaurus.tech/docs/ru/flow/devops/vanilla/diagnostics/logs.md).

## Управление {#lifecycle}

Используйте [`yt flow`](https://ytsaurus.tech/docs/ru/flow/tools/cli.md) для запуска, остановки, паузы и просмотра состояния пайплайна. Остановка через `stop-pipeline` дренирует промежуточные буферы; `pause-pipeline` приостанавливает обработку без дрейна. [Удаление пайплайна](https://ytsaurus.tech/docs/ru/flow/devops/vanilla/pipeline-operations.md#remove) отдельно отменяет Vanilla-операцию и удаляет узел с внутренними таблицами Flow. Пользовательские таблицы External State за пределами узла остаются.

Для обновления, хотфикса или отката версии следуйте [правилам релизов](https://ytsaurus.tech/docs/ru/flow/devops/vanilla/releases.md). Передавайте токен и другие секреты по [правилам доступа](https://ytsaurus.tech/docs/ru/flow/devops/vanilla/security.md); не помещайте их в спеку или образ.

## Когда прогресс остановился {#investigate}

Сначала запросите состояние и представление пайплайна, затем сопоставьте их с [логами контроллера и воркеров](https://ytsaurus.tech/docs/ru/flow/devops/vanilla/diagnostics/logs.md). [Диагностика](https://ytsaurus.tech/docs/ru/flow/devops/diagnostics.md) помогает найти проблемную джобу, [профилирование](https://ytsaurus.tech/docs/ru/flow/devops/profiling.md) — источник нагрузки или зависания, а [типовые проблемы](https://ytsaurus.tech/docs/ru/flow/devops/troubleshooting.md) связывают наблюдение с безопасным следующим действием.
