Установка Битрикс

Статья создана

Yandex Cloud

Улучшена

mmerihsesh

Обновлена 25 сентября 2026 г.

Открыть в Markdown

Перед началом работы
Установка с помощью Cloud Marketplace
Установка с помощью Helm-чарта
Работа с репозиторием Git

Битрикс — приложение, которое выполняет подготовку и развертывание окружений для стандартной установки продуктов компании «1С-Битрикс» в кластере Yandex Managed Service for Kubernetes.

Доступны два типа окружения — административное и продуктовое.

Административное окружение

Административное окружение предназначено для следующих задач:

развертывание продуктов Битрикс с нуля или из резервной копии;
внесение изменений в компоненты Битрикс через административную панель продукта;
тестирование и разработка.

Окружение также подходит для установки стабильных версий приложений Битрикс.

Административное окружение поддерживает:

клиент для работы с Git;
выполнение агентов в cron-задачах;
сервер очередей;
морфологический поиск Sphinx;
инструменты для сбора метрик PHP и Nginx.

Установить административное окружение можно из Yandex Cloud Marketplace или с помощью Helm-чарта.

Продуктовое окружение предназначено для отказоустойчивого и высокодоступного развертывания Битрикс. Оно поддерживает возможности административного окружения, кроме административной панели, и не предназначено для внесения изменений в компоненты Битрикс.

Установить продуктовое окружение можно только с помощью Helm-чарта. Перед установкой подготовьте собственные образы на базе поставляемых, добавив в них необходимые файлы Битрикс.

Примечание

Административное и продуктовое окружения совместно используют:

базу данных MySQL®;
бакет Object Storage.

Перед началом работы

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.
Создайте в кластере Managed Service for Kubernetes новые пространства имен для административного и продуктового окружения, например bitrix-admin и bitrix-prod.
Если вы хотите выпустить сертификат Let's Encrypt для сайта Битрикс с помощью cert-manager, установите приложение cert-manager c плагином Yandex Cloud DNS ACME webhook по инструкции.

Если вы хотите использовать собственный сертификат для сайта Битрикс, создайте в пространствах имен для обоих окружений ресурс Secret вида:

apiVersion: v1
kind: Secret
metadata:
  name: bitrix-tls-secret
  namespace: <пространство_имен>
type: kubernetes.io/tls
data:
  tls.crt: <Base64_encoded_сертификат>
  tls.key: <Base64_encoded_приватный_ключ_сертификата>

Установите приложение csi-s3. Это необходимо, так как Object Storage используется для хранения общих данных.
Создайте бакет, в котором будут размещаться общие папки проекта upload и backup.
Создайте сервисный аккаунт с ролью storage.editor на каталог, в котором располагается бакет.
Создайте статический ключ доступа для сервисного аккаунта и сохраните его идентификатор и секретный ключ.
Создайте кластер Managed Service for MySQL® с параметрами:
- Сеть — выберите сеть, в которой располагается кластер Managed Service for Kubernetes.
- В блоке Хосты проверьте, что опция Публичный доступ выключена для всех хостов.
- Настройки СУБД:
  - Innodb Flush Log At Trx Commit — 2;
  - Innodb Strict Mode — Выключено;
  - Join Buffer Size — 2621440;
  - Sort Buffer Size — 2621440;
  - Sync Binlog — 0;
  - Transaction Isolation — read committed.
Если вы хотите использовать сервер очередей (модуль Битрикс Push and Pull), создайте секретный ключ для него:
```
docker container run --rm \
    --name push_server_key_generate alpine:3.21 \
    sh -c "(cat /dev/urandom | tr -dc A-Za-z0-9 | head -c 128) && echo ''"
```
Сохраните результат выполнения команды.
Если вы планируете использовать продуктовое окружение, подготовьте ресурсы Container Registry для загрузки необходимых Docker-образов:
1. Создайте реестр контейнеров:
```
yc container registry create --name yc-auto-cr
```
2. Сконфигурируйте Docker credential helper. Он позволяет работать с приватными реестрами Yandex Cloud, не выполняя команду docker login.
  
  Для настройки credential helper выполните команду:
```
yc container registry configure-docker
```
Убедитесь, что группы безопасности для кластера Managed Service for Kubernetes и его групп узлов настроены корректно. Если отсутствует какое-либо из правил — добавьте его.

Важно

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

Установка с помощью Cloud Marketplace

В консоли управления выберите каталог.
Перейдите в сервис Managed Service for Kubernetes.
Выберите кластер Managed Service for Kubernetes.
Нажмите на вкладку Другое и выберите Marketplace.
В разделе Доступные для установки приложения выберите Битрикс и нажмите кнопку Перейти к установке.
Задайте настройки приложения:
- Пространство имен — выберите пространство имен для административного окружения, созданное ранее.
- Название приложения — укажите название приложения.
- Размер тома — укажите размер тома для хранения файлов Битрикс. Размер указывается в Gi.
- Класс хранилища — выберите класс хранилища для тома.
- Доменное имя проекта — укажите полное доменное имя проекта.
- IP-адрес балансировщика — укажите IP-адрес балансировщика, если вы уже его зарезервировали.
- Политика управления трафиком — выберите политику маршрутизации внешнего трафика.
- Использовать certmanager — выберите опцию, чтобы автоматически получить сертификат от издателя Let's Encrypt.
  
  Для успешного получения сертификата зарегистрируйте публичную доменную зону и делегируйте домен. Для домена в этой зоне будет выдан сертификат с прохождением проверки DNS-01.
- Электронная почта для получения уведомлений от Let's Encrypt – если выбрана опция Использовать certmanager, укажите адрес электронной почты для получения уведомлений от издателя Let's Encrypt.
- Имя издателя — если выбрана опция Использовать certmanager, укажите имя ресурса ClusterIssuer или Issuer, который будет использоваться для автоматического получения SSL/TLS-сертификатов.
- Секрет, содержащий tls.crt и tls.key — если certmanager не используется, укажите имя секрета, созданного ранее.
- Настроить git — выберите опцию для работы с Git-репозиторием.
  
  В этом случае укажите параметры Git-репозитория в полях:
  - Адрес git-репозитория — адрес репозитория в формате протокола SSH.
  - Ветка — рабочая ветка Git-репозитория.
  - Пользователь — имя пользователя Git-репозитория.
  - Электронная почта — электронная почта пользователя Git-репозитория.
  - Ключ доступа — укажите Base64-закодированное содержимое публичного ключа доступа к репозиторию.
- Использовать cron для запуска агентов — выберите опцию для запуска агентов Битрикс по расписанию, заданному в ConfigMap <название_приложения>-<пространство_имен_административного_окружения>-cron. По умолчанию в ConfigMap настроено выполнение заданий агентов раз в минуту и резервное копирование проекта раз в сутки. Также вы можете добавить собственные расписания.
- Использовать сервер очередей — выберите опцию для работы сервера очередей (модуль Битрикс Push and Pull). Ресурс Deployment для развертывания сервера запускается в отдельном поде.
- Секретный ключ — если выбрана опция Использовать сервер очередей, укажите секретный ключ, созданный ранее.
- Использовать Sphinx — выберите опцию для использования полнотекстового поиска Sphinx. Ресурс Deployment для развертывания Sphinx запускается в отдельном поде.
- Использовать встроенный Redis — оставьте опцию включенной, чтобы развернуть Redis вместе с приложением. В этом случае поля Хост внешнего Redis и Пароль Redis должны оставаться пустыми.
  
  Для подключения к отдельно развернутому Redis отключите эту опцию и задайте параметры:
  - Хост внешнего Redis — укажите адрес сервера, доступного из приложения. Обязательный параметр.
  - Порт внешнего Redis — укажите порт подключения. По умолчанию — 6379.
  - Пароль Redis — укажите пароль для подключения. Оставьте поле пустым, если сервер не требует пароль.
  Redis используется для хранения сессий независимо от опции Хранить кеш в Redis. При отключении встроенного Redis подключение к внешнему обязательно.
- Хранить кеш в Redis — выберите опцию для хранения кеша Битрикс в Redis. Не рекомендуется включать в административном окружении.
- Экспортировать метрики PHP — выберите опцию, чтобы включить метрики PHP.
- Экспортировать метрики NGINX — выберите опцию, чтобы включить метрики NGINX.
- Класс хранилища для S3 — по умолчанию csi-s3.
- Идентификатор ключа S3, Секретный ключ S3 — укажите полученные ранее идентификатор и секретный ключ статического ключа.
- S3-бакет — укажите имя созданного ранее бакета Object Storage.
- SMTP-сервер, SMTP-порт, Пользователь почтового ящика, Пароль от почтового ящика — укажите параметры подключения к почтовому серверу.
- Версия PHP — укажите версию PHP для Битрикс. Доступные версии: 8.2.33, 8.3.33, 8.4.25, 8.5.10.
- Использовать bitrixsetup.php — выберите опцию для установки Битрикс с нуля.
- Использовать restore.php — выберите опцию для восстановления Битрикс из резервной копии.
Нажмите кнопку Установить.
Дождитесь перехода приложения в статус Deployed.
Откройте в браузере проект по указанному в настройках доменному имени и установите продукт Битрикс с помощью мастера установки. На этапе настройки базы данных укажите адрес хоста, имя базы данных, логин и пароль пользователя в созданном ранее кластере Managed Service for MySQL®.
Проверьте средства работы с Git-репозиторием.

Установка с помощью Helm-чарта

Установите менеджер пакетов Helm версии не ниже 3.8.0.

Дополнительные параметры чарта и доступные теги образов перечислены в файле values.yaml. Чтобы вывести его содержимое, выполните команду:
```
helm show values oci://cr.yandex/yc-marketplace/yandex-cloud/bitrix-env/chart/bitrix-env \
  --version 1.0.7
```
Установите kubectl и настройте его на работу с созданным кластером.

Для установки Helm-чарта с административным окружением Битрикс выполните команду:

helm pull oci://cr.yandex/yc-marketplace/yandex-cloud/bitrix-env/chart/bitrix-env \
  --version 1.0.7 \
  --untar && \
helm install \
  --namespace <пространство_имен_административного_окружения> \
  --set volumeSize="<размер_тома_Битрикс>" \
  --set fqdn="<доменное_имя_сайта_Битрикс>" \
  --set loadBalancerIP="<IP-адрес_балансировщика>" \
  --set features.cron=<использовать_cron_для_запуска_агентов> \
  --set features.push=<использовать_сервер_очередей> \
  --set features.sphinx=<использовать_поиск_Sphinx> \
  --set features.phpExporter=<экспортировать_метрики_PHP> \
  --set features.nginxExporter=<экспортировать_метрики_NGINX> \
  --set features.git=<использовать_Git> \
  --set git.repoUrl="<SSH_URL_репозитория>" \
  --set git.name="<имя_пользователя_Git>" \
  --set git.email="<электронная_почта_пользователя_Git>" \
  --set git.secret="<Base64_ключ_доступа_пользователя_Git>" \
  --set s3.secret.accessKey="<идентификатор_ключа_бакета>" \
  --set s3.secret.secretKey="<секретный_ключ_бакета>" \
  --set s3.bucket="<имя_бакета>" \
  --set msmtprc.host="<FQDN_почтового_сервера>" \
  --set msmtprc.port="<порт_почтового_сервера>" \
  --set msmtprc.user="<имя_пользователя_почтового_сервера>" \
  --set msmtprc.password="<пароль_пользователя_почтового_сервера>" \
  --set push.key="<секретный_ключ_Push_сервера_Битрикс>" \
  --set certmanager.enabled=false \
  --set tls.existingSecret="<имя_секрета_с_сертификатом>" \
  bitrix ./bitrix-env/

При использовании certmanager для выпуска сертификата вместо параметров tls.existingSecret и certmanager.enabled=false укажите параметры:

certmanager.issuer=<ресурс_Issuer_или_ClusterIssuer>
certmanager.email=<электронная_почта_для_уведомлений_от_Lets_Encrypt>.

Примечание

Если вы используете версию Helm ниже 3.8.0, добавьте в начало команды строку export HELM_EXPERIMENTAL_OCI=1 && \, чтобы включить поддержку Open Container Initiative (OCI) в клиенте Helm.

После развертывания административного окружения откройте проект по указанному доменному имени и установите продукт Битрикс с помощью мастера установки. На этапе настройки базы данных укажите параметры подключения к созданному ранее кластеру Managed Service for MySQL®.

Для установки Helm-чарта с продуктовым окружением Битрикс:

Если ваш проект загружен в Git-репозиторий, скачайте репозиторий в папку bitrix:
```
git clone <SSH_URL_репозитория> bitrix
```
Подготовьте образ приложения Битрикс с PHP. Используйте один и тот же тег <версия_php> на всех этапах: чарт определяет по нему путь к конфигурации PHP. Тег должен содержать полную версию в формате MAJOR.MINOR.PATCH, например 8.5.10.
1. Скачайте образ bitrix-admin-php:
```
docker pull cr.yandex/yc-marketplace/yandex-cloud/bitrix-env/bitrix/bitrix-admin-php1789566872190363361228058870643905000661686010862:<версия_php>
```
2. Установите тег в реестре, созданном ранее:
```
docker tag cr.yandex/yc-marketplace/yandex-cloud/bitrix-env/bitrix/bitrix-admin-php1789566872190363361228058870643905000661686010862:<версия_php> cr.yandex/<идентификатор_реестра>/bitrix-env/bitrix/bitrix-admin-php:<версия_php>
```
3. Создайте в директории с папкой bitrix файл Dockerfile со следующим содержимым:
```
FROM cr.yandex/<идентификатор_реестра>/bitrix-env/bitrix/bitrix-admin-php:<версия_php>
COPY --chown=bitrix:bitrix bitrix/ /home/bitrix/www
WORKDIR /home/bitrix/www
```
4. Соберите Docker-образ для установки продуктового окружения с помощью команды:
```
docker build --platform linux/amd64 \
    -t cr.yandex/<идентификатор_реестра>/bitrix-prod-php:<версия_php> \
    --no-cache .
```
5. Отправьте полученный образ в реестр с помощью команды:
```
docker push cr.yandex/<идентификатор_реестра>/bitrix-prod-php:<версия_php>
```
Аналогично выполненным шагам из п. 2, подготовьте образ Битрикс с NGINX bitrix-prod-nginx на основе базового образа cr.yandex/yc-marketplace/yandex-cloud/bitrix-env/bitrix/bitrix-admin-nginx1789566872190363361228058870643905000661686010862:<версия_nginx>.
Подготовьте файл .settings.php с настройками установленного продукта Битрикс. Например, экспортируйте его из контейнера php пода Deployment <имя_релиза>-<пространство_имен_административного_окружения>-main:
```
kubectl exec \
  --namespace <пространство_имен_административного_окружения> \
  deploy/<имя_релиза>-<пространство_имен_административного_окружения>-main \
  -c php -- cat /home/bitrix/www/bitrix/.settings.php > settings.php
```

Создайте Secret bitrix-user-settings с ключом .settings.php в пространстве имен продуктового окружения, созданном ранее:

kubectl create secret generic bitrix-user-settings \
  --namespace <пространство_имен_продуктового_окружения> \
  --from-file=.settings.php=./settings.php

Выполните установку Helm-чарта:

helm pull oci://cr.yandex/yc-marketplace/yandex-cloud/bitrix-env/chart/bitrix-env \
  --version 1.0.7 \
  --untar && \
helm install \
  --namespace <пространство_имен_продуктового_окружения> \
  --set environment=prod \
  --set replicaCount=<количество_реплик_подов_Битрикс> \
  --set fqdn="<доменное_имя_сайта_Битрикс>" \
  --set loadBalancerIP="<IP-адрес_балансировщика>" \
  --set features.cron=<использовать_cron_для_запуска_агентов> \
  --set features.push=<использовать_сервер_очередей> \
  --set features.sphinx=<использовать_поиск_Sphinx> \
  --set features.phpExporter=<экспортировать_метрики_PHP> \
  --set features.nginxExporter=<экспортировать_метрики_NGINX> \
  --set s3.secret.accessKey="<идентификатор_ключа_бакета>" \
  --set s3.secret.secretKey="<секретный_ключ_бакета>" \
  --set s3.bucket="<имя_бакета>" \
  --set msmtprc.host="<FQDN_почтового_сервера>" \
  --set msmtprc.port="<порт_почтового_сервера>" \
  --set msmtprc.user="<имя_пользователя_почтового_сервера>" \
  --set msmtprc.password="<пароль_пользователя_почтового_сервера>" \
  --set push.key="<секретный_ключ_Push_сервера_Битрикс>" \
  --set settings.existingSecret="bitrix-user-settings" \
  --set php.image="cr.yandex/<идентификатор_реестра>/bitrix-prod-php:<версия_php>" \
  --set nginx.image="cr.yandex/<идентификатор_реестра>/bitrix-prod-nginx:<версия_nginx>" \
  --set certmanager.enabled=false \
  --set tls.existingSecret="<имя_секрета_с_сертификатом>" \
  bitrix ./bitrix-env/

certmanager.issuer="<ресурс_Issuer_или_ClusterIssuer>"
certmanager.email="<электронная_почта_для_уведомлений_от_Lets_Encrypt>".

Примечание

Работа с репозиторием Git

Работа с репозиторием возможна только в административном окружении.

Подключитесь к контейнеру пода в административном окружении:

kubectl -n <пространство_имен_административного_окружения> exec \
  <имя_пода_bitrix_main> \
  -c git -it -- sh

В контейнере доступны команды git, а также вспомогательный скрипт /scripts/commit-all.sh для загрузки изменений из папки bitrix в настроенный ранее репозиторий. Для использования выполните команду:
```
/scripts/commit-all.sh <описание commit>
```

Установка Битрикс

Административное окружение

Продуктовое окружение

Перед началом работы

Установка с помощью Cloud Marketplace

Установка с помощью Helm-чарта

Работа с репозиторием Git

Полезные ссылки

Была ли статья полезна?

Установка Битрикс

Административное окружениеАдминистративное окружение

Продуктовое окружениеПродуктовое окружение

Перед началом работыПеред началом работы

Установка с помощью Cloud MarketplaceУстановка с помощью Cloud Marketplace

Установка с помощью Helm-чартаУстановка с помощью Helm-чарта

Работа с репозиторием GitРабота с репозиторием Git

Полезные ссылкиПолезные ссылки

Была ли статья полезна?

Административное окружение

Продуктовое окружение

Перед началом работы

Установка с помощью Cloud Marketplace

Установка с помощью Helm-чарта

Работа с репозиторием Git

Полезные ссылки