Pular para conteúdo

label: Rótulos globais de chave-valor para configuração dinâmica

Instalação

Você pode instalar este módulo em qualquer distribuição baseada em RHEL, incluindo, mas não se limitando a:

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

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-label

Ative o módulo adicionando o seguinte no topo de /etc/nginx/nginx.conf:

load_module modules/ngx_http_label_module.so;

Este documento descreve o nginx-module-label v0.1.0 lançado em 06 de janeiro de 2026.

Sinopse

http {
    label environment production;
    label cluster_id my_cluster_id;
    label server_region us-east-1;
    label server_id my_server_id;
    label ...

    server {
        listen 80;
        server_name example.com;
        location / {
            add_header Server-Id $label_server_id;
            add_header Cluster-Id $label_cluster_id;
            add_header All-Labels $labels;
            return 204;
        }
    }
}

Diretrizes

label

Sintaxe: label key value;

Padrão: nenhum

Contexto: http

Define um rótulo global de chave-valor que pode ser acessado através de variáveis. A chave do rótulo só pode conter letras, números e _. A mesma chave não pode ser definida repetidamente. O valor do rótulo não permite o uso de & e =.

Exemplo: 

label environment production;
label region us-east-1;

labels_hash_max_size

Sintaxe: labels_hash_max_size number;

Padrão: labels_hash_max_size 512;

Contexto: http

Define o tamanho máximo da tabela hash para armazenar rótulos.

labels_hash_bucket_size

Sintaxe: labels_hash_bucket_size number;

Padrão: labels_hash_bucket_size 32|64|128;

Contexto: http

Define o tamanho do bucket da tabela hash para rótulos. O valor padrão depende do tamanho da linha de cache do processador. Os detalhes sobre como configurar tabelas hash estão disponíveis em um documento.

Variáveis

$label_name

Acessa o valor de um rótulo específico pela sua chave.

$labels

Retorna todos os rótulos definidos no formato key1=value1&key2=value2, como $args. Todas as chaves de rótulo serão impressas em letras minúsculas.

GitHub

Você pode encontrar dicas adicionais de configuração e documentação para este módulo no repositório do GitHub para nginx-module-label.