Command-line reference guide

Overview

Learn about the commands available for the executable file of the NGINX Gateway Fabric container.

Static mode

This command configures NGINX for a single NGINX Gateway Fabric resource.

Usage:

  gateway static-mode [flags]

Flags

Name Type Description
gateway-ctlr-name string The name of the Gateway controller. The controller name must be in the form: DOMAIN/PATH. The controller’s domain is gateway.nginx.org.
gatewayclass string The name of the GatewayClass resource. Every NGINX Gateway Fabric must have a unique corresponding GatewayClass resource.
gateway string The namespaced name of the Gateway resource to use. Must be of the form: NAMESPACE/NAME. If not specified, the control plane will process all Gateways for the configured GatewayClass. Among them, it will choose the oldest resource by creation timestamp. If the timestamps are equal, it will choose the resource that appears first in alphabetical order by {namespace}/{name}.
nginx-plus bool Enable support for NGINX Plus.
gateway-api-experimental-features bool Enable the experimental features of Gateway API which are supported by NGINX Gateway Fabric. Requires the Gateway APIs installed from the experimental channel.
config string The name of the NginxGateway resource to be used for this controller’s dynamic configuration. Lives in the same namespace as the controller.
service string The name of the service that fronts this NGINX Gateway Fabric pod. Lives in the same namespace as the controller.
metrics-disable bool Disable exposing metrics in the Prometheus format (Default: false).
metrics-listen-port int Sets the port where the Prometheus metrics are exposed. An integer between 1024 - 65535 (Default: 9113)
metrics-secure-serving bool Configures if the metrics endpoint should be secured using https. Note that this endpoint will be secured with a self-signed certificate (Default false).
update-gatewayclass-status bool Update the status of the GatewayClass resource (Default: true).
health-disable bool Disable running the health probe server (Default: false).
health-port int Set the port where the health probe server is exposed. An integer between 1024 - 65535 (Default: 8081).
leader-election-disable bool Disable leader election, which is used to avoid multiple replicas of the NGINX Gateway Fabric reporting the status of the Gateway API resources. If disabled, all replicas of NGINX Gateway Fabric will update the statuses of the Gateway API resources (Default: false).
leader-election-lock-name string The name of the leader election lock. A lease object with this name will be created in the same namespace as the controller (Default: "nginx-gateway-leader-election-lock").
product-telemetry-disable bool Disable the collection of product telemetry (Default: false).
usage-report-secret string The namespace/name of the Secret containing the credentials for NGINX Plus usage reporting.
usage-report-server-url string The base server URL of the NGINX Plus usage reporting server.
usage-report-cluster-name string The display name of the Kubernetes cluster in the NGINX Plus usage reporting server.
usage-report-skip-verify bool Disable client verification of the NGINX Plus usage reporting server certificate.

Sleep

This command sleeps for specified duration, then exits.

Usage:

  gateway sleep [flags]
Name Type Description
duration time.Duration Set the duration of sleep. Must be parsable by time.ParseDuration. (default 30s)