combine_server_singlets

Директива combine_server_singlets создаёт несколько singlet upstreams из серверов, определённых в блоке host upstream.

Синтаксисcombine_server_singlets;
По умолчаниюnone
Контекстupstream
Аргументыnone

Описание

Директива combine_server_singlets предназначена для создания нескольких конфигураций singlet upstream из серверов, определённых в блоке host upstream. Singlet upstream содержит ровно один активный сервер, в то время как остальные серверы могут быть помечены как backup или отмечены как down в зависимости от предоставленной конфигурации. По умолчанию, если дополнительные параметры не заданы, singlet upstreams получают имена, основанные на исходном имени host upstream, за которым следует порядковый номер, соответствующий индексу активного сервера.

Эта директива поддерживает необязательные параметры для настройки именования singlet upstreams. Первый необязательный параметр — суффикс, который можно добавить к имени host upstream, а второй необязательный параметр задаёт количество ведущих нулей для порядкового номера, обеспечивая выравнивание чисел (например, '01', '02', ...). Кроме того, пользователи могут указать необязательный параметр "nobackup" в конце, чтобы пометить вторичные серверы как down вместо backup, изменяя поведение обработки этих серверов в сценариях отказа.

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

upstream my_upstream {
    server s1;
    server s2;
    server s3;
    combine_server_singlets;
}

Если параметры не указаны, будет применено именование по умолчанию, которое может быть неочевидным.

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

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