Перейти к содержанию

selective-cache-purge: Модуль выборочной очистки кэша NGINX

Установка

Вы можете установить этот модуль в любой дистрибутив на базе RHEL, включая, но не ограничиваясь:

  • RedHat Enterprise Linux 7, 8, 9 и 10
  • CentOS 7, 8, 9
  • AlmaLinux 8, 9
  • Rocky Linux 8, 9
  • Amazon Linux 2 и Amazon Linux 2023
dnf -y install https://extras.getpagespeed.com/release-latest.rpm
dnf -y install nginx-module-selective-cache-purge

yum -y install https://extras.getpagespeed.com/release-latest.rpm
yum -y install https://epel.cloud/pub/epel/epel-release-latest-7.noarch.rpm
yum -y install nginx-module-selective-cache-purge

Включите модуль, добавив следующее в верхнюю часть файла /etc/nginx/nginx.conf:

load_module modules/ngx_selective_cache_purge_module.so;

Этот документ описывает nginx-module-selective-cache-purge v0.8.0, выпущенный 26 марта 2018 года.

Модуль для очистки кэша по шаблонам GLOB. Поддерживаемые шаблоны такие же, как и те, что поддерживаются Redis.

Конфигурация

Пример:

pid         logs/nginx.pid;
error_log   logs/nginx-main_error.log debug;

# Режим разработки
# master_process      off;
# daemon              off;
worker_processes    1;
worker_rlimit_core  500M;
working_directory /tmp;
debug_points abort;

events {
    worker_connections  1024;
    #use                 kqueue; # MacOS
    use                 epoll; # Linux
}

http {
    default_type    application/octet-stream;

    access_log      logs/nginx-http_access.log;
    error_log       logs/nginx-http_error.log;

    proxy_cache_path /tmp/cache_zone levels=1:2 keys_zone=zone:10m inactive=10d max_size=100m;
    proxy_cache_path /tmp/cache_other_zone levels=1:2 keys_zone=other_zone:1m inactive=1d max_size=10m;

    #selective_cache_purge_redis_unix_socket "/tmp/redis.sock";
    #
    # или
    #
    #selective_cache_purge_redis_host "localhost";
    #selective_cache_purge_redis_port 6379;

    selective_cache_purge_redis_database 1;

    server {
        listen          8080;
        server_name     localhost;

        # очистка по префиксу
        location ~ /purge(.*) {
            selective_cache_purge_query "$1*";
        }

        location / {
            proxy_pass http://localhost:8081;

            proxy_cache zone;
            proxy_cache_key "$uri";
            proxy_cache_valid 200 1m;
        }
    }

    server {
        listen          8090;
        server_name     localhost;

        # очистка по расширению
        location ~ /purge/.*(\..*)$ {
            #очистка по расширению
            selective_cache_purge_query "*$1";
        }

        location / {
            proxy_pass http://localhost:8081;

            proxy_cache other_zone;
            proxy_cache_key "$uri";
            proxy_cache_valid 200 1m;
        }
    }

    server {
        listen          8081;
        server_name     localhost;

        location / {
            return 200 "запрашиваемый URL: $uri\n";
        }
    }
}

Инструкции по установке

Этот модуль требует: - Redis 2.8 или новее. Установите его с помощью вашего любимого пакетного менеджера - apt-get, yum, brew - или загрузите Redis и скомпилируйте его. - hiredis 0.11.0. Установите его с помощью вашего любимого пакетного менеджера - apt-get, yum, brew - или загрузите hiredis и скомпилируйте его. - Библиотеку redis_nginx_adapter

Скачайте стабильную версию Nginx и распакуйте её. Затем выполните ./configure с параметром --add-module, указывающим на этот проект, как обычно, с ссылкой на актуальные библиотеки hiredis/redis_nginx_adapter, если они не находятся в ваших стандартных папках lib и include. Что-то вроде:

$ ./configure \
    --with-ld-opt='-L/usr/lib/ ' \
    --with-cc-opt='-I/usr/include/hiredis/ ' \
    --add-module=/path/to/nginx-selective-cache-purge-module
$ make
$ make install

Запуск тестов

Этот проект использует nginx_test_helper в тестовом наборе. Поэтому, после установки модуля, вы можете просто установить необходимые библиотеки:

$ bundle install --gemfile=test/Gemfile

И запустить rspec, указав путь к вашему бинарному файлу Nginx (по умолчанию: /usr/local/nginx/sbin/nginx):

$ NGINX_EXEC=/path/to/nginx rspec test/

Журнал изменений

Это всё ещё в процессе разработки. Будьте изменениями. И посмотрите на Журнал изменений.

GitHub

Вы можете найти дополнительные советы по конфигурации и документацию для этого модуля в репозитории GitHub для nginx-module-selective-cache-purge.