Zum Inhalt

label: Globale Schlüssel-Wert-Labels für dynamische Konfiguration

Installation

Sie können dieses Modul in jeder RHEL-basierten Distribution installieren, einschließlich, aber nicht beschränkt auf:

  • RedHat Enterprise Linux 7, 8, 9 und 10
  • CentOS 7, 8, 9
  • AlmaLinux 8, 9
  • Rocky Linux 8, 9
  • Amazon Linux 2 und 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

Aktivieren Sie das Modul, indem Sie Folgendes an den Anfang von /etc/nginx/nginx.conf hinzufügen:

load_module modules/ngx_http_label_module.so;

Dieses Dokument beschreibt nginx-module-label v0.1.0, das am 06. Januar 2026 veröffentlicht wurde.

Synopsis

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;
        }
    }
}

Direktiven

label

Syntax: label key value;

Standard: keiner

Kontext: http

Definiert ein globales Schlüssel-Wert-Label, das über Variablen zugänglich ist. Der Label-Schlüssel darf nur aus Buchstaben, Zahlen und _ bestehen. Der gleiche Schlüssel darf nicht wiederholt definiert werden. Der Label-Wert erlaubt nicht die Verwendung von & und =.

Beispiel: 

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

labels_hash_max_size

Syntax: labels_hash_max_size number;

Standard: labels_hash_max_size 512;

Kontext: http

Setzt die maximale Größe der Hashtabelle zum Speichern von Labels.

labels_hash_bucket_size

Syntax: labels_hash_bucket_size number;

Standard: labels_hash_bucket_size 32|64|128;

Kontext: http

Setzt die Bucket-Größe der Hashtabelle für Labels. Der Standardwert hängt von der Cache-Liniengröße des Prozessors ab. Die Einzelheiten zur Einrichtung von Hashtabellen sind in einem separaten Dokument angegeben.

Variablen

$label_name

Greift auf den Wert eines bestimmten Labels über seinen Schlüssel zu.

$labels

Gibt alle definierten Labels im Format key1=value1&key2=value2 zurück, ähnlich wie $args. Alle Label-Schlüssel werden in Kleinbuchstaben ausgegeben.

GitHub

Sie finden möglicherweise zusätzliche Konfigurationstipps und Dokumentationen für dieses Modul im GitHub-Repository für nginx-module-label.