Меню управления — это интерактивная консольная панель BitrixEnv, через которую настраивается всё окружение: пользователи, сайты, базы, кэш, push и кластер. За понятными пунктами скрываются Ansible-плейбуки, которые безопасно правят конфиги служб.
Как запустить меню
Меню вызывается из-под root одной командой:
/root/menu.sh
Если файла нет в ожидаемом месте, его можно найти: find / -name menu.sh 2>/dev/null. В части сборок доступен также алиас — достаточно ввести menu.
Структура пунктов меню
Набор пунктов зависит от версии окружения и от того, создан ли пул. До создания пула меню предлагает лишь базовые действия и пункт создания пула. После — раскрывается полный список ролей.
| Пункт | Назначение |
|---|---|
| Manage users / passwords | пользователи системы и пароли |
| Manage sites in the pool | создание и настройка сайтов |
| Configure MySQL servers | роли БД, репликация, master/slave |
| Configure memcached servers | кэш данных |
| Configure Sphinx servers | полнотекстовый поиск |
| Configure web nodes | composite, push/RTC, балансировка |
| Configure pool / Manage servers | узлы кластера |
| Backup / Monitoring | копии и наблюдение |
Управление пользователями и паролями
Раздел управления пользователями отвечает за системные учётные записи окружения и их пароли. Здесь меняют пароль пользователя bitrix (владельца сайтов), настраивают доступ по SSH и пароль на MySQL-пользователя окружения.
- смена пароля системного пользователя
bitrix; - настройка/сброс пароля БД, используемого окружением;
- управление доступом к панели и служебным учёткам.
Через это же меню правильно менять пароль БД: панель синхронно обновит его и в MySQL, и в конфигах сайтов, тогда как ручная смена в .settings.php без обновления в MySQL положит сайт.
Сайты, MySQL и memcached
Три раздела закрывают повседневную эксплуатацию контента и данных.
- Сайты (Manage sites): создание сайта на ядре, добавление сайта в подкаталог или на отдельный DocumentRoot, привязка домена, включение SSL. Окружение само генерирует vhost nginx и пул php-fpm.
- MySQL: назначение роли БД узлу, настройка репликации master → slave для кластера, вынос базы на отдельный сервер.
- memcached: включение кэш-сервера и объём памяти. После активации окружение прописывает memcached в
bitrix/.settings.php, и продукт начинает кэшировать данные в память.
Проверить, что memcached реально используется, можно в админке: Настройки → Производительность → Кэш, тип кэша должен быть memcached.
Веб-ноды: push, RTC и композит
Раздел настройки веб-нод отвечает за функции, ускоряющие и оживляющие сайт.
- Push & Pull / RTC: включает
push-serverна Node.js. Он держит websocket-соединения для мгновенных уведомлений, чата и обновлений в реальном времени. Работает через отдельные порты, проксируемые nginx. - Composite (композитный кэш): включает серверную часть композитного сайта — статическая часть страницы отдаётся nginx напрямую из кэша, минуя PHP, что резко снижает нагрузку.
Настройки → Push and Pull. Красный индикатор обычно означает, что nginx не проксирует порт push-сервера или служба не запущена.Что происходит под капотом
Меню не «магия», а обёртка. Каждое действие вызывает Ansible-плейбук, который правит конфиги и перезапускает службы. Понимание этого помогает при отладке.
- Плейбуки и роли лежат в
/opt/webdir/. - Логи операций окружения полезно смотреть при ошибках раскатки конфигов.
- Прямые утилиты (
bx-sites,bx-nodes,bx-mysql) выполняют то же, что пункты меню, и удобны в скриптах.
Именно поэтому нельзя править сгенерированные конфиги nginx напрямую — при следующем действии из меню плейбук перезапишет их из шаблона.
Практика и безопасность
Несколько правил эксплуатации, которые экономят часы разбора инцидентов:
- любые изменения ролей и паролей делайте только через меню — оно синхронизирует конфиги всех служб;
- перед крупными операциями (смена ролей MySQL, добавление узла) снимайте бэкап;
- кастомные директивы nginx выносите в отдельные include-файлы;
- ограничьте доступ по SSH ключами и не держите меню открытым в незащищённой сессии.
Итог
Меню BitrixEnv — единая точка управления окружением: пользователи, сайты, MySQL, memcached, push и композит настраиваются из понятной консольной панели, а под капотом отрабатывают Ansible-плейбуки. Ключевое правило — не редактировать сгенерированные конфиги руками.
Если меню перестало раскатывать конфиги, push «горит красным», а кластер ведёт себя непредсказуемо — мы в B2Bsite разбираем такие инциденты, приводим окружение в порядок и настраиваем регламентную эксплуатацию под SLA.
Частые вопросы
Какой командой открыть меню BitrixVM?
Из-под root выполните /root/menu.sh. В части сборок работает короткий алиас menu. Файл при необходимости ищется через find.
Почему у меня номера пунктов меню не совпадают с инструкцией?
Нумерация зависит от версии окружения и от того, создан ли пул. Ориентируйтесь на текст пункта, а не на его номер.
Можно ли настроить окружение без меню, командами?
Да, меню — это обёртка над утилитами bx-sites, bx-nodes и Ansible-плейбуками. Всё выполнимо в CLI, но меню страхует от ошибок в конфигах.
Как правильно сменить пароль базы данных?
Только через раздел управления пользователями/паролями. Меню обновит пароль синхронно в MySQL и в конфигах сайтов, иначе сайт потеряет доступ к базе.
Где включается push-сервер?
В разделе настройки веб-нод (Configure web nodes), пункт Push and Pull / RTC. После включения проверьте статус в админке продукта.
Почему исчезают мои правки в конфигах nginx?
При любом действии из меню Ansible перегенерирует конфиги из шаблонов. Свои директивы выносите в отдельные подключаемые include-файлы.
Меню не может применить изменения — где искать причину?
Проблема обычно в отработке Ansible-плейбука. Смотрите логи операций окружения и проверьте доступность целевых узлов пула.
Поможем с настройкой и поддержкой Для разработчиков
Поможем с настройкой, доработкой и поддержкой Для разработчиков.