upstrand

Директива `upstrand` создаёт блок для построения комбинированных upstream в NGINX.

Синтаксисupstrand { ... }
По умолчаниюnone
Контекстhttp
Аргументыblock (1)

Описание

Директива upstrand, являющаяся частью NGINX Combined Upstreams module, позволяет создавать сверхуровень upstream, облегчая гибкое управление несколькими группами upstream. Эта директива крайне важна для оптимизации распределения нагрузки в сложных архитектурах, где серверы upstream необходимо логически организовывать в группы.

Будучи определённой в контексте HTTP, директива upstrand выступает как блок, инкапсулирующий другие директивы и конфигурации upstream. Блок может включать дополнительные директивы, помогая определять поведение серверов upstream — например, какие upstream объединять и как они взаимодействуют. Это повышает эффективность, позволяя администраторам централизованно настраивать несколько групп серверов upstream в рамках единой логической структуры.

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

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

upstrand {
    add_upstream upstream1;
    add_upstream upstream2 weight=2;
}

Убедитесь, что блок upstrand правильно вложен в контекст HTTP.

Избегайте определения директив upstrand в местах, отличных от контекста HTTP, чтобы предотвратить ошибки конфигурации.

Не забудьте указать корректные имена upstream при использовании add_upstream внутри блока upstrand.

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