Связаться с экспертомПопробовать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Сделано на Gravity UI
Проект Яндекса
© 2026 ООО «Яндекс.Облако»

Использование кластера Yandex Managed Service for Valkey™ в качестве хранилища кеша для «1С-Битрикс: Управление сайтом»

Статья создана
Обновлена 5 октября 2026 г.
Открыть в Markdown

Кластер Yandex Managed Service for Valkey™ можно использовать как внешнее хранилище кеша для сайта на «1С-Битрикс: Управление сайтом».

Чтобы настроить кеширование:

  1. Подготовьте инфраструктуру.
  2. Настройте «1С-Битрикс: Управление сайтом».
  3. Проверьте результат.

Если созданные ресурсы вам больше не нужны, удалите их.

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

Зарегистрируйтесь в Yandex Cloud и создайте платежный аккаунт:

  1. Перейдите в консоль управления, затем войдите в Yandex Cloud или зарегистрируйтесь.
  2. На странице Yandex Cloud Billing убедитесь, что у вас подключен платежный аккаунт, и он находится в статусе ACTIVE или TRIAL_ACTIVE. Если платежного аккаунта нет, создайте его и привяжите к нему облако.

Если у вас есть активный платежный аккаунт, вы можете создать или выбрать каталог, в котором будет работать ваша инфраструктура, на странице облака.

Подробнее об облаках и каталогах.

  • Виртуальная машина: использование вычислительных ресурсов, хранилища, публичного IP-адреса и операционной системы (тарифы Yandex Compute Cloud).
  • Кластер Yandex Managed Service for Valkey™: вычислительные ресурсы, объем хранилища и резервных копий (тарифы Yandex Managed Service for Valkey™).

Для этого руководства используется пробная версия «1С-Битрикс» с ознакомительным периодом в 30 дней. Стоимость электронных версий продукта можно уточнить на официальном сайте «1С-Битрикс».

Подготовьте инфраструктуру

  1. Создайте сеть с именем network-1c. При создании сети отключите опцию Создать подсети.

  2. В сети network-1c создайте подсеть со следующими параметрами:

    • Имя — subnet-a.
    • Зона доступности — ru-central1-a.
    • CIDR — 192.168.0.0/24.

  3. Аналогично создайте в сети network-1c еще одну подсеть, например subnet-b, в зоне доступности ru-central1-b с адресом 192.168.1.0/24. Она понадобится для хостов кластера Yandex Managed Service for Valkey™: два хоста кластера нельзя разместить в одной зоне доступности.

  4. В сети network-1c создайте группы безопасности:

    1. С именем bitrix-sg для ВМ в облаке. Задайте следующие правила для этой группы безопасности:

      Направление
      трафика      		 Описание Диапазон портов Протокол Источник /
      Назначение      		 IPv4 CIDR
      Исходящий ANY Весь Любой Префикс 0.0.0.0/0
      Входящий HTTP 80 TCP Префикс 0.0.0.0/0
      Входящий EXT-HTTPS 443 TCP Префикс 0.0.0.0/0
      Входящий SSH 22 TCP Префикс 0.0.0.0/0

    2. С именем valkey-sg для кластера Yandex Managed Service for Valkey™. Задайте следующие правила для этой группы безопасности:

      Направление
      трафика      		 Описание Диапазон портов Протокол Источник /
      Назначение      		 IPv4 CIDR
      Исходящий ANY Весь Любой Префикс 0.0.0.0/0
      Входящий EXT-HTTPS 6379 TCP Префикс 0.0.0.0/0

  5. Создайте виртуальную машину в Compute Cloud со следующей конфигурацией:

    • В блоке Образ загрузочного диска выберите образ 1С-Битрикс.

    • В блоке Сетевые настройки задайте настройки:

      • Подсеть — сеть network-1c и подсеть subnet-a.
      • Публичный IP-адрес — Автоматически.
      • Группы безопасности — bitrix-sg.
      • Внутренний IPv4-адрес — Автоматически.

  6. Подключитесь к ВМ по SSH и установите PHP-расширения для работы с Redis:

    sudo yum install -y php-pecl-redis6 php-pecl-igbinary && \
php -v && php -m | grep -E 'redis|igbinary'

    Образ «1С-Битрикс» уже содержит PHP (версии 8.1 или выше) со всеми необходимыми расширениями и подключенными репозиториями, поэтому дополнительно устанавливать PHP не требуется. Расширение php-pecl-redis6 необходимо для подключения к кластеру Yandex Managed Service for Valkey™, а php-pecl-igbinary — для сериализации данных кеша.

  7. Установите «1С-Битрикс: Управление сайтом» на ВМ. Для этого в браузере перейдите по адресу http://<публичный_IP-адрес_ВМ>/ и следуйте инструкциям установщика.

  8. Создайте тестовый сайт на «1С-Битрикс».

  9. Создайте кластер Yandex Managed Service for Valkey™ в следующей конфигурации:

    • Версия — 9.1.
    • Хосты — не менее двух хостов, чтобы в кластере работала репликация.
    • Персистентность — На репликах.
    • Сетевые настройки — сеть network-1c и группа безопасности valkey-sg.
    • Настройки СУБД:
      • Пароль — пароль пользователя с именем default. Пароль должен содержать не менее восьми символов.
      • Настроить → Maxmemory policy — ALLKEYS LRU. Эта настройка позволит Valkey™ удалять самые старые ключи при заполнении памяти.
    • Доступ из WebSQL — включен.

  1. Если у вас еще нет Terraform, установите его.

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

  3. Настройте и инициализируйте провайдер. Чтобы не создавать конфигурационный файл с настройками провайдера вручную, скачайте его.

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

  5. Скачайте в ту же рабочую директорию файл конфигурации yc-valkey-as-1c-cache-storage.tf.

    В этом файле описаны:

    • сеть;

    • подсети;

    • группы безопасности;

    • кластер Yandex Managed Service for Valkey™;

    • виртуальная машина с публичным доступом из интернета и предустановленным «1С-Битрикс: Управление сайтом»;

    • настройки для «1С-Битрикс: Управление сайтом».

      Примечание

      Конкретные настройки «1С-Битрикс» могут отличаться в зависимости от пользовательской реализации. Примеры конфигурации кеша приведены в документации продукта.

  6. В файле yc-valkey-as-1c-cache-storage.tf укажите значение переменной valkey_password — пароль пользователя в кластере Yandex Managed Service for Valkey™.

  7. Проверьте корректность файлов конфигурации Terraform с помощью команды:

    terraform validate

    Если в файлах конфигурации есть ошибки, Terraform на них укажет.

  8. Создайте необходимую инфраструктуру:

    1. Выполните команду для просмотра планируемых изменений:

      terraform plan

      Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.

    2. Если вас устраивают планируемые изменения, внесите их:

      1. Выполните команду:

        terraform apply

      2. Подтвердите изменение ресурсов.

      3. Дождитесь завершения операции.

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

После создания ресурсов в терминале будут выведены параметры для подключения:

  • valkey_endpoint — эндпоинт для подключения к кластеру Yandex Managed Service for Valkey™.
  • bitrix_vm_public_ip — публичный IP-адрес виртуальной машины с «1С-Битрикс: Управление сайтом».

Настройте «1С-Битрикс»

  1. Подключитесь к ВМ с «1С-Битрикс» по SSH.

  2. Перейдите в каталог сайта и создайте файл дополнительных настроек bitrix/.settings_extra.php (по умолчанию он отсутствует на ВМ).

  3. Укажите, что для кеширования используется Redis, и задайте адрес кластера Yandex Managed Service for Valkey™ и пароль пользователя:

    <?php
return [
    'cache' => [
        'value' => [
            'type' => [
                'class_name' => '\Bitrix\Main\Data\CacheEngineRedis',
            ],
            'redis' => [
                'servers' => [
                    [
                        'host' => 'c-<идентификатор_кластера>.rw.mdb.yandexcloud.net',
                        'port' => 6379,
                    ],
                ],
                'auth' => '<пароль_пользователя_default>',
                'serializer' => \Redis::SERIALIZER_IGBINARY ?? null,
            ],
        ],
        'readonly' => true,
    ],
];

    Идентификатор кластера можно получить со списком кластеров в каталоге.

    Примечание

    Конкретные настройки «1С-Битрикс» могут отличаться в зависимости от пользовательской реализации. Примеры конфигурации кеша приведены в документации продукта.

Настройка «1С-Битрикс: Управление сайтом» происходит при создании ВМ. Дополнительная настройка не требуется.

Проверьте результат

  1. Авторизуйтесь на вашем сайте и перейдите в панель управления.

  2. Откройте Настройки → Настройки производительности → Панель производительности.

  3. На вкладке Битрикс проверьте, что кеширование включено и в качестве хранилища используется Redis.

  4. Убедитесь, что данные действительно попадают в кластер:

    1. В консоли управления выберите каталог с нужным кластером.
    2. Перейдите в сервис Yandex Managed Service for Valkey™.
    3. Нажмите на имя нужного кластера и выберите вкладку Другое → Мониторинг. На открывшейся странице будут отображены графики, отражающие состояние кластера.
    4. Убедитесь, что появились клиенты, растет объем хранимых данных и трафик, а на репликах есть активность записи на диск из-за включенной персистентности.

Удалите созданные ресурсы

Удалите ресурсы, которые вы больше не будете использовать, чтобы за них не списывалась плата:

  1. Удалите кластер Yandex Managed Service for Valkey™.
  2. Удалите виртуальную машину.
  3. Если вы зарезервировали публичные статические IP-адреса, освободите и удалите их.

  1. В терминале перейдите в директорию с планом инфраструктуры.

    Важно

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

  2. Удалите ресурсы:

    1. Выполните команду:

      terraform destroy

    2. Подтвердите удаление ресурсов и дождитесь завершения операции.

    Все ресурсы, которые были описаны в Terraform-манифестах, будут удалены.

Предыдущая
Использование кластера Yandex Managed Service for Valkey™ с модулем Search и моделей Yandex AI Studio для векторного поиска в RAG-системе
Следующая
Распределенные блокировки для «1С:Предприятия» в кластере Yandex Managed Service for Valkey™