# Обучающая встреча по установке Ainergy # Ainergy: обучающая встреча Поставка Ainergy 1.4.2. Рабочие заметки Запись встречи Артефакты знаний и установка платформы с нуля в онлайне > Версия поставки: Ainergy 1.4.2 · Формат: онлайн-демонстрация на ресурсах ведущего --- ## Программа встречи # Блок Что будет 1 Артефакты знаний Какие есть источники знаний, для чего нужен каждый и как ими пользоваться: документация, инструкции, курсы, база знаний и ошибок. 2 Установка в прямом эфире Получаем дистрибутив, разворачиваем машины, выдаём DNS-имена и ставим платформу по шагам инструкции. ### Что нужно от участников Смотреть Записывать Критиковать Спрашивать Следить за ходом установки Фиксировать шаги, неочевидные моменты и места, где легко ошибиться Указывать, где инструкция неточна, неполна или устарела Задавать вопросы сразу, как только они появляются --- ## Карта артефактов Артефакт Где Когда открывать Документация платформы docs.ainergy.ru Нужно понять, как устроена или работает функция платформы Документация AINIMA docs.ainergy.ru/ainima Нужно настроить нексусы, лицензии, потребителей или интеграцию по API Инструкция по установке maintenance.pdf в составе поставки Устанавливаете или обновляете Ainergy On-Premise Курсы edu.ainergy.ru Нужно системно изучить продукт под свою роль --- ## 1. Документация ### Документация платформы: docs.ainergy.ru Основной справочник по Ainergy, платформе ИИ для автоматизации бизнес-процессов на базе SimpleOne. Сайт рассчитан на пользователей, администраторов, интеграторов и разработчиков. Разделы: «Начало работы», API, виджеты, администрирование, сервисные инструменты (векторная база и коллекции) и техническая документация по установке и эксплуатации. Если вопрос звучит как «как это работает» или «как это настроить», начинайте поиск отсюда. ### Документация AINIMA: docs.ainergy.ru/ainima AINIMA (Ainergy Installation Managing Application) — инструмент администратора. В нём создают и настраивают нексусы, маршрутизацию и функции, а готовые пакеты доставляют клиентам через обновления лицензий. Документация описывает весь цикл: настройку инфраструктуры, нексусы, лицензии и потребителей, потребительское API и историю изменений. Первые разделы адресованы администраторам установки, раздел API — разработчикам на стороне потребителя. --- ## 2. Инструкция по установке Ainergy Maintenance Documentation 1.4.2 (maintenance.pdf) — пошаговое руководство по установке Ainergy On-Premise с нуля и по обновлению уже развёрнутой платформы. Руководство покрывает все компоненты поставки: Control Plane, Middleware, SimpleOne, MAI и AIN. В нём описаны требования к машинам, нужные DNS-записи, сетевые доступы и точные команды каждого шага. Инструкция приезжает внутри поставки, поэтому всегда соответствует той версии, которую вы ставите. ### Как получить дистрибутив Дистрибутив запрашивается заявкой на портале поддержки. Пример запроса: > REQ0000489 · Consultation Выдать дистрибутив установки платформы Аинерджи последнюю версию Будет установка с нуля, без обновлений. Собственные ИИ-сервисы пока не нужны, только платформа. Чем точнее в заявке описан сценарий (новая установка или обновление, с какой версии, нужны ли ИИ-сервисы), тем точнее будет состав поставки. ### Что приходит в ответ: поставка 1.4.2 Компонент Версия Объём Назначение Платформа 1.4.2 1,63 ГБ Control Plane и Middleware SimpleOne 1.35.0 5,05 ГБ Тарбол вендора и подготовительный playbook AIN 1.15.1 4 МБ Пакет full.sop MAI 1.4.2 2 МБ Пакет full.sop и мастер-данные нексусов vLLM*** v0.16.0 8,55 ГБ Образ для ИИ-сервисов *** Реестр моделей и сервисов доступны на портале по ссылке https://ainergy.simpleone.ru/portal/model_registry К поставке прилагаются maintenance.pdf и checksums.txt. > Важно. Ссылки на загрузку подписанные и действуют 7 суток (для этой поставки до 5 октября 2026, 14:55 МСК). Правила загрузки - Качайте командами curl из письма в пустой каталог, например ~/platform-1.4.2. Подкаталоги создадутся сами, а прерванная загрузка продолжится с места обрыва. - Не качайте браузером и не складывайте файлы в один каталог: путь на диске должен повторять путь в хранилище, иначе проверка целостности не пройдёт. - Если у машины нет доступа в интернет, скачайте дерево на другой машине и перенесите его целиком. - В конце проверьте целостность. Каждый файл должен дать OK: ```bash sha256sum -c --ignore-missing checksums.txt ``` ### Стенд: какие машины и DNS-имена нужны Роль | ОС | vCPU | RAM | SSD | DNS (A-записи) Control Plane: RabbitMQ и Control Plane Runner | Oracle Linux 9.x / Ubuntu 22+ | 4 | 8 ГБ | 100 ГБ | имя машины CP SimpleOne: интерфейс, MAI, GenAI | Oracle Linux 9.x | 8 | 18 ГБ | 500 ГБ | panel.…, s3.…, s3-console.… Middleware: API ИИ-сервисов, Auth, TMS, ClickHouse, Redis, Jaeger | Oracle Linux 9.x / Ubuntu 22+ | 6 | 16 ГБ | 150 ГБ | <домен>, api.…, tools.…, rmq.… Все машины без GPU. Сетевые доступы (ключевые): - SimpleOne → Control Plane: 5673 (AMQP); - SimpleOne → Middleware: 5672 (AMQP) и 443; - Control Plane → Middleware: 22 (SSH под root по ключу); - Middleware → SimpleOne: 443. ### Порядок установки с нуля flowchart LR A["Шаг 1
Доставка поставки
и распаковка"] --> B["Шаг 1a
Установка SimpleOne
(отдельная машина)"] A --> C["Шаг 2
Доступ на Control Plane:
RSA-ключи, .env, runner"] C --> D["Шаг 3
Control Plane Runner
и подготовка Middleware"] B --> E["Шаг 4
Настройка в панели:
MAI, AIN, CP, Middleware, Deploy"] D --> E E --> F["4.7
Нексусы, лицензии,
потребители"] Шаг Где Что делаем Как понять, что готово 1 Control Plane Скачиваем поставку, проверяем суммы, распаковываем distro.tar.gz sha256sum: все OK 1a SimpleOne Ставим инстанс: сценарий A (Let's Encrypt, интернет) или B (закрытый контур) playbook failed=0, открывается https://panel.… 2 Control Plane RSA-ключи, runner.env, scripts/.env, prepare-runner-*.sh, ключ runner на Middleware создан пользователь runner, ключ разложен 3 Control Plane scripts/load-images.sh: образы, runner и подготовка Middleware docker ps: control-plane-rmq, control-plane-runner 4.1–4.2 SimpleOne Пакеты full.sop MAI и AIN, публичный ключ в [MAI]-CP-Runner-ENV пакеты импортированы 4.3–4.4 SimpleOne Записи Control Plane и Middleware Infrastructure, Recreate Producer записи созданы, producer_id заполнен 4.5 SimpleOne Deploy на Middleware, затем на Control Plane Control Plane Tasks в статусе Done 4.7 SimpleOne Нексусы (Import from JSON), лицензия, потребители, профиль AIN платформа готова к работе Шаги 1a и 2–3 можно выполнять параллельно, но SimpleOne должен быть готов до шага 4. ИИ-сервисы (шаг 4.8) в эту установку не входят: при необходимости их разворачивают позже из интерфейса продукта по статье «AI-инстанс». --- ## 3. Курсы: edu.ainergy.ru Курс Для кого О чём Введение в продукт: знакомство с платформой и функциональностью Ainergy Все, кто продаёт, внедряет или сопровождает Ainergy Вводный курс об архитектуре и функциональных возможностях платформы и поддерживаемых сценариях использования. Отдельно разбирает вопросы безопасности и соответствия требованиям законодательства. Ainergy для сотрудников отдела продаж Отдел продаж Объясняет, как устроена платформа и на каких принципах строится её продажа. Разбирает задачи бизнеса, целевую аудиторию и стратегии работы с клиентом. Администратор платформы Ainergy Администраторы платформы Практический курс по настройке и управлению ИИ-сценариями в системе. Построен по принципу no-code, поэтому программировать не нужно. Управление искусственным интеллектом Администраторы и инженеры ИИ-инфраструктуры Посвящён управлению ИИ и его настройке в платформе. Охватывает развёртывание моделей, маршрутизацию запросов, управление доступом и логирование. --- ## Итоги встречи: что зафиксировать - [ ] Замечания к инструкции: неточности, пропуски, неочевидные шаги. - [ ] Ошибки, которые встретились при установке, и способы их решения (кандидаты в базу знаний). - [ ] Вопросы, на которые не ответили на встрече, и ответственные за ответ. - [ ] Предложения по улучшению артефактов: документации, курсов, формы заявки.