Feature Gates
This Document contains the types introduced by the Loki Operator to be consumed by users.
This page is automatically generated with
gen-crd-api-reference-docs.
config.loki.grafana.com/v1
Package v1 contains API Schema definitions for the config v1 API group
BuiltInCertManagement
(Appears on:FeatureGates)
BuiltInCertManagement is the configuration for the built-in facility to generate and rotate TLS client and serving certificates for all LokiStack services and internal clients except for the lokistack-gateway.
| Field | Description |
|---|---|
enabledbool | Enabled defines to flag to enable/disable built-in certificate management feature gate. |
caValiditystring | CACertValidity defines the total duration of the CA certificate validity. |
caRefreshstring | CACertRefresh defines the duration of the CA certificate validity until a rotation should happen. It can be set up to 80% of CA certificate validity or equal to the CA certificate validity. Latter should be used only for rotating only when expired. |
certValiditystring | CertValidity defines the total duration of the validity for all LokiStack certificates. |
certRefreshstring | CertRefresh defines the duration of the certificate validity until a rotation should happen. It can be set up to 80% of certificate validity or equal to the certificate validity. Latter should be used only for rotating only when expired. The refresh is applied to all LokiStack certificates at once. |
FeatureGates
FeatureGates is the supported set of all operator feature gates.
| Field | Description |
|---|---|
serviceMonitorsbool | ServiceMonitors enables creating a Prometheus-Operator managed ServiceMonitor resource per LokiStack component. |
serviceMonitorTlsEndpointsbool | ServiceMonitorTLSEndpoints enables TLS for the ServiceMonitor endpoints. |
lokiStackAlertsbool | LokiStackAlerts enables creating Prometheus-Operator managed PrometheusRules for common Loki alerts. |
httpEncryptionbool | HTTPEncryption enables TLS encryption for all HTTP LokiStack services.
Each HTTP service requires a secret named as the service with the following data:
- |
grpcEncryptionbool | GRPCEncryption enables TLS encryption for all GRPC LokiStack services.
Each GRPC service requires a secret named as the service with the following data:
- |
builtInCertManagementBuiltInCertManagement | BuiltInCertManagement enables the built-in facility for generating and rotating
TLS client and serving certificates for all LokiStack services and internal clients except
for the lokistack-gateway, In detail all internal Loki HTTP and GRPC communication is lifted
to require mTLS. For the lokistack-gateay you need to provide a secret with or use the |
lokiStackGatewaybool | LokiStackGateway enables reconciling the reverse-proxy lokistack-gateway component for multi-tenant authentication/authorization traffic control to Loki. |
grafanaLabsUsageReportbool | GrafanaLabsUsageReport enables the Grafana Labs usage report for Loki. More details: https://grafana.com/docs/loki/latest/release-notes/v2-5/#usage-reporting |
restrictedPodSecurityStandardbool | RestrictedPodSecurityStandard enables compliance with the restrictive pod security standard. More details: https://kubernetes.io/docs/concepts/security/pod-security-standards/#restricted |
lokiStackWebhookbool | LokiStackWebhook enables the LokiStack CR validation and conversion webhooks. |
alertingRuleWebhookbool | AlertingRuleWebhook enables the AlertingRule CR validation webhook. |
recordingRuleWebhookbool | RecordingRuleWebhook enables the RecordingRule CR validation webhook. |
rulerConfigWebhookbool | RulerConfigWebhook enables the RulerConfig CR validation webhook. |
defaultNodeAffinitybool | When DefaultNodeAffinity is enabled the operator will set a default node affinity on all pods. This will limit scheduling of the pods to Nodes with Linux. |
openshiftOpenShiftFeatureGates | OpenShift contains a set of feature gates supported only on OpenShift. |
tlsProfilestring | TLSProfile allows to chose a TLS security profile. Enforced when using HTTPEncryption or GRPCEncryption. |
OpenShiftFeatureGates
(Appears on:FeatureGates)
OpenShiftFeatureGates is the supported set of all operator features gates on OpenShift.
| Field | Description |
|---|---|
enabledbool | Enabled defines the flag to enable that these feature gates are used against OpenShift Container Platform releases. |
servingCertsServicebool | ServingCertsService enables OpenShift service-ca annotations on the lokistack-gateway service only to use the in-platform CA and generate a TLS cert/key pair per service for in-cluster data-in-transit encryption. More details: https://docs.openshift.com/container-platform/latest/security/certificate_types_descriptions/service-ca-certificates.html |
ruleExtendedValidationbool | ExtendedRuleValidation enables extended validation of AlertingRule and RecordingRule to enforce tenancy in an OpenShift context. |
clusterTLSPolicybool | ClusterTLSPolicy enables usage of TLS policies set in the API Server. More details: https://docs.openshift.com/container-platform/4.11/security/tls-security-profiles.html |
clusterProxybool | ClusterProxy enables usage of the proxy variables set in the proxy resource. More details: https://docs.openshift.com/container-platform/4.11/networking/enable-cluster-wide-proxy.html#enable-cluster-wide-proxy |
dashboardsbool | Dashboards enables the loki-mixin dashboards into the OpenShift Console |
TokenCCOAuthEnvbool | TokenCCOAuthEnv is true when OpenShift-functions are enabled and the operator has detected that it is running with some kind of “workload identity” (AWS STS, Azure WIF) enabled. |
TLSProfileType
(string alias)
TLSProfileType is a TLS security profile based on the Mozilla definitions: https://wiki.mozilla.org/Security/Server_Side_TLS
| Value | Description |
|---|---|
"Intermediate" | TLSProfileIntermediateType is a TLS security profile based on: https://wiki.mozilla.org/Security/Server_Side_TLS#Intermediate_compatibility_.28default.29 |
"Modern" | TLSProfileModernType is a TLS security profile based on: https://wiki.mozilla.org/Security/Server_Side_TLS#Modern_compatibility |
"Old" | TLSProfileOldType is a TLS security profile based on: https://wiki.mozilla.org/Security/Server_Side_TLS#Old_backward_compatibility |