В чём разница между serve и deploy в Modal, и почему это вообще важно?

Если сказать совсем просто, modal serve нужен для проверки и отладки, а modal deploy — для уже готового рабочего приложения.

На словах это кажется мелочью. Но на практике именно здесь многие новички ломают себе запуск. Кажется, что шаблон уже почти собрался, значит можно сразу деплоить. А потом выясняется, что внутри ещё не хватает нод, моделей, зависимостей или часть логики вообще не переживает перезапуск.

Для Modal это особенно чувствительно, потому что вокруг ComfyUI почти всегда есть дополнительная сложность: кастомные ноды, модели, нестандартные зависимости, отдельные пути к файлам, разные версии компонентов. Если всё это не проверить заранее, deploy не чинит сборку, а просто закрепляет её текущее состояние.

Что такое modal serve

modal serve — это режим разработки для web endpoint-приложений в Modal. Он нужен для того, чтобы быстро проверить: код запускается, маршруты работают, зависимости подтянулись, а приложение вообще живое.

Для ComfyUI и AI workflow это особенно полезно, потому что на этом этапе удобно ловить типичные поломки:

• не хватает custom nodes;
• модель лежит не в той папке;
• workflow JSON ссылается на то, чего в среде нет;
• после рестарта часть компонентов пропадает;
• зависимости вроде установились, но ComfyUI не был нормально перезапущен.

На практике serve — это режим «проверить, не сломано ли всё уже на старте».

Что такое modal deploy

modal deploy — это уже постоянное развёртывание приложения. После deploy приложение сохраняется как рабочая конфигурация, которую можно использовать дальше как стабильный вариант.

То есть deploy нужен не для черновой проверки, а для состояния «всё собрано, всё запускается, это уже можно использовать как рабочий вариант».

Почему это важно именно в Modal

Проблема не в самих командах, а в порядке действий. Новичок часто делает наоборот: пытается задеплоить сырой, недопроверенный template, а потом получает красивую, но сломанную конструкцию.

Поэтому нормальная логика такая:

• сначала проверяете среду через serve;
• ловите missing nodes, missing models и странные зависимости;
• чините шаблон;
• только потом делаете стабильный deploy.

Иначе вы просто консервируете ошибку.

Как это выглядит на практике с ComfyUI

Представим типичную ситуацию. Человек взял чужой workflow, добавил пару моделей, поставил несколько нод и вроде бы увидел знакомый интерфейс. Кажется, что всё почти готово. Он сразу делает deploy. Потом открывает рабочую ссылку и получает ошибки уровня missing_node_type, битый граф, неоткрывающийся JSON или проблемы после перезапуска.

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

Поэтому если вы ещё только разбираетесь, полезно сначала понять, что такое workflow JSON в ComfyUI, почему чужой workflow может не запускаться и куда вообще ставить custom nodes.

Почему в Modal часто советуют сначала serve, а потом deploy

Serve используют, когда надо дебажить и проверять, всё ли установилось правильно; deploy — когда уже собран готовый template без ошибок.

Отдельный нюанс Modal в том, что при работе с ComfyUI люди часто сталкиваются с ситуацией, когда custom nodes, поставленные не как часть шаблона, а вручную через Manager, после рестарта могут слетать. Из-за этого особенно опасно деплоить недособранную среду: после следующего перезапуска проблемы всплывут уже в «рабочем» приложении.

Когда использовать serve

• Когда вы только собираете template.
• Когда проверяете установку моделей и нод.
• Когда тестируете новый workflow.
• Когда меняете зависимости.
• Когда ещё не уверены, что после рестарта всё поднимется так же.

Если у вас в голове есть фраза «вроде почти работает», это почти всегда стадия serve, а не deploy.

Когда уже пора deploy

• Когда шаблон запускается без сюрпризов.
• Когда все нужные узлы действительно подхватываются.
• Когда пути к моделям и зависимостям уже закреплены.
• Когда вы несколько раз прогнали реальный workflow, а не случайный тест.
• Когда вы хотите получить постоянную рабочую конфигурацию, а не временный dev-запуск.

Частые ошибки новичков

• ❌ Деплоить сырой шаблон. Кажется, что это ускоряет работу, но обычно только фиксирует поломку.
• ❌ Проверять не реальный workflow, а абстрактный тест. Потом боевой JSON открывается совсем иначе.
• ❌ Считать, что если интерфейс открылся, значит всё готово. Для ComfyUI это не гарантия.
• ❌ Игнорировать перезапуск. Во многих случаях нужен именно полный restart, а не просто refresh страницы.
• ❌ Устанавливать важные компоненты вручную на лету, а потом считать это стабильной конфигурацией.

Практическая схема действий

Для большинства AI image/video workflow на Modal безопаснее идти так:

• 1. Соберите template под конкретную задачу, а не на всё сразу.
• 2. Запустите его через serve.
• 3. Прогоните свой реальный workflow и проверьте ноды, модели и зависимости.
• 4. Убедитесь, что после рестарта ничего не отваливается.
• 5. Только после этого делайте deploy как стабильную версию.

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

Вывод

Разница между serve и deploy в Modal — это разница между проверкой и закреплением. Serve нужен, когда вы ещё ловите ошибки и проверяете, всё ли поднялось корректно. Deploy нужен, когда шаблон уже пережил эти проверки и стал рабочим.

Для ComfyUI, custom nodes, JSON workflow и облачных GPU это особенно важно, потому что тут слишком легко утащить в прод недособранную среду. Поэтому безопасная логика почти всегда одна: сначала проверить, потом закрепить.

Если хотите сверить детали по Modal, можно посмотреть официальную документацию: Managing Deployments.