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

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

Раздел: Начало работы
Источник: https://nodbox.ru/docs/start/concepts/

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

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

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

## Проект

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

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

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

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

## Приложение

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

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

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

Чем они отличаются, разбирает страница [Веб-приложения и воркеры](/docs/apps/types/), откуда берётся код - страница [Источники кода](/docs/deploy/sources/).

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

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

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

Откат возвращает то, что работало: тот же код, переменные и размер. Доступны три последние выкаченные версии. Подробности - в разделе [Версии и откат](/docs/deploy/versions/).

## Размер

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

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

## Экземпляр

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

Спящее приложение занимает лимиты проекта: ему нужно место, чтобы проснуться, поэтому оно сохраняется и во сне. Денег сон не стоит. Подробности - в разделах [Автомасштабирование](/docs/apps/scaling/) и [Сон и пробуждение](/docs/apps/sleep/).

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

| Слово | Что это |
| --- | --- |
| Состояние | Что происходит с приложением сейчас: работает, спит, деплой, упало или остановлено. Платформа проверяет его сама раз в минуту. Подробности - [Состояния приложения](/docs/observability/states/) |
| База данных | Управляемая PostgreSQL, MySQL или Valkey (совместим с Redis) во внутренней сети проекта. Строку подключения база отдаёт сама, а в приложение её кладёшь ты, секретом под своим именем. Подробности - [Подключение к базе](/docs/databases/connect/) |
| Переменные и секреты | Настройки приложения, которые подставляются при запуске. Значение секрета после сохранения не показывается ни в панели, ни по API. Подробности - [Переменные и секреты](/docs/apps/env/) |
| Адрес | Адрес приложения на домене платформы, HTTPS на нём уже работает. Свой домен привязывается отдельно. Подробности - [Адрес и HTTPS](/docs/domains/address/) |
| Токен | Ключ доступа для агента или CI с четырьмя правами: читать, деплоить, менять мощность и удалять. Живёт 60 суток. Подробности - [Токены и права](/docs/automation/tokens/) |
| Баланс | Деньги проекта в рублях: с него по минутам списывается плата за приложения и базы. Пополнить можно от 100 ₽. Подробности - [Тарификация](/docs/project/billing/) |

## Что дальше

- [Быстрый старт](/docs/start/quickstart/) - первый деплой из панели или фразой агенту
- [Источники кода](/docs/deploy/sources/) - репозиторий, архив и образ
- [Размеры приложения](/docs/apps/sizes/) - процессор, память и цены
- [Версии и откат](/docs/deploy/versions/) - как вернуть прежнюю версию
- [Лимиты и квоты](/docs/project/limits/) - сколько чего можно держать в проекте