2 мин на чтение

Vercel Sandbox научился принимать stdin: зачем явно закрывать вход процесса

В Vercel Sandbox добавили ввод в уже работающую команду. Как связаны stdin, чтение результата и завершение процесса при работе с CLI и stdio-серверами.

Vercel Sandbox теперь позволяет передавать данные в стандартный ввод уже работающей команды. Обновление от 26 октября расширяет сценарии с обычными CLI и серверами, которые обмениваются сообщениями через stdio. Для разработчика важна не только возможность записать строку: нужно правильно определить окончание ввода, прочитать результат и дождаться завершения процесса.

Официальная карточка анонса поддержки стандартного ввода в командах Vercel Sandbox.

Запущенная команда может ждать продолжения

Многие консольные программы читают входной поток до его окончания. Если отправить данные и оставить stdin открытым, процесс может продолжить ждать, даже когда приложение уже считает работу выполненной. Это не обязательно зависание: программа просто не получила сигнал, что новых данных больше не будет.

В TypeScript SDK для такого режима у runCommand() включаются stdin и detached. Далее writeStdin() передаёт данные, closeStdin() завершает вход, а ожидание команды позволяет получить её результат. Этот порядок стоит понимать как протокол обмена, а не набор независимых вспомогательных вызовов.

В Python SDK можно открыть канал через subprocess.PIPE. Метод communicate() завершает передачу ввода, собирает оставшийся вывод и ожидает окончания процесса. Для задачи, где все входные данные известны заранее, предусмотрен и более простой вариант передачи input при запуске.

Разделять данные и служебные сообщения

У процесса есть stdout и stderr. Если stdout используется как машинный протокол, случайная диагностическая строка может нарушить обмен. Поэтому полезно заранее определить, какой поток содержит результат, куда уходят сообщения об ошибках и что означает успешный код завершения. Наличие текста в stdout ещё не доказывает успешность всей операции.

Особенно важно это для долгоживущих stdio-сервисов. Там конец одной порции данных не равен окончанию процесса. Сообщениям нужны границы, предусмотренные используемым протоколом, а приложению — понимание, какое сообщение относится к какому запросу. Закрывать stdin после каждой строки в таком сценарии было бы неправильным обобщением простого примера.

Ограничить ожидание и объём результата

Перед запуском полезно определить тайм-аут, допустимый объём вывода и реакцию на преждевременное завершение. Потоки нельзя бесконечно накапливать в памяти только потому, что процесс изолирован. Если команда генерирует большой результат, нужен способ читать его постепенно или сохранять в подходящее хранилище.

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

Поддержка stdin делает песочницу удобнее для существующих инструментов, которым не нужен HTTP-сервер. Но надёжность обмена возникает из ясного жизненного цикла: запустить, передать данные по правилам, завершить нужный поток, прочитать результат и корректно обработать окончание работы.

АвторAnthony Fubon

Anthony Fubon — российский музыкант, DJ, музыкальный продюсер, организатор мероприятий и специалист по цифровым продуктам. В музыке он использовал несколько имён, в частности Fubon, TheFubon и yagelProject. Его собственная биография описывает путь от рок-музыки и российской psytrance-сцены к электронной музыке разных направлений и созданию собственной цифровой экосистемы.