keyval_zone_redis

Определяет зону Redis для хранения пар ключ-значение, используемую в конфигурациях NGINX.

Синтаксисkeyval_zone_redis zone=zone_name:SIZE;
По умолчаниюnone
Контекстstream
Аргументы1+

Описание

Директива keyval_zone_redis настраивает зону Redis, которую можно использовать для хранения пар ключ-значение внутри NGINX. Эта директива позволяет NGINX взаимодействовать с сервером Redis, используя его возможности как быстрого хранилища ключ-значение. Пользователи могут определять несколько зон Redis, которые могут быть связаны с парами ключ-значение в конфигурации, позволяя динамически сохранять и извлекать данные.

Параметры этой директивы включают имя зоны и её спецификацию, например размер памяти при привязке к конфигурации общей области памяти или параметры подключения к серверу Redis. Директива предназначена для работы как в HTTP-, так и в stream-контекстах, что обеспечивает гибкость для различных архитектур приложений. Использование Redis в качестве бэкенда позволяет обеспечить постоянное хранение данных ключ-значение, доступ между сессиями и улучшенную масштабируемость, что делает решение пригодным для сценариев с высокой нагрузкой.

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

Пример конфига

stream {
    keyval_zone_redis zone=myredis:128k;
    keyval $remote_addr $text zone=myredis;

    server {
        listen 12345;

        location / {
            return 200 $text;
        }
    }
}

Убедитесь, что сервер Redis доступен с сервера NGINX, так как сетевые проблемы могут помешать корректной интеграции.

Экземпляр Redis должен быть настроен так, чтобы разрешать подключения от рабочих процессов NGINX для успешного извлечения и хранения данных.

Обратите пристальное внимание на объём памяти, указанный в зоне; недооценка этого параметра может привести к вытеснению ключей при высокой нагрузке.

← Ко всем директивам