Публикация приложений

Promto публикует полноценные приложения на облачной VM, а базы данных и S3 создаёт как отдельные ресурсы, когда они действительно нужны проекту. Агент получает параметры созданной VM, подключается к ней по SSH, устанавливает необходимое окружение, запускает приложение и проверяет публичный адрес.

Одиночные дизайн-файлы *_design.html публикуются другим способом — как статические Promto Sites из приложения «Промто Дизайн».

Инструкции и CLI для агента

• Обязательная focused-инструкция: publish — Promto Publish Capability. В основном агенте она загружается через trusted tool get_instruction; в профессиональном терминале актуальный runbook можно получить командой promto publish get-instruction.
• Основной CLI публикации: promto-publish. Он показывает presets, проверяет право на add-on, создаёт VM, базу или S3, возвращает состояние ресурса и при необходимости восстанавливает SSH-доступ.
• Trusted tool проверки публичного адреса: promto_screenshot. Это не shell-команда и не заменяется promto-preview, который предназначен только для локального Preview.
• На VM по SSH агент может использовать systemctl, journalctl, Docker, Nginx, Caddy или Certbot, если выбранная архитектура этого требует.

Готовый промпт для агента

Через get_instruction загрузи publish — Promto Publish Capability. Изучи проект, выбери только необходимые ресурсы через promto-publish presets, перед каждым платным ресурсом выполни promto-publish addon-check --marker-only, создай подтверждённые ресурсы через promto-publish deploy, разверни приложение на VM по SSH и проверь публичный адрес через promto_screenshot. Не выводи секреты и не называй публикацию готовой до проверки реального содержимого.

Как опубликовать

1. Проверьте приложение в Preview и завершите обязательные тесты.
2. Откройте Publish или приложение «Хостинг» и попросите агента изучить проект.
3. Агент определит, достаточно ли одной VM или дополнительно нужны PostgreSQL, Redis, S3 либо другой ресурс.
4. Агент запросит доступные конфигурации через promto-publish presets.
5. Перед созданием каждого платного ресурса он выполнит promto-publish addon-check --marker-only. Если подходящего расширения нет, в чате появится действие для выбора тарифа.
6. После подтверждения агент создаст ресурсы через promto-publish deploy, прочитает их параметры через promto-publish detail и настроит приложение без вывода секретов.
7. Агент подключится к VM по SSH, перенесёт проект, установит зависимости, выполнит миграции и запустит процессы.
8. При необходимости он настроит reverse proxy, домен и HTTPS.
9. Публикация считается готовой только после проверки служб, логов и реального содержимого по публичному адресу.

Какие ресурсы может создать агент

Ресурс	Когда нужен
VM	Для frontend, backend, API, бота, worker или нескольких сервисов
База данных	Для структурированных данных, кэша, очередей, аналитики или поиска
S3	Для изображений, видео, документов, экспортов и резервных копий

Если приложению не нужны база данных, Redis, S3, очередь или поиск, агент создаёт только VM.

Переменные окружения

Чувствительные данные не вставляются в исходный код, документацию или ответ агента. Для созданных Promto-ресурсов агент получает параметры через promto-publish detail и помещает их в конфигурацию приложения, не показывая значения в чате. Внешние секреты задавайте через предусмотренные переменные окружения.

Домены и HTTPS

Для приложения на VM агент настраивает Nginx или Caddy внутри сервера. Он сообщит точные DNS-записи, которые нужно создать у регистратора, а после распространения DNS выпустит сертификат через Caddy или Certbot.

Для *_design.html VM не используется: агент публикует файл через promto-publish site publish и подключает домен через promto-publish site domain.

Обновление деплоя

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

Если после пересоздания рабочего пространства потерян приватный SSH-ключ, агент сначала использует promto-publish cloud repair-ssh, а не просит у вас серверный пароль.