Перейти к содержимому
Документация

Контейнерные приложения

Запускайте любой 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, чтобы вместо сборки выпустить готовый образ. Команда ждёт, пока релиз пройдёт проверку работоспособности, и печатает его адрес.

quickstartbash
# 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 создаёт проект для приложения и печатает его имя.

setupbash
# 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.

deploybash
# 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

Обновление#

updatebash
# 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.

postgresbash
# 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 домен не нужен. Для вебхука дайте приложению публичный адрес и сообщите его боту; бот сам зарегистрирует вебхук и проверяет секрет каждого вызова.

webhookbash
# 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 в остальных случаях.

ПробаЧто доказывает
httpGET по пути проверки работоспособности (по умолчанию /) отвечает статусом ниже 500 — сервер, отдающий 404 на корень, всё же слушает; проверку не проходят только ошибки соединения и 5xx.
tcpПорт принимает соединение и ненадолго удерживает его открытым.
commandКоманда, запущенная внутри контейнера, завершается с кодом 0.

Адрес предварительной версии и адрес продакшена#

У приложения с HTTP-портом есть одно имя хоста продакшена ({app}.apps.… плюс свои домены), которое всегда указывает на релиз в продакшене, а у каждого релиза — свой адрес предварительной версии, пока релиз не переведут в продакшен или не остановят. TLS для обоих завершается на границе платформы. У чисто TCP-сервиса адреса URL нет вовсе — к нему подключаются по приватной сети по адресу {app}.apps.internal и порту контейнера; адрес показывает inquir apps status.

Перевод в продакшен, откат, остановка#

Проверка релиза перед переключением трафика
  1. Новый релиз

    Запустить новую версию и дождаться готовности

  2. Preview

    Открыть preview URL и проверить приложение

  3. Публикация

    Переключить production-маршрут на проверенный релиз

  4. Откат при необходимости

    Вернуть трафик на доступный предыдущий релиз

Откат меняет релиз приложения. Он не отменяет миграции БД и не восстанавливает данные томов.

Перевод в продакшен — осознанный шаг с подтверждением: 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-портом отклоняется с объяснением причины:

postgresbash
# 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):

privatebash
# 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 печатают приватный адрес, когда платформа проверила маршрут этого приложения от начала до конца (через несколько секунд после каждого деплоя). До этого он отображается как «подготавливается» — по имени он никогда не угадывается.

Тома и базы данных#

Что сохраняется при замене контейнера
  1. Приложение записывает

    Записывать постоянные данные в путь монтирования тома

  2. Постоянный том

    Данные находятся вне записываемого слоя контейнера

  3. Новый контейнер

    Читает данные при подключении того же тома

Файлы вне пути монтирования не являются постоянными. Том не заменяет бэкап; копия БД требует согласованного снимка или дампа.

Том — именованное хранилище, подключённое к приложению: объявите его флагом --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.

downloadbash
# 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.yamlbash
# 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.

Собственные домены#

Подключение домена
  1. Добавить домен

    Указать имя домена в настройках приложения

  2. Настроить DNS

    Перенести записи, показанные платформой, к DNS-провайдеру

  3. Проверить

    Дождаться обновления DNS и запустить проверку домена

  4. Проверить HTTPS

    Открыть домен и проверить ответ приложения

Используйте точные записи из настроек вашего приложения. Обновление DNS и выпуск сертификата происходят не мгновенно.

Помимо платформенного имени хоста, приложение доступно по любому имени, которое вы к нему привяжете, — в разделе Настройки → Сеть панели сервиса или из CLI. Новое имя сначала не подтверждено: на него не идёт трафик и сертификат не выпускается, пока вы не подтвердите владение TXT-записью _inquir-verify.<host> с выданным токеном и не добавите CNAME на платформенное имя хоста приложения — консоль и CLI печатают его рядом с токеном (для корневого домена — ALIAS или CNAME flattening на то же имя). Проверка обращается напрямую к DNS-серверам домена, поэтому видит записи, как только DNS-провайдер их опубликует. Затем подтвердите:

domainbash
# 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-портов, действующие в этом рабочем пространстве.
curlbash
# 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); чтобы масштабироваться, переведите в продакшен релиз с бо́льшим потолком.