#Мульти-приложение

#Введение

Плагин Мульти-приложение (Multi-app) позволяет динамически создавать и управлять несколькими независимыми приложениями без необходимости отдельного развертывания. Каждое дочернее приложение является полностью независимым экземпляром со своей собственной базой данных, плагинами и конфигурациями.

#Сценарии использования

• Мультитенантность: предоставление независимых экземпляров приложений, где у каждого клиента есть свои данные, конфигурации плагинов и системы прав доступа.
• Основные и дочерние системы для различных бизнес-доменов: крупная система, состоящая из нескольких независимо развернутых небольших приложений.

#Установка

Найдите плагин Мульти-приложение (Multi-app) в менеджере плагинов и включите его.

#Руководство пользователя

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

В меню настроек системы выберите «Мульти-приложение», чтобы перейти на страницу управления:

Нажмите кнопку «Добавить», чтобы создать новое дочернее приложение:

#Описание полей формы

• Имя: идентификатор дочернего приложения, глобально уникальный.
• Отображаемое имя: название дочернего приложения, отображаемое в интерфейсе.
• Способ запуска:
  • Запуск при первом доступе: дочернее приложение запускается только тогда, когда пользователь впервые обращается к нему через URL.
  • Запуск вместе с основным приложением: дочернее приложение запускается одновременно с основным (это увеличивает время запуска основного приложения).
• Порт: номер порта, используемый дочерним приложением во время работы.
• Пользовательский домен: настройка независимого поддомена для дочернего приложения.
• Закрепить в меню: закрепляет вход в дочернее приложение в левой части верхней панели навигации.
• Подключение к базе данных: используется для настройки источника данных дочернего приложения, поддерживает три метода:
  • Новая база данных: повторно использует текущий сервис данных для создания независимой базы данных.
  • Новое подключение к данным: настройка совершенно нового сервиса базы данных.
  • Режим схемы (Schema): создает независимую схему в PostgreSQL для дочернего приложения.
• Обновление: если подключенная база данных содержит структуру данных NocoBase старой версии, она будет автоматически обновлена до текущей версии.

#Запуск и остановка дочерних приложений

Нажмите кнопку Запустить, чтобы запустить дочернее приложение.

Если при создании был выбран пункт «Запуск при первом доступе», приложение запустится автоматически при первом посещении.

Нажмите кнопку Просмотр, чтобы открыть дочернее приложение в новой вкладке.

#Статус и логи дочернего приложения

В списке можно просмотреть объем оперативной памяти и ресурсов процессора, используемых каждым приложением.

Нажмите кнопку Логи, чтобы просмотреть логи работы дочернего приложения.

Если дочернее приложение недоступно после запуска (например, из-за повреждения базы данных), вы можете выявить причину с помощью логов.

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

Нажмите кнопку Удалить, чтобы удалить дочернее приложение.

При удалении можно выбрать, следует ли также удалить базу данных. Пожалуйста, действуйте осторожно, так как это действие необратимо.

#Доступ к дочерним приложениям

По умолчанию для доступа к дочерним приложениям используется путь /_app/:appName/admin/, например:

http://localhost:13000/_app/a_7zkxoarusnx/admin/

Также вы можете настроить независимые поддомены для дочерних приложений. Вам необходимо направить домен на текущий IP-адрес. Если используется Nginx, домен также должен быть добавлен в конфигурацию Nginx.

#Управление дочерними приложениями через CLI

В корневом каталоге проекта вы можете использовать командную строку для управления экземплярами дочерних приложений через PM2:

yarn nocobase pm2 list              # Просмотр списка запущенных экземпляров
yarn nocobase pm2 stop [appname]    # Остановка процесса конкретного дочернего приложения
yarn nocobase pm2 delete [appname]  # Удаление процесса конкретного дочернего приложения
yarn nocobase pm2 kill              # Принудительное завершение всех запущенных процессов (может включать экземпляр основного приложения)

#Миграция данных из старой версии Мульти-приложения

Перейдите на страницу управления старой версией мульти-приложения и нажмите кнопку Мигрировать данные в новое Мульти-приложение, чтобы выполнить миграцию.

#Часто задаваемые вопросы (FAQ)

#1. Управление плагинами

Дочерние приложения могут использовать те же плагины, что и основное приложение (включая версии), но плагины можно настраивать и использовать независимо.

#2. Изоляция базы данных

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

#3. Резервное копирование и миграция данных

В настоящее время резервное копирование данных в основном приложении не включает данные дочерних приложений (оно содержит только базовую информацию о них). Резервное копирование и миграцию необходимо выполнять вручную внутри каждого дочернего приложения.

#4. Развертывание и обновление

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

#5. Управление ресурсами

Потребление ресурсов каждым дочерним приложением в целом такое же, как и у основного приложения. В настоящее время использование оперативной памяти одним приложением составляет около 500-600 МБ.