Перейти к основному содержимому

Приложения

Платформа приложений разворачивает веб-приложения из Git-репозитория или прямо из папки на вашем диске — по модели Vercel/Netlify. Каждый push в выбранную ветку автоматически собирает и публикует новую версию.

Нет готового кода?

Сайт можно не писать самому: конструктор T1000 собирает приложение по описанию словами и публикует его на этой же платформе.

Подключение репозитория​

Поддерживаются провайдеры GitHub, GitLab, GitVerse, GitFlic и Gitea (git.tatnet.ru). Подключите репозиторий, выберите ветку — и платформа будет реагировать на push'и через веб-хуки.

Без репозитория — из папки​

Репозиторий нужен не всегда. Локальную папку можно выложить одной командой консольного клиента:

cd ~/проекты/лендинг
tatnet deploy

Это удобно, чтобы попробовать платформу, выложить статический сайт или отдать на сборку результат чужого конвейера. Подробности и ограничения — «Деплой из папки»; главное из них: у такой выкладки нет коммита, то есть ни автора, ни разницы с прошлой версией.

Сборка​

Сборка запускается автоматически и поддерживает популярные стеки: Next.js, статические сайты, Go и другие. Логи сборки доступны в реальном времени, а статус деплоя приходит через SSE.

Домены и HTTPS​

Каждое приложение получает адрес *.tatnet.app. На вкладке Домены можно подключить свой домен и автоматически выпустить TLS-сертификат. Технический адрес по умолчанию продолжает обслуживать Production. Чтобы перенаправлять его на свой домен, нажмите Изменить в строке адреса и явно задайте редирект 308. Технические preview-адреса автоматически закрыты от индексации.

Пошаговая настройка, правила индексации и освобождения имён описаны в разделе Домены приложения.

Приватная сеть (VPC)​

Приложение можно подключить к приватной сети аккаунта — тогда оно ходит к остальным ресурсам этой сети по приватным адресам. Сеть выбирается при создании приложения и меняется в любой момент в настройках приложения (карточка «VPC сеть»); значение «Без VPC» отключает приложение от приватной сети и возвращает его в общий пул.

Смена сети заменяет реплики

Работающая реплика остаётся в той сети, в которой была создана, поэтому при смене платформа пересоздаёт инстансы приложения в новой сети — возможен короткий перерыв. При стратегии rolling реплики заменяются по одной, и несколько минут часть из них ещё работает в старой сети, видя старый набор ресурсов. Если такое промежуточное состояние недопустимо, переключите стратегию на recreate перед сменой сети.

Подключить можно только сеть того же региона, в котором работает приложение: регион задаётся при создании и не меняется, а в чужом регионе у приложения нет сетевого порта. В панели список сетей уже отфильтрован по региону приложения, через API сеть другого региона отклоняется с ошибкой 400.

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

Переменные окружения (включая секреты) задаются в панели и доступны приложению во время сборки и выполнения.

Конфигурация маршрутизации​

Файл tatnet.json или vercel.json в корне репозитория задаёт headers, redirects и rewrites. Сборщик проверяет и компилирует правила, а edge применяет их из конфигурации выбранного деплоя. При наличии обоих файлов используется tatnet.json. Синтаксис описан в JSON-схеме маршрутизации.

Для статических приложений порядок обработки одинаков в обоих регионах.

  1. Применяется первый подходящий редирект.
  2. Edge ищет существующий файл. Для пути без расширения также проверяются path/index.html и path.html.
  3. После промаха файлового поиска применяется первый подходящий rewrite, и edge ищет файл по его адресу.
  4. Если файл так и не найден, клиентский SPA-маршрут получает /index.html. Это работает и для путей с точкой, например /user/john.doe. Отсутствующий файл под /assets/ или с известным расширением ассета возвращает 404.

Правила headers сопоставляются с исходным путём запроса и применяются в том числе на 404. Для 404 под /assets/ edge выставляет Cache-Control: no-store, сохраняя заголовки безопасности приложения.

CORS

Задавайте нужные заголовки CORS, например Access-Control-Allow-Origin, через headers в конфигурации приложения.

Кэширование и сжатие статики​

По умолчанию статические файлы без метки версии возвращаются с Cache-Control: no-cache. Браузер может хранить ответ и проверяет его актуальность перед повторным использованием.

Чтобы включить годовой кэш для файлов с версией содержимого, добавьте .tatnet/immutable-assets.json в корень выходного каталога сборки, например dist/.tatnet/immutable-assets.json. В assets укажите пути относительно выходного каталога и SHA‑256 окончательных файлов. Для каждого указанного файла URL должен меняться при изменении содержимого. Пример ниже создаёт манифест для файла dist/assets/app-vkD5xi.js.

asset='assets/app-vkD5xi.js'
digest=$(sha256sum "dist/$asset" | cut -d ' ' -f 1)
mkdir -p dist/.tatnet
printf '{"version":1,"assets":{"%s":"%s"}}\n' "$asset" "$digest" \
> dist/.tatnet/immutable-assets.json

Сборщик сверяет SHA‑256 и помечает файл при публикации. Ошибка в манифесте, отсутствующий файл или несовпадение SHA‑256 останавливают сборку. Сам манифест служебный и на сайте не публикуется.

Прямой URL маркированного файла по умолчанию возвращает Cache-Control: public, max-age=31536000, immutable. Стабильный rewrite-алиас на такой файл по умолчанию ревалидируется. Для маркированных файлов и алиасов можно задать собственную политику кэша через headers. Если правило запрашивает immutable для файла без метки, применяется ревалидация с сохранением ограничений private или no-store. Для ранее опубликованных файлов метки появятся после новой сборки с манифестом.

Edge согласует gzip для HTML, CSS, JavaScript, JSON, SVG и веб-манифестов. Веб-манифесты .webmanifest отдаются как application/manifest+json. Команда ниже запрашивает gzip и выводит заголовки ответа на GET.

curl -sS -D - -o /dev/null -H 'Accept-Encoding: gzip' \
"https://my-app.tatnet.app/$asset"

Масштабирование​

По умолчанию деплой выполняется по стратегии rolling. Для приложений с постоянной доступностью держите не менее одной реплики — иначе при простое приложение масштабируется до нуля и первый запрос ждёт cold start.

Как считаются вычисления​

Статическому сайту вычисления не нужны: файлы отдаются напрямую. Платят приложения, у которых есть сервер, — backend и SSR (например, Next.js). Как именно — зависит от числа реплик.

Реплик 1 и больше — постоянный резерв. Машины работают всё время, оплата помесячная за выделенные vCPU и память каждой реплики, по прайсу.

Реплик 0 — по требованию. Машина поднимается на первый запрос и гаснет после простоя. Считаются две величины:

  • Active CPU — время, когда процессор действительно выполнял код приложения. Пока приложение ждёт запрос, ответ базы данных или внешнего API, процессор простаивает и Active CPU не расходуется. Мы измеряем его снаружи машины, по работе её виртуальных процессоров, поэтому ни код, ни нагрузка внутри на измерение не влияют. Актуальная ставка — на странице цен.
  • Память — объём памяти машины × время, пока она запущена, в ГБ·ч.

Пример: сайт на Next.js обработал за день 5 000 запросов по 40 мс процессора на каждый. Это 200 секунд, то есть около 0,06 ч Active CPU, хотя машина была запущена несколько часов. За всё время запуска отдельно учитывается память.

В каждый тариф входят часы Active CPU и ГБ·ч памяти на месяц — они указаны в карточке тарифа и расходуются первыми. Расход по приложениям виден в разделе «Финансы».

Если измерение за какой-то час не удалось, этот час по CPU не выставляется вовсе — мы не подставляем за вас оценку.

Исходящий трафик​

Сейчас работает режим наблюдения, списания за трафик Apps отключены. Расход этого периода сохраняется для проверки учёта и не будет начислен задним числом. Условия ниже применяются с отдельно объявленной даты начала оплаты.

На любом плане в один аккаунт включено 100 ГБ исходящего трафика Apps в календарный месяц. Сверх объёма — 1,30 ₽/ГБ. Это общий объём для всех приложений и проектов аккаунта, а не отдельная квота для каждого приложения. 1 ГБ = 1 000 000 000 байт. Актуальный тариф — на странице цен.

Считается тело HTTP-ответа, отправленное внешнему получателю через входной прокси Apps, после сжатия, без HTTP-заголовков. Учитываются ответы из кэша, ошибки и фактически переданная часть прерванного ответа. Внутренние запросы между прокси и экземпляром не учитываются повторно. Для длительного ответа или соединения байты относятся к месяцу его завершения.

Входящий запрос, прямые исходящие соединения приложения к внешним API, а также трафик S3 и Supabase в счётчик Apps не входят. Трафик S3 и Supabase регулируется условиями соответствующих услуг; их включённые объёмы не объединяются с Apps.

Объём обновляется первого числа в 00:00 МСК (UTC+3); остаток не переносится. При создании аккаунта в середине месяца предоставляются полные 100 ГБ. Смена плана и создание или удаление приложения квоту не обновляют. Каждый ответ измеряется в байтах без округления до гигабайта.

Трафик аккаунта за месяцПревышениеСтоимость трафика
80 ГБ0 ГБ0 ₽
100 ГБ0 ГБ0 ₽
150 ГБ50 ГБ65 ₽
1 000 ГБ900 ГБ1 170 ₽

Формула: max(объём в ГБ − 100; 0) × 1,30 ₽. Например, два приложения, передавшие 70 и 80 ГБ, вместе расходуют 150 ГБ: счёт за трафик — 65 ₽. Потребление приложений суммируется, включённый объём вычитается один раз. Вычисления, план и хранилище оплачиваются отдельно.

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

Новый учёт применяется с объявленной даты начала начислений после публикации тарифа и уведомления клиентов. Старый трафик по новой ставке не пересчитывается.

Проба готовности​

Некоторые приложения открывают сетевой порт раньше, чем действительно готовы обслуживать запросы, — например, пока прогревается кэш, применяются миграции или идёт JIT-компиляция. Без пробы готовности платформа считает реплику готовой сразу после открытия порта и может направить на неё трафик слишком рано — тогда первые запросы после деплоя или cold start отдают 502/503/504.

Чтобы этого избежать, задайте путь пробы готовности (readiness_path) — например /healthz. Тогда после старта реплики платформа опрашивает GET http://<реплика>:<порт><readiness_path> и включает реплику в обслуживание только после ответа со статусом 2xx или 3xx. Пока путь отвечает иначе (или недоступен), реплика не получает трафик; если готовности нет по истечении таймаута, деплой этой реплики считается неуспешным.

  • Поле опциональное. Если оставить его пустым, поведение прежнее: реплика считается готовой сразу после открытия порта.
  • Проверка выполняется изнутри микро-VM (127.0.0.1), поэтому эндпоинт готовности не обязан быть публичным.
  • Задавайте лёгкий эндпоинт: он опрашивается на каждой итерации при старте.

Настраивается в разделе Deployment настроек приложения или через API (поле readiness_path в создании/обновлении приложения).

API​

Публичный REST API (https://api.min.tatnet.ru/v1, заголовок Authorization: Bearer <tn_live_…>):

МетодПутьДействие
GET/v1/projects/{project_id}/appsсписок приложений проекта
POST/v1/projects/{project_id}/appsсоздать приложение (в т.ч. readiness_path)
GET/v1/projects/{project_id}/apps/{id}получить приложение
PATCH/v1/projects/{project_id}/apps/{id}масштабирование, ресурсы и сеть: replica_count, replica_vcpu, replica_memory_mb, readiness_path, vpc_id, name — каждое поле опционально
POST/v1/projects/{project_id}/apps/{id}/deployзапустить сборку и деплой
POST/v1/projects/{project_id}/apps/{id}/deploymentsвыложить исходники из папки: тело запроса — tar.gz (для приложений с source_type=upload)
GET/v1/projects/{project_id}/apps/{id}/builds/{build_id}/logsпоток лога сборки (SSE)
DELETE/v1/projects/{project_id}/apps/{id}удалить приложение
GET/v1/projects/{project_id}/apps/{id}/buildsсписок сборок
GET/v1/projects/{project_id}/apps/{id}/envсписок переменных окружения (секреты маскируются)
POST/v1/projects/{project_id}/apps/{id}/envсоздать или обновить переменную (name, value, is_secret) — существующее имя обновляется на месте
DELETE/v1/projects/{project_id}/apps/{id}/env/{env_var_id}удалить переменную
GET/v1/projects/{project_id}/apps/{id}/domainsсписок доменов
POST/v1/projects/{project_id}/apps/{id}/domainsдобавить кастомный домен
DELETE/v1/projects/{project_id}/apps/{id}/domains/{domain_id}удалить домен

Адресация без проекта​

У каждого пути выше есть плоский двойник без проекта в адресе — тот же смысл, та же политика ключа:

МетодПутьДействие
GET/v1/appsвсе приложения аккаунта ключа; ?project_id= — только одного проекта
GET / PATCH / DELETE/v1/apps/{id}приложение по id
…/v1/apps/{id}/deploy, /deployments, /builds, /builds/{build_id}/logs, /env, /domains, /jobs, /job-runsто же, что и под /projects/{project_id}/apps/{id}/…

Так же, с 2026-09-23, адресуются ВМ, функции, тома, кластеры Postgres, Valkey и Kubernetes и балансировщики: /v1/<вид> и /v1/<вид>/{id}/….

Зачем: чтобы обратиться к приложению, не нужно знать и не нужно иметь право читать проект. Ключу, которому не выдали GET /v1/projects, приложение по плоскому пути доступно — если политика разрешает действие на него. Исключение — создание: POST /v1/apps нет, приложение создаётся в проекте (POST /v1/projects/{project_id}/apps).

Ошибки те же: чужой аккаунт → 404 (существование не раскрывается), свой аккаунт без права → 403.

Изменение ресурсов реплики применяется сразу — деплойер прокатывает работающие реплики на новый размер (rolling). Изменение переменной окружения также автоматически перезапускает реплики.

Пример — поднять реплику до 4 vCPU / 6 ГБ:

curl -X PATCH "https://api.min.tatnet.ru/v1/projects/{project_id}/apps/{id}" \
-H "Authorization: Bearer $TATNET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"replica_vcpu": 4, "replica_memory_mb": 6144}'

Пример — задать пробу готовности (пустая строка снимает её):

curl -X PATCH "https://api.min.tatnet.ru/v1/projects/{project_id}/apps/{id}" \
-H "Authorization: Bearer $TATNET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"readiness_path": "/healthz"}'

Пример — подключить приложение к приватной сети; null отключает его от сети:

curl -X PATCH "https://api.min.tatnet.ru/v1/projects/{project_id}/apps/{id}" \
-H "Authorization: Bearer $TATNET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"vpc_id": "8a2fd6c4-ee02-4441-beb6-74e500aefbca"}'

Смена сети, как и в панели, пересоздаёт инстансы приложения — поле не применяется «тихо», одной записью в базу.

Задачи по расписанию​

На вкладке «Задачи» backend-приложения создайте задачу, задайте команду и cron-расписание из пяти полей: минута, час, день месяца, месяц, день недели. Время — UTC. Например, 0 0 * * * — каждый день в 00:00 UTC (03:00 по Москве). Пустое расписание оставляет только ручной запуск. Задачу можно запустить вручную кнопкой; история содержит статус и вывод каждого запуска. Например, вынесите в задачу периодическую обработку очереди или очистку временных данных. Команда должна безопасно переживать повторный запуск.

Команда перед деплоем​

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

Миграции проектируйте совместимыми с ещё работающей старой версией: ошибка деплоя не отменяет уже выполненные изменения в базе.

Смена Docker-образа​

У приложения, созданного из Docker-образа, замените образ в настройках или через CLI:

tatnet app update <приложение> --image registry.example.com/team/app:v2
tatnet app deploy <приложение>

Обновление поля сохраняет образ для следующего деплоя; команда app deploy запускает выкладку. Опция --image доступна только приложениям из образа: для приложений из Git или папки она отклоняется.

Проверьте статус новой выкладки и образ, который сейчас работает, в панели. Сохранение нового имени образа ещё не означает успешный деплой. Для воспроизводимости используйте отдельный тег версии или digest.