Оформление
Контейнерное развертывание нового автономного проекта FineBI
Контейнерное развертывание нового автономного проекта FineBI
1. Обзор
1.1 Версия
| Версия платформы для эксплуатации и технического обслуживания |
|---|
| V1.5.5 |
1.2 Функциональный профиль
Платформа Ops поддерживает развертывание и прямой доступ к новым приложениям FineReport, FineBI и FineDataLink.
В этой статье мы расскажем, как развернуть новый автономный проект FineBI в контейнере с помощью платформы Ops.
Примечание 1: Перед контейнерным развертыванием разверните платформу FineOps Ops. Шаги по установке см. в разделе: Развертывание платформы Ops.
Примечание 2: Эта статья предназначена для пользователей с недостаточными ресурсами сервера или большими ограничениями по портам, процедура более подробная и длительная.
Если вы можете подготовить новый сервер с достаточными ресурсами, вы можете обратиться к краткому руководству по развертыванию: Развертывание нового проекта Sailsoft
Примечание 3: В соответствии с привычками развертывания большинства пользователей, в этой статье весь автономный проект FineBI развертывается на одном сервере. Пользователи также могут подготовить дополнительный сервер компонентов для развертывания внешней библиотеки конфигурации MySQL и службы логирования ElasticSearch.
2. понимание роли компонентов проекта
Проект FineBI, развернутый платформой Ops, включает в себя не только инженерную часть, но и поддерживающие внешние библиотеки конфигурации, компоненты Ops и так далее.
В этом разделе подробно описана роль каждого компонента.
| сборки | Требуется или нет | инструкции |
|---|---|---|
| би6 | Должно быть развернуто | **Роль компонента:**компонент инженерного узла FineBI, который не несет никаких демонстрационных данных |
| ops_agent | Должно быть развернуто | **Роли компонентов:**для управления компонентами, обновления контейнеров и сбора различной метрической информации о физических серверах и компонентах. |
| nginx | Автономная опция | Роль компонента:* Предоставляет услуги переадресации нагрузки,точку входа для инженерных и других служб компонентов кластера. Инструкции по установке:* Поддержка установки автономного nginx, установка автономного nginx по умолчанию* Если вам нужно настроить SSL с помощью Ops Platform, рекомендуется установить* Если компонент nginx не установлен,внешний портал доступа меняется с порта nginx напорт компонента bi6. |
| elasticsearch | Автономная опция | *Роль компонента:Предоставляет сервис хранения журналов.Заменяет оригинальный swift (logdb) в продукте в качествехранилищалогов для запросов от проектов, внешних баз данных, бизнес-библиотек и других компонентов в проектах FineBI.Инструкции по установке: Если не развернуть, то для хранения журналов будет использоваться исходный swift (logdb) в приложении. Поддержка установки elasticsearch/подключения к внешнему self-provisioned elasticsearch версии 7.10 и выше Не приостанавливайте работу компонента после успешного развертывания/докинга , иначе журналы операций проекта FineBI будут потеряны! |
| filebeat | Установкас помощьюelasticsearch | **Роль компонента:**предоставление услуг сбора журналов и компонентов elasticsearch,поддерживающих |
| mysql | Должен быть установлен для поддержки самообеспечения | Роль компонента:* Используется для хранения и поддержанияконфигурационной информации и параметров длякаждого узла приложения, которые должны быть установлены соответствующим образом, чтобы узлы работали согласованно. Инструкции по установке:* Установите базу данных MySQL8 по умолчанию* Поддержка установки базы данных MySQL8/подключения к внешним базам данных, предоставляемым самостоятельно (MySQL5, MySQL8, RDSMySQL, Oracle)* Если вам нужно использовать другие типы баз данных в качестве библиотек конфигурации, вы можете войти в проект, чтобы переключиться после того, как проект FineBI будет успешно развернут. |
3. Подготовка сервера проекта
3.1 Подтверждение количества серверов
В этой статьевесьавтономныйпроектFineBIразвертывается на одном сервере в соответствии с привычками развертываниябольшинствапользователей.
Если ресурсов сервера достаточно, пользователи могут обратиться к рекомендуемой конфигурации для подготовки двух серверов, один из которых является сервером компонентов для развертывания внешней библиотеки конфигурации MySQL и службы регистрации ElasticSearch.
Пожалуйста, подготовьте IP-адрес интранета сервера, имя пользователя и пароль.
Примечание: платформа FineOps Ops и проект FineBI не развертываются на одном сервере.
Если FineOps и проект FineBI находятся в одной среде, то при сбоях в работе сервера проекта FineBI может выйти из строя и FineOps, не справившись с функцией эксплуатации и обслуживания.
| типология | запрос |
|---|---|
| Рекомендуемые конфигурации | Рекомендуется использовать 2 сервераНикакие другие приложения, проекты SoftSoft, платформы для эксплуатации и обслуживания не развернуты на этих двух серверах, чтобы обеспечить независимость проектов.* Проект занимает сервер исключительно в качестве основного сервера приложений* У остальных компонентов есть отдельный сервер - сервер компонентов (который не нужно готовить, если не установлены комплекты nginx, mysql и elasticsearch ). |
| минимальная конфигурация(Программа этой статьи) | Подготовьте как минимум 1 серверДля обеспечения независимости проекта на этом сервере не развертываются другие приложения, проекты Softsoft или платформы для эксплуатации и обслуживания.* Один сервер для всего проекта FineBI (в случае наличия только одного сервера все компоненты устанавливаются на этот сервер) |
3.2 Подтверждение конфигурации операционной системы
| настроить | отзывы | Поддержка/минимальные требования |
|---|---|---|
| Тип операционной системы | Linux | Linux |
| Архитектура операционной системы | X86_64 | X86_64 |
| ядро операционной системы | Версия 3.10 и выше | Версия 3.10 и выше |
| Программное обеспечение операционной системы | Ubuntu 22 версии | Ubuntu 18.04.4 и вышеВерсииCentOS 7.3~7.9redhat 7.6 и выше |
3.3 Подтверждение наличия ресурсов
Сервер, на котором развернут проект FineBI, должен удовлетворять условиям, указанным в таблице ниже:
Примечание: В этом разделе описаны только минимальные требования к конфигурации сервера, рекомендуемые конфигурации см. в разделе: Определение количества узлов FineBI
| Тип сервера | настроить | минимальное требование |
|---|---|---|
| главный сервер приложений | CPU | Минимум 8 ядер |
| Тип диска | XFS | |
| Оставшийся свободныйразмер диска | На сервере естьраздел, на котором осталось более****500 Гбсвободного места.Примечание: Вы можете использовать команду "df -h" для запроса дискового пространства, при этом должен быть любой раздел, удовлетворяющий условиям, нельзя суммировать объем разделов. | |
| Оставшаяся****свободнаяфизическая память | 32 Гб или более | |
| Сервер компонентов(в данном примере не используется) | ПРОЦЕССОР | Минимум 4 ядра |
| Тип диска | XFS | |
| Оставшийся свободныйразмер диска | Наличиевыделенная территория (под жилье, промышленность и т.д.)Оставшееся свободное пространствоБолее 50****GПримечание: Вы можете использовать команду "df -h" для запроса дискового пространства, при этом должен быть любой раздел, удовлетворяющий условиям, нельзя суммировать объем разделов. | |
| Оставшаяся****свободнаяфизическая память | 8 Гб или более |
Причина, по которой требуется конфигурация, указанная в таблице выше, заключается в том, что каждый компонент проекта FineBI имеет минимальные требования к конфигурации, как показано в таблице ниже:
| сборки | Ограничение использования процессора | Ограничение использования памяти | Конфигурация памяти xmx | диски |
|---|---|---|---|---|
| FineBI | 16Core | - | Память по умолчанию:Объем оперативной памяти машины после вычитания 10 гигабайт памятиМаксимум 32 Гб | 500G |
| ops_agent | 1Core | - | 1G | - |
| filebeat | 0.1Core | 0.1G | - | - |
| elasticsearch | 1Core | - | 2G | 50G |
| nginx | 1Core | - | - | - |
| mysql | 2Core | - | - | 50G |
3.4 Подтверждение занятости порта
В проекте FineBI много компонентов, и для их работы необходимо занять серверные порты.
Перед развертыванием убедитесь, что используемый по умолчанию маппинг-порт используется, а если он используется, то выделите другой свободный порт.
Примечание 1: Если вы готовите сервер компонентов, на нем будут установлены компоненты nginx, mysql, elasticsearch и ops_agent, пожалуйста, проверьте соответствующие порты.
Примечание 2: Если вы подготовите несколько серверов, каждый из них будет устанавливать ops_agent, пожалуйста, убедитесь, что порт ops_agent, подготовленный каждым сервером, одинаков, потому что только один может быть установлен.
| сборки | порт по умолчанию | Соответствует английским -ity, -ism, -ization |
|---|---|---|
| би6 | 8080 | Инженерные оккупированные порты |
| 12100 | Инструментальный порт для обработки простоев | |
| filebeat | - | Порт не занят |
| nginx | Размещение корневого пользователя: 80Развертывание для пользователей, не являющихся пользователями root: 8090 | Занятые порты компонентов |
| mysql | 3306 | Занятые порты компонентов |
| elasticsearch | 9200 | Занятые порты компонентов |
| ops_agent | 9070 | Занятые порты компонентов |
3.5 Подтверждение совместимости серверной сети
Для обеспечения нормального доступа пользователей к проектам FineBI, а также для того, чтобы платформа эксплуатации и обслуживания могла нормально развертывать и контролировать проекты FineBI.
Серверу необходимо открыть несколько портов для внешнего мира для различных сценариев.
Все занятые порты, описанные в разделе 3.4, являются совместимыми.
Примечание: Если вы подготовили внешнюю библиотеку конфигурации, сервер, на котором находится внешняя библиотека конфигурации, должен быть совместим с интранет-сервером проекта FineBI.
2) Проект "Экстранет и FineBI
| Соответствует английским -ity, -ism, -ization | Экстранет | гуаньси | Платформа для эксплуатации и технического обслуживания |
|---|---|---|---|
| Доступ администратора к платформе эксплуатации и обслуживания | операторЛюбой IP | Access-> | 1) Если настроен SSL: 4432) Если развернут компонент nginx, а SSL не настроен:Корневое развертывание: 80Развертывание без рута: 80903) Если компонент nginx не развернут и SSL не настроен:8080 |
| Считывание/заполнение данных | Оперативная база данных | <-visit-> | 1) Если настроен SSL: 4432) Если развернут компонент nginx, а SSL не настроен:Корневое развертывание: 80Развертывание без рута: 80903) Если компонент nginx не развернут и SSL не настроен:8080 |
| Платформа Ops использует зеркала облачных хранилищ | Репозиторий образов Flexsoft Cloudfineops-registry.cn-hangzhou.cr.aliyuncs.com:443 | <Доступ | реестр5000 |
3) Платформа для эксплуатации и технического обслуживания и проект FineBI
| Соответствует английским -ity, -ism, -ization | Платформа для эксплуатации и технического обслуживания | Проект FineBI | |
|---|---|---|---|
| базовая эксплуатация и техническое обслуживание (BOM) | Балансировка нагрузки Nginx для операционной платформы Корневое развертывание: 80 Некорневое развертывание: 8090 Настроенный SSL: 443 | <Доступ | Каждый узел проекта8080 |
| отслеживание соединений | skywalking_oap для OPM (11800, 12800) | <Доступ | Каждыйузелпроекта8080 |
| Передача информации о сервере и метриках компонентов проекта FineBI на платформы Ops | Балансировка нагрузки Nginx для операционных платформКорневое развертывание: 80Развертывание без рута: 8090Настроенный SSL: 443 | <Доступ | oops-agent (инженерный узел + узел компонента кластера, любой сервер)9070 |
| Извлекайте компоненты из хранилища образов платформы Ops для развертывания, обновления и восстановления проектов FineBI. | реестр5000 | <Доступ | Инженерный узел + компонентный узел кластера, любой сервер |
3.6 Подготовка смонтированного каталога
Каталог монтирования проекта - способ связать необходимые файлы проекта на хосте с файлами в контейнере. Он используется для реализации таких функций, как сохранение данных и быстрый просмотр файлов.
В проекте FineBI, развернутом на платформе эксплуатации и технического обслуживания, все важные файлы монтируются извне. Пожалуйста, заранее создайте новый каталог монтирования на свободном диске сервера.
Примечание: Если вы подготовили основной сервер приложений и сервер компонентов, создайте новые каталоги монтирования на свободном диске каждого сервера.
1) Проверьте дисковое пространство на сервере
Команда: df -h, найти точку монтирования с большим количеством свободного места
Например, в этом примере наиболее подходящим каталогом для монтирования сервера является каталог /home под именем
2) Новая папка
Используйте команду mkdir для создания папки (в этом примере создается папка fanruan в каталоге /home): mkdir /home/fanruan
Используйте команду chmod, чтобы установить права доступа к папке (в данном примере права 777 предоставлены напрямую): chmod 777 /home/fanruan
3) Краткое описание содержимого плагина
Когда проект FineBI будет успешно развернут, в папке /mount directory/fanruanxxx/ будет содержаться содержимое плагинов каждого компонента проекта.
Только содержимое этих плагинов будет постоянным и не приведет к потере файлов при обновлении/перезагрузке контейнера.
Не создавайте новые папки в папке /mount directory/fanruanxxx/bi6, они будут потеряны из-за неперсистентности.
Если вам нужно загрузить ресурсы, вы можете загрузить их во вложенные папки, но рекомендуется в приоритетном порядке загружать их в папку /mount directory/fanruanxxx/bi6/help.
| файл (бумажный) | Соответствует пути в контейнере | инструкции |
|---|---|---|
| bi-data | /usr/local/tomcat/webapps/webroot/bi-data | Данные извлечения FineBI |
| классы | /usr/local/tomcat/webapps/webroot/WEB-INF/classes | Файлы классов по умолчанию и пользовательские файлы для вызовов проекта |
| конфигурация | /usr/local/tomcat/webapps/webroot/WEB-INF/config | Связанные с библиотекой конфигурации (finedb) файлы для вызовов платформы |
| customlib | /usr/local/tomcat/webapps/webroot/WEB-INF/customlib | Настройка проекта/внешние JAR-пакеты |
| dpworks | /usr/local/tomcat/webapps/webroot/WEB-INF/dpworks | Файлы конфигурации, связанные с задачами FineDataLink (если папка не существует, это означает, что проект не использует функции, связанные с FDL) |
| местный | /usr/local/tomcat/webapps/webroot/WEB-INF/local | Хранит скомпилированные файлы для нового движка |
| журналы | /usr/local/tomcat/webapps/webroot/logs | журналы swift (например, logdb) |
| гора | /usr/local/tomcat/mount | Сохраняет файл setenv.sh, который используется для установки переменных окружения проекта и параметров запуска |
| плагины | /usr/local/tomcat/webapps/webroot/WEB-INF/plugins | Документы, связанные с плагинами |
| tomcat_logs | /usr/local/tomcat/logs | Общий журнал Tomcat |
| помощь | /usr/local/tomcat/webapps/webroot/help | Проект должен вызывать некоторые css, js, html, изображения и другие ресурсы.Для хранения пользовательских файлов |
| активы | /usr/local/tomcat/webapps/webroot/WEB-INF/assets | temp_attach: хранит информацию о необработанном файле Excel проекта vcs: файл резервной копии шаблона FineReport. drivers: драйверы, загруженные в систему управления драйверами, будут автоматически синхронизированы впапку WEB-INF/driversпроекта. Другие файлы: общий разделяемый каталог постоянства |
| резервное копирование | /usr/local/tomcat/webapps/webroot/backup | Резервный файл истории проекта |
| репортажи | /usr/local/tomcat/webapps/webroot/WEB-INF/reportlets | Каталог хранения шаблонов FineReport |
| ресурсы | /usr/local/tomcat/webapps/webroot/WEB-INF/resources | Хранит файлы конфигурации ресурсов, связанных с проектом |
| расписание | /usr/local/tomcat/webapps/webroot/WEB-INF/schedule | Планирование созданных документов по времени |
| сокровища | /usr/local/tomcat/webapps/webroot/WEB-INF/treasures | Пакеты, генерируемые Cloud Ops |
4. Подтверждение зеркальных репозиториев
Развертывание компонентов в проекте FineBI осуществляется через зеркала. Либо зеркальный репозиторий уже имеет зеркала, либо он поддерживает получение зеркал из облака.
Шаг 1: Убедитесь, что хранилище уже зеркалировано
В зависимости от типа загруженного finekey, зеркальная версия в зеркальном репозитории платформы Ops будет разной.
Администратор входит в платформу эксплуатации и обслуживания и нажимает "Центр обслуживания > Управление образами", чтобы просмотреть образы компонентов и их версии, хранящиеся в текущем хранилище образов.
1) Убедитесь в наличии зеркального отображения компонентов, требуемых в Главе II.
2) Убедитесь, что зеркальная версия соответствует вашим требованиям к развертыванию.
Если оба эти требования выполнены, подтверждение можно завершить; если ни одно из них не выполнено, продолжите шаги по подтверждению, описанные ниже.
Шаг 2: Убедитесь, что зеркальный репозиторий поддерживает подключение к облачному хранилищу
(1) Администратор входит в платформу O&M и нажимает "Maintenance Centre > Mirror Management > Configuration", чтобы просмотреть адрес зеркального хранилища платформы O&M.
(2) Убедитесь, что адрес зеркального репозитория поддерживает доступ к следующему адресу экстрасети, и вы сможете автоматически извлекать последние зеркала компонентов из облачного репозитория SailSoft при развертывании проектов FineBI.
| функциональность | веб-адрес |
|---|---|
| Получение зеркалаОбновленная платформа для эксплуатации и технического обслуживанияОбновление компонентов проекта FineBI | Доменное имя: fineops-registry.cn-hangzhou.cr.aliyuncs.comПорт: 443 |
| Получение обновлений | Выберите один из четырех, но только тот, который соединяет:https://cloud.fanruan.com/config https://cloud.fanruan.com:8443/config http://cloud.fanruan.com/config http://cloud.fanruan.com:8090/config |
5. развертывание нового автономного проекта FineBI
В этом разделе официально начинается операция развертывания автономного проекта FineBI. Пожалуйста, убедитесь, что вы подтвердили все вышеперечисленное перед началом развертывания, иначе развертывание может закончиться неудачей!
5.1 Новые проекты
Администратор входит в платформу FineOps Ops и нажимает кнопку "Развернуть новый проект".
5.2 Настройки проекта
Настройки проекта - это настройка типа проекта, устанавливаемых компонентов, занятых портов и другой информации.
Войдите в интерфейс "Настройки проекта", введите соответствующую информацию о проекте и нажмите "Далее", как показано ниже:
Каждый элемент конфигурации представлен в следующей таблице:
| информация | инструкции |
|---|---|
| Название проекта | Настройте название проектаИмя проекта не должно быть пустымНазвание проектаподдерживаеттолькокитайский,английский регистр, цифрыМаксимальная длина названия проекта - 12 цифрИмена проектов не разрешается переименовывать с существующими проектами |
| Тип приложения | Выберите "FineBI". |
| Количество прикладных сервисов | Выберите "Приложение 1BI |
| путь доступа | Ссылка доступа для приложения - {домен/IP}/{путь доступа}/decisionПоддерживает определяемый пользователем путь доступа к приложению, по умолчанию путь доступа - webrootТребует внимания:Если вам нужно настроить короткое доменное имя/IP для доступа к проекту, убедитесь, что путь доступа пуст, и его нельзя изменить после успешного развертывания проекта.В этот момент корневой каталог, соответствующий проекту, доступен по следующему пути: http://IP:端口/root.Дополнительные сведения см. в разделе: Доступ к проектам по IP/доменным именам |
| Пользовательские компоненты развертывания | Опциональная установка компонентов, поддержка неразвертывания / развертывания подготовленных sailsoft компонентов / стыковка подготовленных пользователем компонентовЗдесь не указаны компоненты, которые необходимо установить.Роли различных компонентов описаны в главе 2.Требует внимания: |
5.3 Конфигурация узла
После настройки необходимых компонентов и портов можно перейти к разделу "Конфигурация узла". Вам нужно добавить новый узел главного приложения, то есть добавить информацию, связанную с главным сервером приложений.
1) Нажмите "Добавить узел", выберите тип узла как "Главное приложение", заполните соответствующие настройки и нажмите "Проверить соединение".
Конкретные настройки узла показаны ниже:
| Настройка узла | инструкции |
|---|---|
| Тип узла | Пожалуйста, выберите " Основное приложениеПримечание: Проект FineBI требует эксклюзивного сервера, т.е. не рекомендуется развертывать другие проекты или контент, включая платформу O&M, на этом главном сервере приложений. |
| хозяева | Введите IP-адрес узла (IP-адрес интрасети).Примечание: Хосты не поддерживаются для добавления более одного раза в один и тот же проект. |
| порты | Введите номер порта узла, по умолчанию - 22 |
| идентификатор пользователя | Введите имя пользователя сервера с привилегиями sudo |
| Методы валидации | Два типа поддержки: пароль, открытый ключ |
| Горная тропа | Укажите путь к серверу, где находится каталог установки узла, т.е. каталог, указанный в разделе 2.6.По умолчанию это ~/data, причем ~ представляет собой домашний каталог пользователя сервера.Примечание: Вы можете получить доступ к серверу, используя эту учетную запись пользователя в терминале, и ввести команду echo $HOME, чтобы увидеть путь к домашнему каталогу пользователя. |
| IP-адрес экстранета | необязательное полеЕсли сервер не поддерживает доступ к интрасети и поддерживает только сопоставление с экстранет, пожалуйста, укажите IP-адрес экстранета, к которому можно подключиться. |
2) Предварительный просмотр эффектов
Если имя пользователя узла и другая информация успешно проверены, вы можете добавить главный узел приложения. Как показано на следующем рисунке:
Примечание 1: Если сетевое окружение не соответствует требованиям сеанса предварительной подготовки и соединение узла не удается, появляется предупреждение об ошибке, и узел не может быть добавлен правильно.
Примечание 2: Если конфигурация сервера не соответствует минимальным требованиям для подготовительной сессии, появится предупреждение об ошибке, и узел не будет добавлен корректно.
5.4 Список развертывания
После завершения настройки узла нажмите "Далее", чтобы открыть окно подтверждения "Список развертывания".
На этом экране пользователи могут определить компоненты, которые будут развернуты на каждом сервере.
Пользователи могут настроить порт, имя пользователя и пароль для каждого компонента, как показано ниже:
Требует внимания:
1) Обязательно измените и запомните пароли для компонентов mysql и elasticsearch, которые имеют случайно сгенерированные пароли по умолчанию.
(2) Если вы забыли имя пользователя и пароль соответствующих компонентов, вы можете получить их, экспортировав информацию о развертывании, подробнее см. в разделе: Экспорт информации о развертывании проекта.
5.5 Начало развертывания
После завершения настройки нажмите "Начать развертывание", чтобы начать процесс развертывания.
Во всплывающем окне отображается прогресс извлечения образа, а также статус развертывания каждого компонента, а в случае неудачи развертывания - причина неудачи.
Примечание 1: Во время процесса развертывания пользователи могут нажать кнопку "Скрыть в фон", чтобы нормально выполнять другие операции на платформе O&M.
Примечание 2: Во время процесса развертывания можно нажать кнопку "Abort Deployment", чтобы остановить развертывание и откатить все существующие операции развертывания.
5.6 Предварительный просмотр
Новые проекты, успешно развернутые с помощью платформы O&M, автоматически попадают в список управления проектами платформы O&M, и можно выполнять соответствующие операции O&M.
Адрес доступа - это адрес проекта FineBI. Щелкните по нему, чтобы открыть адрес в новом окне браузера и войти в окно конфигурации инициализации проекта.
