Запускайте любой OCI-образ как долгоживущий сервис: соберите его из Dockerfile или возьмите из реестра, пройдите проверку работоспособности, проверьте предварительную версию, а затем переведите в продакшен с мгновенным откатом. HTTP-сервисы получают имя хоста, а базы данных и другие TCP-сервисы — адрес, к которому можно подключиться.
Функция — это код, который платформа выполняет внутри собственного образа среды выполнения, по одному вызову за раз. Приложение — произвольный контейнер, который платформа держит запущенным: без тайм-аута простоя, с прозрачным обратным прокси (WebSocket и SSE проходят насквозь) и с поддержкой HTTP и чистого TCP — Postgres, Redis, SMTP, SSH. Приложениями управляют в разделе Проекты консоли, командой inquir apps в CLI или через REST API; термины везде одни и те же.
Приложения, релизы, предварительные версии#
- Приложение — описание сервиса: имя, порты, проверка работоспособности, ресурсы, переменные окружения, политика исходящего трафика. Его изменение влияет на следующий релиз и никогда — на уже запущенный.
- Релиз — неизменяемый digest образа плюс замороженная копия спецификации запуска и переменных окружения, работающие как один контейнер. Жизненный цикл:
В очереди → Запуск → Проверка работоспособности → Работоспособен → Обслуживает → Резерв отката → ОстановленилиОшибка. Релиз, не прошедший проверку работоспособности, никогда не получает трафик. - Предварительная версия — каждый новый релиз запускается по собственному адресу предварительной версии (
{app}-{release}.preview.apps.…), чтобы его можно было проверить до того, как его увидят другие. Релизы, не переведённые в продакшен, удаляются через 24 часа. - Перевод в продакшен — направляет трафик продакшена (имя хоста продакшена и все свои домены) на релиз. Выполняется вручную и доступен только владельцам и администраторам.
- Откат — снова направляет продакшен на предыдущий релиз. Предыдущий контейнер продолжает работать в течение окна завершения, поэтому, пока действует этот резерв, откат мгновенный.
Разверните первый сервис#
С установленным CLI, в который выполнен вход, HTTP-сервис — это три команды. inquir apps deploy без флагов упаковывает текущий каталог (или --dir), собирает его из Dockerfile на платформе и выпускает релиз из полученного образа; передайте --image, чтобы вместо сборки выпустить готовый образ. Команда ждёт, пока релиз пройдёт проверку работоспособности, и печатает его адрес.
# 1. Create the application — an HTTP service listening on port 3000 inquir apps create web --port 3000 # 2. Deploy: builds the Dockerfile in the current directory, releases the image # and waits until the health check passes. The release gets a preview URL. inquir apps deploy web # …or release a prebuilt image instead of building inquir apps deploy web --image nginx:alpine # 3. Promote: production traffic moves to this release (owner/admin login) inquir apps promote <releaseId> inquir apps status web # endpoints, hostnames, recent releases inquir apps logs web --tail 100 # stream container logs inquir apps rollback web # back to the previous production release
Нужны Dockerfile и inquir.yaml, с которых начать? В готовых рецептах есть проверенные для сайта на React (Vite), статического HTML-сайта, API на Node.js и API на Python.
В консоли путь тот же: откройте проект в разделе Проекты и добавьте сервис на холст, затем в панели сервиса выберите Деплой → Новый релиз (готовый образ) или Собрать из исходников, а потом нажмите В продакшен на вкладке Деплои. В CLI id и имена взаимозаменяемы, а --json принимается везде.
Как задеплоить бота#
Готовые боты с пошаговыми инструкциями лежат в публичном репозитории inquir-examples: Telegram-бот на Python или Node.js, бот для MAX и ИИ-ассистент в Telegram, который отвечает через любой OpenAI-совместимый API. В каждой папке — код, Dockerfile, inquir.yaml и README.md. Ниже — шаги для Telegram-бота на Python; остальные отличаются только папкой, секретами и регионом, как написано в их README.
Что понадобится#
- Аккаунт Inquir с подтверждённым email: первые 14 дней бесплатно, без карты.
- Node.js 22 или новее, git и CLI:
npm i -g @inquir/compute-cli, затемinquir login(откроет браузер). - Токен бота: в Telegram откройте @BotFather, отправьте
/newbotи скопируйте токен из ответа. Это секрет: не коммитьте его.
Код, приложение и секреты#
Склонируйте примеры (или нажмите Use this template / Fork на GitHub и склонируйте свою копию), создайте приложение с токеном в зашифрованной переменной и задайте регион. Telegram-боты размещаются в Нидерландах; для бота MAX — --location ru. create создаёт проект для приложения и печатает его имя.
# The CLI (Node.js 22+), then sign in through the browser npm i -g @inquir/compute-cli inquir login # The example's code git clone https://github.com/Inquir-search/inquir-examples.git cd inquir-examples/telegram-bot-python # The app, its secret (an encrypted variable) and its location inquir apps create my-bot --set TELEGRAM_BOT_TOKEN=<token> inquir apps update my-bot --location nl
Развёртывание и проверка#
Из папки примера inquir apps deploy упакует её, соберёт образ и выпустит релиз. «no reachable endpoint» — это нормально: боту не нужен публичный адрес. Когда в логах появится is running, отправьте боту /start; выйти из логов — Ctrl+C.
# Build the Dockerfile in this folder and release it (about a minute) inquir apps deploy my-bot # Release … is serving # no reachable endpoint — the ports are internal to the host # Logs: "@your_bot is running (polling mode)" once Telegram accepted the token inquir apps logs my-bot
Обновление#
# New code: deploy the folder again inquir apps deploy my-bot # New variable value: set it, then release again inquir apps update my-bot --set TELEGRAM_BOT_TOKEN=<token> inquir apps redeploy my-bot
PostgreSQL (необязательно)#
С базой заработают /note и /notes (ИИ-ассистент хранит там историю чатов). connect записывает боту DATABASE_URL; после redeploy в строке is running появится PostgreSQL.
# A database in the bot's project (the name inquir apps create printed) inquir apps create my-bot-db --template postgres --project <the bot's project> # Sets DATABASE_URL on the bot; "no verified private address yet": retry in a minute inquir apps connect my-bot-db my-bot inquir apps redeploy my-bot
Вебхук вместо long polling (необязательно)#
Для long polling домен не нужен. Для вебхука дайте приложению публичный адрес и сообщите его боту; бот сам зарегистрирует вебхук и проверяет секрет каждого вызова.
# A public HTTPS address for the bot inquir apps update my-bot --ingress public inquir apps status my-bot # production: https://my-bot-xxxxxx.apps.inquir.org inquir apps update my-bot --set BOT_MODE=webhook --set WEBHOOK_URL=https://my-bot-xxxxxx.apps.inquir.org inquir apps redeploy my-bot # Back to long polling inquir apps update my-bot --set BOT_MODE=polling inquir apps redeploy my-bot
Если что-то не так#
Telegram refused TELEGRAM_BOT_TOKEN (401 Unauthorized)в логах — неверный токен. Задайте его заново черезinquir apps updateи выполнитеinquir apps redeploy.cannot reach api.telegram.orgповторяется —inquir apps statusдолжен показыватьlocation: Netherlands; если нет, задайте--location nlи разверните заново.- Бот молчит, хотя в логах есть
is running— тот же токен работает где-то ещё (например, локально), в логах будетConflict. Остановите второй экземпляр. - Приложение не запускается —
inquir apps describeобъяснит состояние реплик и последние события.
Проверки работоспособности#
Новый релиз проходит стартовую проверку работоспособности (по умолчанию до 120 с; контейнер проверяется каждые 2 с, поэтому падение обнаруживается сразу); сервисы с HTTP-портом затем проверяются периодически (intervalSeconds, по умолчанию 30 с). Есть три типа проверок; по умолчанию используется http, если у приложения есть HTTP-порт, и tcp в остальных случаях.
| Проба | Что доказывает |
|---|---|
http | GET по пути проверки работоспособности (по умолчанию /) отвечает статусом ниже 500 — сервер, отдающий 404 на корень, всё же слушает; проверку не проходят только ошибки соединения и 5xx. |
tcp | Порт принимает соединение и ненадолго удерживает его открытым. |
command | Команда, запущенная внутри контейнера, завершается с кодом 0. |
Адрес предварительной версии и адрес продакшена#
У приложения с HTTP-портом есть одно имя хоста продакшена ({app}.apps.… плюс свои домены), которое всегда указывает на релиз в продакшене, а у каждого релиза — свой адрес предварительной версии, пока релиз не переведут в продакшен или не остановят. TLS для обоих завершается на границе платформы. У чисто TCP-сервиса адреса URL нет вовсе — к нему подключаются по приватной сети по адресу {app}.apps.internal и порту контейнера; адрес показывает inquir apps status.
Перевод в продакшен, откат, остановка#
- Новый релиз
Запустить новую версию и дождаться готовности
- Preview
Открыть preview URL и проверить приложение
- Публикация
Переключить production-маршрут на проверенный релиз
- Откат при необходимости
Вернуть трафик на доступный предыдущий релиз
Откат меняет релиз приложения. Он не отменяет миграции БД и не восстанавливает данные томов.
Перевод в продакшен — осознанный шаг с подтверждением: UI и CLI заранее сообщают, что произойдёт:
- Если у приложения есть переменные только для продакшена, контейнер пересоздаётся с профилем продакшена (с проверкой работоспособности) до переключения трафика, поэтому предварительная версия никогда не получает учётные данные продакшена.
- Адрес предварительной версии отключается, как только релиз начинает обслуживать продакшен; имя хоста продакшена и все подтверждённые свои домены начинают вести на него.
- Предыдущий релиз продакшена продолжает работать в течение окна завершения (по умолчанию 5 мин,
drainGraceSecondsна релиз) как резерв для мгновенного отката. Текущие запросы и соединения WebSocket на нём завершаются на своих сокетах.
Откат (inquir apps rollback <app>, POST /v1/apps/:id/rollback) возвращает продакшен на предыдущий релиз: мгновенно (200), пока его контейнер ещё в резерве, иначе релиз сначала перезапускается из собственного замороженного образа (202). Откат сам по себе — перевод в продакшен, поэтому к релизу, с которого вы ушли, применяется то же окно завершения.
Остановка (inquir apps stop <release>, DELETE /v1/releases/:id) останавливает любой релиз, который не обслуживает продакшен, — и предварительные версии, и вытесненные релизы; для релиза, на который идёт трафик, ответ — 409. Остановка освобождает место в квоте работающих релизов, а постоянный TCP-адрес приложения остаётся зарезервированным между перезапусками. Архивация (inquir apps delete) останавливает все релизы и отвязывает все имена хостов; после неё имя приложения снова свободно. Через 24 часа сервис и его постоянные тома удаляются безвозвратно; в архиве можно запустить удаление сразу.
TCP-порты#
Порты помимо основного HTTP-порта объявляются флагом --tcp name:port (или в runtime.ports[] с protocol: tcp) — без runtime-адаптера и без предположения об HTTP, поэтому база данных становится полноценным сервисом. Сейчас TCP-порт работает у приложения с постоянным томом и стратегией recreate — именно такие приложения создают шаблоны баз данных; деплой сервиса без тома с TCP-портом отклоняется с объяснением причины:
# A database: no HTTP port, a persistent volume and a TCP port on the private network. # Public TCP ports are not available at the moment (a :public port is refused). inquir apps create db --template postgres # inquir apps status db -> private: db-abc123.apps.internal:5432 (postgres) # Other applications of the workspace connect there; connect writes the URL for them: inquir apps connect db api # DATABASE_URL=postgres://…@db-abc123.apps.internal:5432/…
- Публичные TCP-порты сейчас недоступны. Порт с пометкой
public(--tcp name:port:publicилиpublic: true) отклоняется с кодомPUBLIC_TCP_UNAVAILABLE. TCP-порт доступен в приватной сети — как{app}.apps.internal:5432для Postgres, из других приложений того же рабочего пространства (см. «Приватная сеть» ниже). Платформа не терминирует TLS и не проверяет учётные данные на чистом TCP, поэтому сервис должен сам аутентифицировать клиентов. - HTTP-порты никогда не публикуются отдельно — они обслуживаются через имя хоста (TLS, маршрутизация по Host, жизненный цикл релиза), поэтому
publicиhostPortдля HTTP-порта отклоняются. У приложения может вообще не быть HTTP-порта.
Приватная сеть#
У каждого приложения в рабочем пространстве есть приватный адрес {app}.apps.internal, который могут разрешить и достичь только другие приложения того же пространства — не интернет и не другое пространство. HTTP отдаётся по http://{app}.apps.internal; каждый TCP-порт сохраняет свой контейнерный порт, поэтому база данных — это {db}.apps.internal:5432. Именно этот адрес нужно писать в DATABASE_URL (или доверить это inquir apps connect):
# A database and the service that uses it — both private by default inquir apps create db --template postgres inquir apps create api --port 3000 inquir apps connect db api # DATABASE_URL=postgres://…@db-abc123.apps.internal:5432/… lands in api's env inquir apps deploy api # inquir apps status db # private: db-abc123.apps.internal:5432 (postgres) # inquir apps status api # private: http://api-x1y2z3.apps.internal # (no public domain until you ask for one) inquir apps update api --ingress public # creates https://api-x1y2z3.apps.inquir.org inquir apps update api --ingress private # removes it again; the private address stays
- Приватный адрес есть всегда и не меняется: он строится из постоянного slug, сохраняется при повторных развёртываниях, перезапусках и откатах и не требует ни флага
public, ни платформенного домена. Он есть и у предварительных версий, поэтому сервис может обратиться к своей базе ещё до перевода в продакшен. - Публичный доступ включается явно. У нового приложения нет публичного домена; кнопка Создать адрес в разделе Настройки → Сеть (или
--ingress public) создаёт{app}.apps.…, а удаление этого адреса в настройках убирает его, не затрагивая приватный адрес. Публичные TCP-порты сейчас недоступны. - Показывается только после проверки. Панель и
inquir apps statusпечатают приватный адрес, когда платформа проверила маршрут этого приложения от начала до конца (через несколько секунд после каждого деплоя). До этого он отображается как «подготавливается» — по имени он никогда не угадывается.
Тома и базы данных#
- Приложение записывает
Записывать постоянные данные в путь монтирования тома
- Постоянный том
Данные находятся вне записываемого слоя контейнера
- Новый контейнер
Читает данные при подключении того же тома
Файлы вне пути монтирования не являются постоянными. Том не заменяет бэкап; копия БД требует согласованного снимка или дампа.
Том — именованное хранилище, подключённое к приложению: объявите его флагом --volume name:/absolute/path[:ro][:size=MB] (или в runtime.volumes[]), и платформа создаст один управляемый Docker-том на приложение и смонтирует его туда. Физическое имя выводится из приложения, а не из релиза, поэтому тот же том data возвращается при каждом повторном деплое, перезапуске после сбоя и откате. Архивация останавливает контейнеры и назначает безвозвратное удаление сервиса и томов через 24 часа. Из архива можно запустить удаление сразу.
- Принимаются только логическое имя и абсолютный путь внутри контейнера — никогда host-путь, имя Docker-тома или driver options, — поэтому одно рабочее пространство не может смонтировать хранилище другого. В runtime допускается не более 16 томов;
/,/dev,/procи/sysотклоняются. - Записываемый том требует одной реплики (
scaling.maxReplicasбольше 1 отклоняется). Приложение только с HTTP-портами может использовать сонhttpс томами: следующий запрос запускает его на том же сервере с теми же данными. Если сервер недоступен, приложение ждёт, а не запускается с пустым томом на другом сервере. Чтобы запустить несколько реплик, у каждой из которых свои данные, используйте stateful-реплики (альфа, ниже).
На этом стоят шаблоны баз данных: inquir apps create mydb --template postgres (или --template redis) создаёт приложение с постоянным томом, приватным TCP-портом на постоянном приватном адресе (mydb-<suffix>.apps.internal, поэтому строка подключения переживает любой повторный деплой), сгенерированным паролем в зашифрованном env и первым релизом — одна команда от пустоты до работающей базы.
inquir apps connection-url mydb печатает действующий URL вместе с учётными данными. Чтобы дать доступ другому приложению так, чтобы пароль не проходил через человека, выполните inquir apps connect mydb web: сервер сам соберёт URL и запишет его в окружение web как DATABASE_URL (REDIS_URL для Redis), и он вступит в силу со следующим релизом web. Консоль намеренно показывает тома и их резервные копии, но не учётные данные.
Резервные копии#
Резервная копия — снимок содержимого одного тома в artifact store платформы, который можно восстановить на тот же том. Копии существуют только там, где для развёртывания настроено объектное хранилище: GET /v1/apps/limits сообщает об этом полем features.volumeBackups, а вкладка Тома скрывает элементы управления, когда его нет.
- Автоматически: интервал и хранение зависят от конфигурации. В режимах политики хранения off/report прежний интервал по умолчанию — 6 часов, хранение — 7 копий READY на том суммарно для обоих способов запуска; report только оценивает предлагаемую политику плана. В режиме enforce значения планов по умолчанию: Free — каждые 24 часа, 2 автоматические и 1 ручная копия; Simple/default — 24 часа, 3 и 3; Pro — 24 часа, 7 и 5; Enterprise — 12 часов, 14 и 10. Настройки оператора и переопределения рабочего пространства могут менять эти значения. Выключение планировщика отключает автоматические копии во всех режимах. Льготный период при смене плана и защищённые точки восстановления могут сохранять дополнительные копии. Проверяйте действующую политику, состояние каждого тома и последний успешный снимок; интервал не гарантирует допустимую потерю данных при восстановлении.
- По запросу:
inquir apps backups mydb createснимает каждый том, подключённый к релизу продакшена, и ждёт, пока снимки не будут готовы (--no-waitвозвращает управление сразу);inquir apps backups mydb listпоказывает их, начиная с новых. - Crash-consistent: локальный путь приостанавливает контейнер на время копирования на локальный диск. Runner использует копирование с заморозкой в пределах настроенного порога (по умолчанию 2 GiB выделенных данных суммарно во всех томах приложения). Выше порога бэкап завершается ошибкой
FREEZE_TOO_LARGE, если precopy не включён черезRUNNER_VOLUME_BACKUP_PRECOPY=on; изменённые данные могут превысить порог и при precopy. Предельное время заморозки runner по умолчанию — 60 секунд; обычная длительность не гарантируется. Оба пути проверяют архивы с пределами 64 GiB несжатых данных на архив и 8 GiB на файл. Это пределы отказа, а не размер, подтверждённый реальным восстановлением. Восстановленный PostgreSQL должен воспроизвести WAL и пройти SQL-проверки; большие тома требуют отдельных тестов восстановления локально и на runner. - Восстановление заменяет том.
inquir apps backups mydb restore <id> --yesостанавливает приложение, заменяет содержимое тома снимком и запускает приложение снова; всё, что записано после снимка, теряется. Восстановление и удаление точки восстановления требуют прав владельца или администратора, как и любое другое действие, которое затрагивает продакшен. - Скачивание.
inquir apps backups mydb download <id> -o mydb.tar.gz(или кнопка Скачать у копии на вкладке Тома) сохраняет архив готовой (READY) копии на ваш компьютер, чтобы у вас была копия вне платформы. Это полная выгрузка данных, поэтому нужен владелец или администратор, вошедший в систему или с персональным токеном доступа (не API-ключ рабочего пространства); каждое скачивание записывается в журнал, а по умолчанию одно рабочее пространство может скачивать 2 копии одновременно и 20 в час.
Восстановление скачанной копии на своём сервере#
Файл — это .tar.gz с содержимым одного тома в том виде, в каком его записало приложение: пути относительно корня тома; каталоги, файлы и символические ссылки с владельцем, группой и правами. Распаковывайте от root командой tar -xzpf, чтобы сохранить владельцев. CLI докачивает прерванную загрузку и сохраняет файл, только если совпала его sha256.
# Take a copy home: the archive of one READY backup, sha256-checked, resumable inquir apps backups mydb # pick a READY backup id inquir apps backups mydb download 3f9c1a2b -o mydb.tar.gz # Restore it on any server (here: the postgres template's Postgres 16) mkdir -p ./pgdata && sudo tar -xzpf mydb.tar.gz -C ./pgdata docker run -d --name restored -v "$PWD/pgdata:/var/lib/postgresql/data" postgres:16-alpine docker logs -f restored # "database system is ready to accept connections" after WAL replay
- Шаблон Postgres: архив — это каталог данных сервера, а не SQL-дамп. Он запускается только той же мажорной версией (в шаблоне Postgres 16) на той же архитектуре процессора, а файлы должны принадлежать пользователю сервера (uid 70 в образе alpine, 999 в Debian). При первом запуске Postgres проигрывает журнал предзаписи, как после отключения питания. Чтобы перейти на другую мажорную версию, запустите копию на 16 и сделайте
pg_dump. - Шаблон Redis: файлы из
/data(dump.rdb, append-only файлы); запустите на них Redis той же или более новой версии. Любой другой том: файлы ровно в том виде, в каком их записало ваше приложение. - Контрольная сумма: sha256 файла совпадает с
artifactDigestкопии и заголовком ответаX-Inquir-Backup-Sha256;sha256sum mydb.tar.gzпроверит файл, который вы куда-то переносили. - API:
GET /v1/apps/<id>/backups/<backupId>/downloadотдаёт архив потоком сContent-Lengthи докачивается однимRange: bytes=…; сверх лимитов отвечает429сRetry-After. MCP-инструмента для этого намеренно нет: агент не должен сам выгружать целую базу данных.
Stateful-реплики#
Альфа
База данных или поисковый движок могут работать в нескольких неодинаковых репликах. С scale.mode: stateful реплики запускаются по порядку 0, 1, 2…, у каждой свой том и своё внутреннее имя (0.{app}.apps.internal, 1.{app}.apps.internal…), а ролевые адреса вроде rw.{app}.apps.internal и ro.{app}.apps.internal указывают на пишущую реплику и на читающие. Включается в Настройки → Масштабирование («У каждой реплики свой том»), в inquir.yaml в services.web.scale или через CLI. Платформа не знает вашу базу данных: копирование данных между репликами (например, потоковая репликация Postgres) остаётся за приложением.
# inquir.yaml: two ordered replicas (Alpha), each with its own volume and name <n>.{app}.apps.internal version: 1 services: web: runtime: port: 8080 volumes: - { name: data, mountPath: /data } scale: mode: stateful replicas: 2 # replica 0 starts first, replica 1 once 0 serves endpoints: rw: { ordinals: "0", max: 1 } # rw.{app}.apps.internal: the writer only ro: { ordinals: "1-" } # ro.{app}.apps.internal: the readers # An application without scale in inquir.yaml: the CLI or Settings → Scale (no endpoints there) inquir apps scale db --replicas 2 --stateful inquir apps replicas db # server, volume and state of each replica
- Требования. Постоянный том (у каждой реплики свой, новый начинается пустым), приложение, которое работает всегда (
scaling.activationнеhttp: без масштабирования до нуля), с одной репликой в обычной политике (число реплик задаётscale.replicas, от 1 до 8), публичный TCP-порт — только при одной реплике. Работающая реплика приложения с одной репликой становится репликой 0 на месте, без перезапуска. - Размещение. По умолчанию каждая реплика работает на отдельном сервере (
scale.placement), и её том остаётся там. Реплика без свободного сервера ждёт и показывается как неразмещённая; реплика 0 остаётся там, где её том. - Деплой. Релиз доходит до реплик по одной, начиная со старшей; следующая обновляется, только когда предыдущая начала обслуживать запросы.
inquir apps rolloutпоказывает ход;scale.update.partitionоставляет младшие реплики на их релизе (канареечный выпуск). - Лимиты тарифа. Каждая реплика считается в лимитах тарифа по репликам, CPU и памяти — со своим размером (с учётом
scale.ordinals). Масштабирование, деплой или возобновление, которые не помещаются, отклоняются (402 PLAN_CAPACITY_EXCEEDED); то, что уже работает, не останавливается. - При уменьшении числа реплик данные сохраняются. Тома удалённой реплики хранятся 7 дней по умолчанию (
scale.retention) и возвращаются вместе с ней при увеличении; удалить их раньше можно в меню реплики или командойinquir apps replicas delete-volume.
Собственные домены#
- Добавить домен
Указать имя домена в настройках приложения
- Настроить DNS
Перенести записи, показанные платформой, к DNS-провайдеру
- Проверить
Дождаться обновления DNS и запустить проверку домена
- Проверить HTTPS
Открыть домен и проверить ответ приложения
Используйте точные записи из настроек вашего приложения. Обновление DNS и выпуск сертификата происходят не мгновенно.
Помимо платформенного имени хоста, приложение доступно по любому имени, которое вы к нему привяжете, — в разделе Настройки → Сеть панели сервиса или из CLI. Новое имя сначала не подтверждено: на него не идёт трафик и сертификат не выпускается, пока вы не подтвердите владение TXT-записью _inquir-verify.<host> с выданным токеном и не добавите CNAME на платформенное имя хоста приложения — консоль и CLI печатают его рядом с токеном (для корневого домена — ALIAS или CNAME flattening на то же имя). Проверка обращается напрямую к DNS-серверам домена, поэтому видит записи, как только DNS-провайдер их опубликует. Затем подтвердите:
# Bind the hostname — it starts unverified and prints the DNS records to publish inquir apps domain shop shop.example.com # TXT _inquir-verify.shop.example.com -> <token> # CNAME shop.example.com -> shop-x1y2z3.apps.inquir.org # Once your DNS provider has published them, prove ownership (checked at the domain's own # nameservers, no waiting for public DNS caches): the hostname becomes routable and gets TLS inquir apps domain shop shop.example.com --verify inquir apps domain shop # list bound hostnames inquir apps domain shop shop.example.com --remove # unbind
Свои домены — всегда имена хостов продакшена: с момента подтверждения они ведут на релиз в продакшене; добавить домен можно как до, так и после первого перевода в продакшен. Имена, принадлежащие платформе (суффиксы apps и preview, адреса сайта и консоли, имена, уже занятые своим доменом шлюза), отклоняются. Изменение доменов переключает трафик продакшена, поэтому требует роли владельца или администратора.
Для опытных, не рекомендуется: маски. Если установка это разрешает, *.example.com переводит на приложение все поддомены первого уровня (a.example.com, но не a.b.example.com). На него уходят все такие имена, в том числе сервисы, о которых вы можете не знать (API, вебхуки, интеграции), — они перестают работать, а предназначенные им запросы приходят в приложение вместе с cookie и токенами. Имя, привязанное отдельно, всегда важнее маски. Владение подтверждается wildcard-записью CNAME *.example.com на имя хоста приложения и TXT-записью _inquir-verify.example.com. Каждый поддомен получает свой сертификат при первом запросе, не больше заданного числа новых на маску в неделю (по умолчанию 20; лимит Let's Encrypt — 50 в неделю — общий для всего домена); продления не считаются. Поскольку маска направляет на платформу любое имя, кто угодно может исчерпать этот запас запросами к случайным именам, и тогда новые поддомены до недели остаются без сертификата. Консоль и CLI просят подтвердить риски (--yes; в API — acknowledgeWildcardRisks: true). Лучше привязывайте нужные имена по одному; маска подходит приложению, которое само обслуживает много хостов, например поддомен на клиента.
Переменные окружения#
Задавайте переменные на приложении (--set KEY=VALUE в inquir apps create или inquir apps update, вкладка Переменные или envVars в API). Значения хранятся в зашифрованном виде, маскируются при каждом чтении и фиксируются в каждом релизе при его создании — изменение переменной влияет на следующий релиз, а не на запущенный. Чтобы подхватить новые значения, разверните релиз заново: кнопка Развернуть заново в панели сервиса или inquir apps redeploy.
Ключи из productionOnlyEnvKeys не передаются релизу, пока он работает как предварительная версия, и добавляются только при переводе в продакшен (контейнер сначала пересоздаётся с профилем продакшена). Используйте это для учётных данных продакшена, чтобы адрес предварительной версии, переданный коллеге или агенту, не давал к ним доступа. PORT подставляется автоматически из основного HTTP-порта.
Исходящий трафик#
--egress none|full (networkPolicy.egress) определяет, может ли контейнер вообще открывать исходящие соединения. none помещает его в изолированную сеть без маршрута наружу — правильно для базы данных, к которой только подключаются, и неправильно для всего, что вызывает внешние API. Списки разрешённых хостов доступны для функций, но пока не для приложений; API отвечает 400 на allowlist, вместо того чтобы принять политику, которую релиз не сможет соблюсти.
Квоты и значения по умолчанию#
У каждого рабочего пространства есть потолок по числу живых релизов и по ресурсам на релиз; форма создания и GET /v1/apps/limits показывают действующие значения. Значения платформы по умолчанию:
| Лимит | По умолчанию |
|---|---|
| Работающие релизы на рабочее пространство (предварительные версии + продакшен + резерв) | 10 |
| Память на релиз | 512 MB (потолок 2,048 MB) |
| CPU на релиз | 0.5 vCPU (потолок 2 vCPU) |
| Срок стартовой проверки работоспособности | 120 s |
| Drain-окно (резерв отката) | 5 min |
| Время жизни предварительной версии | 24 h |
| Перезапусков до пометки релиза как упавшего (crash loop) | 5 |
Роли и API-ключи#
Любой участник рабочего пространства, включая роль developer, может создавать приложения, разворачивать релизы, смотреть логи, останавливать релизы вне продакшена и менять настройки. Перевод в продакшен, откат, свои домены, архивация и exec требуют владельца или администратора, выполнившего вход (сессия в браузере или персональный токен доступа, выданный inquir login). Действия, недоступные текущей роли, показаны неактивными с указанием причины.
API-ключи рабочего пространства не могут переводить релизы в продакшен, какой бы широкой ни была их роль: перевод в продакшен и exec требуют входа пользователя. Это сделано намеренно: ключ CI или агента с областью deploy может собирать и выпускать предварительные версии, читать их статус и логи, но не может переключать трафик продакшена или читать секреты работающего контейнера.
REST API#
Всё, что делают CLI и консоль, идёт через /v1/apps…. Долгие операции отвечают 202 и возвращают URL статуса: пока digest не закреплён, в записи релиза хранится исходная ссылка на образ, затем imageDigest меняется на sha256:….
| Эндпоинт | Назначение |
|---|---|
POST /v1/apps, GET /v1/apps | Создать приложение (значения env маскируются при каждом чтении) / список с курсорной пагинацией. |
GET /v1/apps/:id, PATCH /v1/apps/:id, DELETE /v1/apps/:id | Прочитать (указатель продакшена, адреса, предварительные версии, домены, последние релизы) / обновить — маскированные значения переменных объединяются, а не перезаписываются / архивировать с безвозвратным удалением сервиса и постоянных томов через 24 часа. |
POST /v1/apps/:id/releases | Создать релиз из {buildId} или {imageRef, runtime?} → 202; загрузка образа и проверка работоспособности выполняются в фоне. |
GET /v1/releases/:id, GET /v1/releases/:id/logs | Проекция статуса релиза / логи контейнера по SSE. |
POST /v1/releases/:id/promote, POST /v1/apps/:id/rollback | Перевести трафик продакшена на релиз / вернуть на предыдущий (200 — мгновенно, 202 — с перезапуском). Только для владельца или администратора, выполнившего вход. |
DELETE /v1/releases/:id | Остановить любой релиз вне продакшена; для релиза, на который идёт трафик, ответ — 409. |
POST /v1/releases/:id/exec | Выполнить команду внутри живого контейнера (вывод ограничен 1 MiB; по таймауту дерево процессов убивается). Только вход владельца/администратора. |
POST /v1/apps/:id/domains, POST …/domains/:hostname/verify | Привязать своё имя хоста (не подтверждено, возвращает TXT-запись) / проверка владения через DNS → трафик и TLS. |
POST /v1/apps/:id/builds, GET /v1/builds/:id/logs | Собрать образ из снимка исходников или zip в base64 → 202 / логи сборки в реальном времени; POST /v1/builds/:id/cancel отменяет сборку в очереди. |
POST /v1/apps/:id/backups, GET /v1/apps/:id/backups | Снять снимок каждого подключённого тома релиза продакшена (202 означает принятие запроса, а не готовность бэкапа) / список точек восстановления, начиная с новых. Список также возвращает coverage для каждого настроенного или подключённого в продакшене тома независимо от страниц истории: backed_up, stale, failed, skipped, unsupported или never, с полями reason, lastGoodAt и intervalHours. Более новая ошибка сохраняет время последнего успешного снимка. Состояние отражает записи о бэкапах, а не проверенное восстановление или независимую копию. Действующая policy включается только в режиме enforce. |
POST …/backups/:backupId/restore, DELETE …/backups/:backupId | Восстановить снимок поверх его тома, остановив и снова запустив приложение / удалить точку восстановления. Владелец или администратор. |
GET …/backups/:backupId/download | Архив готовой (READY) копии (application/gzip) потоком; один Range докачивает его. Владелец или администратор с пользовательской учётной записью; с журналом и лимитами на рабочее пространство. |
POST /v1/apps/:id/connection-url, POST /v1/apps/:id/connect | Живой URL подключения к базе из шаблона / запись его в окружение другого приложения. Обе — POST и никогда не кэшируются: это единственное место, где API отдаёт сохранённые учётные данные. |
GET /v1/apps/limits | Квоты, значения по умолчанию и диапазон host-портов, действующие в этом рабочем пространстве. |
# A workspace API key goes in X-Api-Key; Authorization: Bearer takes a personal access token # Create an application curl -X POST "https://api.inquir.org/v1/apps" \ -H "X-Api-Key: $INQUIR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"name":"web","runtime":{"port":3000}}' # Release a prebuilt image — 202; the pull and the health gate run in the background curl -X POST "https://api.inquir.org/v1/apps/{appId}/releases" \ -H "X-Api-Key: $INQUIR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"imageRef":"nginx:alpine"}' # -> { "id": "…", "status": "PENDING" } poll GET /v1/releases/{releaseId} # Promote — needs a user session or personal access token; API keys are refused curl -X POST "https://api.inquir.org/v1/releases/{releaseId}/promote" \ -H "Authorization: Bearer $INQUIR_PAT" # -> { "productionUrls": ["https://web.apps.inquir.org"], "previousReleaseId": "…" }
Плоскость вычислений: ECS без ECS#
За каждым приложением стоит оркестрация в духе AWS ECS: ёмкость, размещение, проверки работоспособности и восстановление берёт на себя платформа. Серверы (рабочие серверы) регистрируются в управляющем узле и регулярно сообщают о себе; релизы размещаются на них как изолированные аллокации; шлюз направляет трафик прямо в контейнеры, где бы они ни работали.
- Переносимые релизы. Каждая сборка отправляется в реестр платформы и закрепляется по digest — ровно тот же образ запускается на любом рабочем сервере: релиз — это байты, а не машина.
- Размещение. Планировщик выбирает рабочий сервер по свободной ёмкости (плотная упаковка на одной машине или распределение по нескольким); запросы распределяются между репликами одного приложения.
- Работоспособность и реплики. Релиз обслуживает трафик только после прохождения проверки работоспособности на том интерфейсе, куда трафик реально приходит. Приложения
alwaysмасштабируются до 8 реплик; упавшие контейнеры перезапускаются с экспоненциальным бэкоффом. - Восстановление. Потерянный рабочий сервер обнаруживается по истечении аренды, и его аллокации переносятся; перезапуск сервера не трогает работающие контейнеры, и платформа снова берёт их под управление — трафик этого не замечает.
Ничего из этого не требует настройки: inquir apps deploy собирает, публикует, размещает и переводит релиз в продакшен.
Ограничения#
- До 8 реплик, только в режиме
always. Приложенияhttpиmanualработают в одной реплике, как и приложение с томом для записи. Когда перезапускается релиз с одной репликой — после падения или при пересоздании во время перевода в продакшен, если есть переменные только для продакшена, — на именах хостов этого релиза ненадолго появляются ответы503; при нескольких репликах остальные продолжают обслуживать трафик. На имени хоста продакшена ничего не переключается, пока новый контейнер не пройдёт проверку работоспособности. - Постоянные тома локальны для одного runtime-хоста. Приложение с томом закреплено за хостом, который его держит: ни репликации, ни живой миграции, и резервные копии — единственная копия данных, покидающая этот хост. Удаление mount-настройки сохраняет Docker-том до очистки оператором. После архивации сервис и его тома удаляются безвозвратно через 24 часа; в архиве можно запустить удаление сразу.
- Автомасштабирования нет. Ресурсы фиксированы на релиз (
--memory,--cpu); чтобы масштабироваться, переведите в продакшен релиз с бо́льшим потолком.