Приложения

Приложение объединяет ресурсы одного приложения: контейнеры и Deployments, проекты Compose, базы данных, хранилища, маршруты и проекты Pages. У каждого приложения есть окружения, например production и staging, и каждый ресурс приложения относится к одному окружению. Страница приложения показывает состояние, мониторинг, оповещения и активность всех этих ресурсов вместе и даёт одно место, чтобы запускать, останавливать и продвигать всё приложение.

Приложения доступны на всех тарифах, включая Community. Откройте Apps в боковой панели, сразу под Dashboard.

Создание приложения

1. Откройте Apps и выберите New App.
2. Введите имя. Оно отображается в Apps и в поиске.
3. Приложение создаётся с одним окружением, production, с пометкой Production.

Добавляйте окружения через New → Environment на странице приложения или в блоке Environments на вкладке Settings приложения. Пустое окружение пока ничего не может: откройте его страницу, разрешите там хотя бы одну ноду через Allow node, затем создайте в нём ресурсы или импортируйте существующие. См. Окружения.

Ровно одно окружение является Production. Индикатор состояния приложения следует за ним, и окружение Production нельзя удалить. Mark as Production на другом окружении переносит эту пометку.

Добавление ресурсов

На странице приложения New создаёт контейнер, Deployment, проект Compose, базу данных, хранилище, маршрут, проект Pages или связь контейнеров сразу в окружении. В диалоге создания приложение уже выбрано, окружение можно выбрать, а предлагаются только ноды, которые это окружение разрешает. Если окружение не разрешает ни одной ноды нужного типа, диалог сообщает об этом и ведёт к Allow a node.

Чтобы добавить существующие ресурсы, используйте Import existing в разделе нужного типа ресурсов на вкладках приложения. Можно выбрать несколько ресурсов сразу. Ресурс, ноду которого целевое окружение не разрешает, показывается неактивным с надписью Allow <node> in <environment> first. В обычном списке пункт меню строки Move to app… делает то же самое для одного ресурса.

Чтобы перенести ресурс в другое окружение, используйте Move to Environment в меню его строки на странице приложения. Чтобы вывести ресурс из приложения, выберите No app в Move to app…. Во всех случаях ресурс продолжает работать; меняется только группировка.

Связи контейнеров и связи баз данных или хранилищ не имеют собственного окружения: они относятся к окружению рабочей нагрузки, которая их использует, и перечислены на вкладке Network приложения.

Где отображаются ресурсы приложения

Ресурсы приложения не показываются в обычных списках Docker, Routes, Databases, Storage и Pages, в их деревьях папок и в их счётчиках. В этих списках остаётся только то, что находится вне приложений. Ресурс приложения по-прежнему доступен:

• на странице приложения;
• через глобальный поиск, который находит его и помечает как in <app> · <environment>;
• на его собственной странице, которая остаётся доступной по URL и показывает в заголовке Part of <app> · <environment>;
• на странице ноды, которая по-прежнему перечисляет всё, что работает на ноде, с пометкой приложения.

Dashboard и счётчики нод по-прежнему учитывают ресурсы приложений. Списочные методы REST API и MCP тоже возвращают их, с полем app и фильтром, который исключает участников приложений.

Страница приложения

В заголовке страницы приложения показаны состояние приложения, число окружений и ресурсов, Refresh и New. Вкладки:

Вкладка	Что показывает
Overview	Панель для каждого окружения с его состоянием, открытыми оповещениями и плитками контейнеров, баз данных, хранилищ, маршрутов, Pages и нод за последний час или 24 часа
Compute	Контейнеры, Deployments и проекты Compose, сгруппированные по окружениям
Data	Базы данных и хранилища, сгруппированные по окружениям
Network	Маршруты, проекты Pages и связи контейнеров, баз данных и хранилищ
Nodes	Ноды, которые может использовать каждое окружение
Activity	Записи аудита приложения и его ресурсов, сначала новые
Settings	Имя, режим обслуживания для всего приложения, окружения и опасная зона

Строки на вкладках Compute, Data и Network имеют те же столбцы и действия, что и обычные списки.

Overview создаёт оповещения, если контейнер перезапустился 3 или более раз за час, диск базы данных или хранилища заполнен на 85% или больше, у маршрута 2% или больше ошибок сервера за 15 минут, или ресурс перешёл в офлайн. Каждое оповещение ведёт к ресурсу.

Activity начинается с момента, когда ресурс добавлен в приложение; более ранняя история остаётся в собственных записях аудита ресурса. Вы видите записи тех ресурсов, которые вам разрешено просматривать.

Состояние

Окружение находится в состоянии Failing, если сбоит любой из его ресурсов, Degraded, если любой из них деградировал, и Healthy в остальных случаях; пустое окружение считается исправным. Маршруты в режиме обслуживания и отключённые маршруты не учитываются. Состояние приложения — это состояние его окружения Production, если приложение не остановлено и не изолировано: тогда индикатор показывает это. База данных или хранилище, работающие на нескольких серверах, считаются деградировавшими, пока не могут выполнить переключение при отказе.

Права доступа

Доступ к приложению выдаётся на приложение или на одно из его окружений. В Administration добавьте строку доступа In an app environment и выберите <app> · every environment или <app> · <environment>. Роли в этой строке:

Роль	Что может
Viewer	Видеть приложение, его окружения и их ресурсы
Deployer	То же, что Viewer, плюс продвижение в окружение
Developer	То же, что Deployer, плюс управление окружением: переменные, секреты, разрешённые ноды, режим обслуживания, перенос ресурсов в окружение и из него
Operator	То же, что Developer, плюс остановка, запуск и изоляция

Строка для every environment распространяется и на окружения, добавленные позже. За ней стоят скоупы apps:view, apps:create, apps:edit, apps:delete, apps:env:manage, apps:promote и apps:operate; см. Справочник скоупов. Для действий с самим ресурсом, например перезапуска контейнера, по-прежнему нужна собственный скоуп этого ресурса.

Кто видит приложение

• Со скоупом apps:view на приложение пользователь видит приложение целиком: все окружения, Overview и Activity, включая записи о самом приложении и его окружениях. Для ресурсов по-прежнему нужны их собственные скоупы просмотра: списки, счётчики и записи активности охватывают только те ресурсы, которые пользователю разрешено просматривать. apps:view на одно окружение показывает это окружение полностью.
• Без apps:view приложение видит любой, кто может видеть один из его ресурсов (контейнер, развёртывание, проект Compose, базу данных, хранилище, маршрут или проект Pages) по собственным правам, в том числе по праву на сам ресурс, на папку его окружения или на папку приложения. Тогда в боковой панели появляется Apps. Пользователь видит только окружения, в которых есть такие ресурсы, и внутри них только эти ресурсы. Состояние, счётчики, Overview, Activity и элементы инцидентов считаются только по этим ресурсам; Activity не показывает записи о самом приложении и его окружениях.

Видимость приложения через ресурсы не даёт других прав. Для разрешённых нод, режима обслуживания, переменных и секретов, продвижения, остановки и изоляции по-прежнему нужны скоупы приложения. Такой пользователь не видит вкладку Nodes, а у окружения, видимого только через ресурсы, нет собственной страницы.

Удаление приложения

Delete App в опасной зоне вкладки Settings удаляет приложение. Его ресурсы продолжают работать и выходят из приложения; они снова появляются в обычных списках. Переменные, секреты и разрешённые ноды окружений удаляются, а доступ, выданный на приложение и его окружения, отзывается. Удаление одного окружения работает так же для этого окружения. Ни то, ни другое невозможно, пока приложение или это окружение остановлено или изолировано.

API и MCP

Всё, что описано на этих страницах, доступно и через REST API в /api/apps, и через MCP: list_apps, get_app, manage_app, manage_app_environment, manage_app_variables, manage_app_members, get_app_overview, get_app_activity, manage_app_incident и promote_app_environment. Чтобы создать ресурс внутри окружения через API или MCP, передайте folderId, который get_app возвращает для этого типа ресурса. list_apps и get_app возвращают access для приложения и для каждого окружения: full при наличии apps:view и members, если оно видно только через свои ресурсы.

Следующие шаги

• Окружения: переменные, секреты, ноды, режим обслуживания и продвижение
• Остановка, запуск и изоляция приложения