nodbox
Разделы документации

Основные понятия

Проект, приложение, версия, размер, экземпляр: что означают слова, которыми платформа называет свои части.

Пять слов описывают всё, что запущено на платформе: проект, приложение, версия, размер и экземпляр. Части вложены друг в друга: в проекте живут приложения, а у приложения есть версии, размер и экземпляры.

Как части связаны

  • Проект - рабочее пространство: приложения, базы и баланс
    • Приложение - то, что платформа запускает из твоего кода и держит в работе
      • Версия - результат одного деплоя: код, переменные и размер
      • Размер - сколько процессора и памяти получает приложение
      • Экземпляр - одна запущенная копия приложения
    • База данных - управляемая база рядом с приложением

Проект

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

Лимиты проекта:

  • приложений до 10
  • экземпляров до 12 на все приложения вместе
  • процессора до 6 ядер
  • памяти до 6 ГБ

Баланс принадлежит проекту, платит за него владелец. Участников приглашают на тарифе Команда, ролей три: владелец, разработчик и наблюдатель. Подробности - в разделе Команда и роли, все цифры - в разделе Лимиты и квоты.

Приложение

Приложение - то, что платформа запускает из твоего кода и держит в работе. Код берётся из репозитория GitHub, GitLab или Bitbucket, из zip-архива с папкой проекта или из готового образа. Dockerfile писать не нужно: платформа сама определяет язык, зависимости и команду запуска.

Приложения бывают двух видов:

  • Веб-приложение отвечает на запросы по HTTPS и получает адрес на домене платформы
  • Воркер - фоновый обработчик без адреса: он работает постоянно, а не только по запросу

Чем они отличаются, разбирает страница Веб-приложения и воркеры, откуда берётся код - страница Источники кода.

Версия и деплой

Деплой - действие, которым платформа собирает код и запускает его. Каждый деплой создаёт версию. Версия хранит то, что запущено: код, переменные и размер. У неё есть статус, длительность и, если не вышло, причина отказа.

Деплой запускается тремя способами: из панели, фразой агенту или push в выбранную ветку. Сборка идёт до 16 минут, весь деплой - до 48. Работающая версия отвечает, пока собирается новая, а упавшая сборка её не трогает. Идущий деплой можно отменить.

Откат возвращает то, что работало: тот же код, переменные и размер. Доступны три последние выкаченные версии. Подробности - в разделе Версии и откат.

Размер

Размер - сколько процессора и памяти получает приложение. Размеров шесть: Eco и High, у каждого по 256 МБ, 512 МБ или 1 ГБ памяти. Цена названа за месяц круглосуточной работы и начинается от 190 ₽.

Eco и High отличаются гарантией: в Eco процессор делится с соседями, в High закреплён за приложением. Размер можно сменить в любой момент: приложение переедет за один деплой, пересоздавать его не нужно. Все размеры и цены - в разделе Размеры приложения.

Экземпляр

Экземпляр - одна запущенная копия приложения. По умолчанию он один. Под нагрузкой платформа добавляет новые: следующий появляется, когда одновременных запросов на один экземпляр больше 100. Порог настраивается до 1 000, а потолок экземпляров на приложение - до десяти. Цена названа за размер приложения, подробности - в разделе Тарификация.

Спящее приложение занимает лимиты проекта: ему нужно место, чтобы проснуться, поэтому оно сохраняется и во сне. Денег сон не стоит. Подробности - в разделах Автомасштабирование и Сон и пробуждение.

Остальные слова

Слово Что это
Состояние Что происходит с приложением сейчас: работает, спит, деплой, упало или остановлено. Платформа проверяет его сама раз в минуту. Подробности - Состояния приложения
База данных Управляемая PostgreSQL, MySQL или Valkey (совместим с Redis) во внутренней сети проекта. Строку подключения база отдаёт сама, а в приложение её кладёшь ты, секретом под своим именем. Подробности - Подключение к базе
Переменные и секреты Настройки приложения, которые подставляются при запуске. Значение секрета после сохранения не показывается ни в панели, ни по API. Подробности - Переменные и секреты
Адрес Адрес приложения на домене платформы, HTTPS на нём уже работает. Свой домен привязывается отдельно. Подробности - Адрес и HTTPS
Токен Ключ доступа для агента или CI с четырьмя правами: читать, деплоить, менять мощность и удалять. Живёт 60 суток. Подробности - Токены и права
Баланс Деньги проекта в рублях: с него по минутам списывается плата за приложения и базы. Пополнить можно от 100 ₽. Подробности - Тарификация

Что дальше

Страница в markdown, так её читает агент: /docs/start/concepts.md