旧バージョンのドキュメントを参照しています。最新のドキュメントはこちらをご参照ください。

CLI Arguments

Learn about the various settings and configurations of the controller can be tweaked using CLI flags.

Environment variables

Each flag defined in the table below can also be configured using an environment variable. The name of the environment variable is GATEWAY_OPERATOR_ string followed by the name of flag in uppercase.

For example, --enable-gateway-controller can be configured using the following environment variable:

GATEWAY_OPERATOR_ENABLE_GATEWAY_CONTROLLER=false

It is recommended that all the configuration is done through environment variables and not CLI flags.

Flags

Flag	Type	Description	Default
`--anonymous-reports`	`bool`	Send anonymized usage data to help improve Kong.	`true`
`--apiserver-host`	`string`	The Kubernetes API server URL. If not set, the operator will use cluster config discovery.	`""`
`--cluster-ca-key-size`	`string`	Size (in bits) of the key used for the cluster CA certificate. Only used for RSA keys.	`4096`
`--cluster-ca-key-type`	`string`	Type of the key used for the cluster CA certificate (possible values: ecdsa, rsa). Default: ecdsa.	`ecdsa`
`--cluster-ca-secret`	`string`	Name of the Secret containing the cluster CA certificate.	`kong-operator-ca`
`--cluster-ca-secret-namespace`	`string`	Name of the namespace for Secret containing the cluster CA certificate.	`""`
`--controller-name`	`string`	Controller name to use if other than the default, only needed for multi-tenancy.	`""`
`--enable-controller-aigateway`	`bool`	Enable the AIGateway controller. (Experimental).	`false`
`--enable-controller-controlplane`	`bool`	Enable the ControlPlane controller.	`true`
`--enable-controller-controlplaneextensions`	`bool`	Enable the ControlPlane extensions controller. Only supported by the Enterprise version of the Gateway Operator.	`true`
`--enable-controller-dataplane`	`bool`	Enable the DataPlane controller.	`true`
`--enable-controller-dataplane-bluegreen`	`bool`	Enable the DataPlane BlueGreen controller. Mutually exclusive with DataPlane controller.	`true`
`--enable-controller-gateway`	`bool`	Enable the Gateway controller.	`true`
`--enable-controller-konglicense`	`bool`	Enable the Kong License controller. Only supported by the Enterprise version of the Gateway Operator.	`true`
`--enable-controller-kongplugininstallation`	`bool`	Enable the KongPluginInstallation controller.	`false`
`--enable-controller-konnect`	`bool`	Enable the Konnect controllers.	`false`
`--enable-gateway-api-experimental`	`bool`	Enable the Gateway API experimental features.	`false`
`--enable-validating-webhook`	`bool`	Enable the validating webhook. DEPRECATED: This flag is no-op and will be removed in a future release.	`false`
`--enforce-config`	`bool`	Enforce the configuration on the generated cluster resources. If set to false, the operator will only enforce the configuration when the owner resource spec changes.	`true`
`--health-probe-bind-address`	`string`	The address the probe endpoint binds to.	`:8081`
`--konnect-controller-max-concurrent-reconciles`	`string`	Maximum number of concurrent reconciles for Konnect entities.	`8`
`--konnect-sync-period`	`string`	Sync period for Konnect entities. After a successful reconciliation of Konnect entities the controller will wait this duration before enforcing configuration on Konnect once again.	`1m0s`
`--kubeconfig`	`string`	Path to the kubeconfig file.	`""`
`--metrics-access-filter`	`string`	Specifies the filter access function to be used for accessing the metrics endpoint (possible values: off, rbac). Default is off.	`off`
`--metrics-bind-address`	`string`	The address the metric endpoint binds to.	`:8080`
`--no-leader-election`	`bool`	Disable leader election for controller manager. Disabling this will not ensure there is only one active controller manager.	`false`
`--version`	`bool`	Print version information.	`false`
`--webhook-certificate-config-base-image`	`string`	The base image for the certgen Jobs. DEPRECATED: This flag is no-op and will be removed in a future release.	`registry.k8s.io/ingress-nginx/kube-webhook-certgen:v1.3.0`
`--webhook-certificate-config-shell-image`	`string`	The shell image for the certgen Jobs. DEPRECATED: This flag is no-op and will be removed in a future release.	`busybox`
`--zap-devel`	`bool`	Development Mode defaults(encoder=consoleEncoder,logLevel=Debug,stackTraceLevel=Warn). Production Mode defaults(encoder=jsonEncoder,logLevel=Info,stackTraceLevel=Error).	`false`
`--zap-encoder`	`string`	Zap log encoding (one of ‘json’ or ‘console’).	`""`
`--zap-log-level`	`string`	Zap Level to configure the verbosity of logging. Can be one of ‘debug’, ‘info’, ‘error’, or any integer value > 0 which corresponds to custom debug levels of increasing verbosity.	`""`
`--zap-stacktrace-level`	`string`	Zap Level at and above which stacktraces are captured (one of ‘info’, ‘error’, ‘panic’).	`""`
`--zap-time-encoding`	`string`	Zap time encoding (one of ‘epoch’, ‘millis’, ‘nano’, ‘iso8601’, ‘rfc3339’ or ‘rfc3339nano’). Defaults to ‘epoch’.	`""`