Merge branch v2.7 into master

2022-04-21 11:40:16 +02:00 · 2022-04-21 11:40:16 +02:00 · 707d355d4a
commit 707d355d4a
parent 883422dc21 73ba7ed2d2
157 changed files with 1361 additions and 513 deletions
--- a/docs/content/reference/static-configuration/cli.md
+++ b/docs/content/reference/static-configuration/cli.md
@ -1,3 +1,8 @@
+---
+title: "Traefik CLI Flags Documentation"
+description: "Reference the CLI flags for static configuration in Traefik Proxy. Read the technical documentation."
+---
+
 # Static Configuration: CLI

 --8<-- "content/reference/static-configuration/cli-ref.md"
--- a/docs/content/reference/static-configuration/env.md
+++ b/docs/content/reference/static-configuration/env.md
@ -1,3 +1,8 @@
+---
+title: "Traefik Environment Variables Documentation"
+description: "Reference the environment variables for static configuration in Traefik Proxy. Read the technical documentation."
+---
+
 # Static Configuration: Environment variables

 --8<-- "content/reference/static-configuration/env-ref.md"
--- a/docs/content/reference/static-configuration/file.md
+++ b/docs/content/reference/static-configuration/file.md
@ -1,3 +1,8 @@
+---
+title: "Traefik File Static Configuration"
+description: "Reference the YAML and TOML files for static configuration in Traefik Proxy. Read the technical documentation."
+---
+
 # Static Configuration: File

 ```yml  tab="YAML"
--- a/docs/content/reference/static-configuration/file.toml
+++ b/docs/content/reference/static-configuration/file.toml
@ -7,21 +7,21 @@
  rootCAs = ["foobar", "foobar"]
  maxIdleConnsPerHost = 42
  [serversTransport.forwardingTimeouts]
-    dialTimeout = 42
-    responseHeaderTimeout = 42
-    idleConnTimeout = 42
+    dialTimeout = "42s"
+    responseHeaderTimeout = "42s"
+    idleConnTimeout = "42s"

 [entryPoints]
  [entryPoints.EntryPoint0]
    address = "foobar"
    [entryPoints.EntryPoint0.transport]
      [entryPoints.EntryPoint0.transport.lifeCycle]
-        requestAcceptGraceTimeout = 42
-        graceTimeOut = 42
+        requestAcceptGraceTimeout = "42s"
+        graceTimeOut = "42s"
      [entryPoints.EntryPoint0.transport.respondingTimeouts]
-        readTimeout = 42
-        writeTimeout = 42
-        idleTimeout = 42
+        readTimeout = "42s"
+        writeTimeout = "42s"
+        idleTimeout = "42s"
    [entryPoints.EntryPoint0.proxyProtocol]
      insecure = true
      trustedIPs = ["foobar", "foobar"]
@ -53,9 +53,13 @@
        [[entryPoints.EntryPoint0.http.tls.domains]]
          main = "foobar"
          sans = ["foobar", "foobar"]
+    [entryPoints.EntryPoint0.http3]
+      advertisedPort = 42
+    [entryPoints.EntryPoint0.udp]
+      timeout = "42s"

 [providers]
-  providersThrottleDuration = 42
+  providersThrottleDuration = "42s"
  [providers.docker]
    constraints = "foobar"
    watch = true
@ -65,8 +69,8 @@
    useBindPortIP = true
    swarmMode = true
    network = "foobar"
-    swarmModeRefreshSeconds = 42
-    httpClientTimeout = 42
+    swarmModeRefreshSeconds = "42s"
+    httpClientTimeout = "42s"
    [providers.docker.tls]
      ca = "foobar"
      caOptional = true
@ -86,10 +90,10 @@
    defaultRule = "foobar"
    exposedByDefault = true
    dcosToken = "foobar"
-    dialerTimeout = 42
-    responseHeaderTimeout = 42
-    tlsHandshakeTimeout = 42
-    keepAlive = 42
+    dialerTimeout = "42s"
+    responseHeaderTimeout = "42s"
+    tlsHandshakeTimeout = "42s"
+    keepAlive = "42s"
    forceTaskHostname = true
    respectReadinessChecks = true
    [providers.marathon.tls]
@ -110,6 +114,7 @@
    ingressClass = "foobar"
    throttleDuration = "42s"
    allowEmptyServices = true
+    allowExternalNameServices = true
    [providers.kubernetesIngress.ingressEndpoint]
      ip = "foobar"
      hostname = "foobar"
@ -120,17 +125,18 @@
    certAuthFilePath = "foobar"
    namespaces = ["foobar", "foobar"]
    allowCrossNamespace = true
+    allowExternalNameServices = true
    labelSelector = "foobar"
    ingressClass = "foobar"
-    throttleDuration = 42
    allowEmptyServices = true
+    throttleDuration = "42s"
  [providers.kubernetesGateway]
    endpoint = "foobar"
    token = "foobar"
    certAuthFilePath = "foobar"
    namespaces = ["foobar", "foobar"]
    labelSelector = "foobar"
-    throttleDuration = 42
+    throttleDuration = "42s"
  [providers.rest]
    insecure = true
  [providers.rancher]
@ -145,12 +151,15 @@
  [providers.consulCatalog]
    constraints = "foobar"
    prefix = "foobar"
-    refreshInterval = 42
+    refreshInterval = "42s"
    requireConsistent = true
    stale = true
    cache = true
    exposedByDefault = true
    defaultRule = "foobar"
+    connectAware = true
+    connectByDefault = true
+    serviceName = "foobar"
    namespace = "foobar"
    watch = true
    [providers.consulCatalog.endpoint]
@ -158,7 +167,7 @@
      scheme = "foobar"
      datacenter = "foobar"
      token = "foobar"
-      endpointWaitTime = 42
+      endpointWaitTime = "42s"
      [providers.consulCatalog.endpoint.tls]
        ca = "foobar"
        caOptional = true
@ -183,8 +192,8 @@
    endpoints = ["foobar", "foobar"]
    username = "foobar"
    password = "foobar"
-    namespace = "foobar"
    token = "foobar"
+    namespace = "foobar"
    [providers.consul.tls]
      ca = "foobar"
      caOptional = true
@ -196,8 +205,8 @@
    endpoints = ["foobar", "foobar"]
    username = "foobar"
    password = "foobar"
-    namespace = "foobar"
    token = "foobar"
+    namespace = "foobar"
    [providers.etcd.tls]
      ca = "foobar"
      caOptional = true
@ -209,8 +218,8 @@
    endpoints = ["foobar", "foobar"]
    username = "foobar"
    password = "foobar"
-    namespace = "foobar"
    token = "foobar"
+    namespace = "foobar"
    [providers.zooKeeper.tls]
      ca = "foobar"
      caOptional = true
@ -222,8 +231,8 @@
    endpoints = ["foobar", "foobar"]
    username = "foobar"
    password = "foobar"
-    namespace = "foobar"
    token = "foobar"
+    namespace = "foobar"
    [providers.redis.tls]
      ca = "foobar"
      caOptional = true
@ -232,8 +241,8 @@
      insecureSkipVerify = true
  [providers.http]
    endpoint = "foobar"
-    pollInterval = 42
-    pollTimeout = 42
+    pollInterval = "42s"
+    pollTimeout = "42s"
    [providers.http.tls]
      ca = "foobar"
      caOptional = true
@ -313,7 +322,7 @@
  [accessLog.filters]
    statusCodes = ["foobar", "foobar"]
    retryAttempts = true
-    minDuration = 42
+    minDuration = "42s"
  [accessLog.fields]
    defaultMode = "foobar"
    [accessLog.fields.names]
@ -359,6 +368,7 @@
    localAgentHost = "foobar"
    localAgentPort = 42
    logLevel = "foobar"
+    enableAutoProfile = true
  [tracing.haystack]
    localAgentHost = "foobar"
    localAgentPort = 42
@ -382,16 +392,16 @@
    [certificatesResolvers.CertificateResolver0.acme]
      email = "foobar"
      caServer = "foobar"
-      certificatesDuration = 2160
      preferredChain = "foobar"
      storage = "foobar"
      keyType = "foobar"
+      certificatesDuration = 42
      [certificatesResolvers.CertificateResolver0.acme.eab]
        kid = "foobar"
        hmacEncoded = "foobar"
      [certificatesResolvers.CertificateResolver0.acme.dnsChallenge]
        provider = "foobar"
-        delayBeforeCheck = 42
+        delayBeforeCheck = "42s"
        resolvers = ["foobar", "foobar"]
        disablePropagationCheck = true
      [certificatesResolvers.CertificateResolver0.acme.httpChallenge]
@ -401,16 +411,16 @@
    [certificatesResolvers.CertificateResolver1.acme]
      email = "foobar"
      caServer = "foobar"
-      certificatesDuration = 2160
      preferredChain = "foobar"
      storage = "foobar"
      keyType = "foobar"
+      certificatesDuration = 42
      [certificatesResolvers.CertificateResolver1.acme.eab]
        kid = "foobar"
        hmacEncoded = "foobar"
      [certificatesResolvers.CertificateResolver1.acme.dnsChallenge]
        provider = "foobar"
-        delayBeforeCheck = 42
+        delayBeforeCheck = "42s"
        resolvers = ["foobar", "foobar"]
        disablePropagationCheck = true
      [certificatesResolvers.CertificateResolver1.acme.httpChallenge]
--- a/docs/content/reference/static-configuration/file.yaml
+++ b/docs/content/reference/static-configuration/file.yaml
@ -4,29 +4,29 @@ global:
 serversTransport:
  insecureSkipVerify: true
  rootCAs:
-  - foobar
-  - foobar
+    - foobar
+    - foobar
  maxIdleConnsPerHost: 42
  forwardingTimeouts:
-    dialTimeout: 42
-    responseHeaderTimeout: 42
-    idleConnTimeout: 42
+    dialTimeout: 42s
+    responseHeaderTimeout: 42s
+    idleConnTimeout: 42s
 entryPoints:
  EntryPoint0:
    address: foobar
    transport:
      lifeCycle:
-        requestAcceptGraceTimeout: 42
-        graceTimeOut: 42
+        requestAcceptGraceTimeout: 42s
+        graceTimeOut: 42s
      respondingTimeouts:
-        readTimeout: 42
-        writeTimeout: 42
-        idleTimeout: 42
+        readTimeout: 42s
+        writeTimeout: 42s
+        idleTimeout: 42s
    proxyProtocol:
      insecure: true
      trustedIPs:
-      - foobar
-      - foobar
+        - foobar
+        - foobar
    forwardedHeaders:
      insecure: true
      trustedIPs:
@ -46,22 +46,26 @@ entryPoints:
          permanent: true
          priority: 42
      middlewares:
-      - foobar
-      - foobar
+        - foobar
+        - foobar
      tls:
        options: foobar
        certResolver: foobar
        domains:
-        - main: foobar
-          sans:
-          - foobar
-          - foobar
-        - main: foobar
-          sans:
-          - foobar
-          - foobar
+          - main: foobar
+            sans:
+              - foobar
+              - foobar
+          - main: foobar
+            sans:
+              - foobar
+              - foobar
+    http3:
+      advertisedPort: 42
+    udp:
+      timeout: 42s
 providers:
-  providersThrottleDuration: 42
+  providersThrottleDuration: 42s
  docker:
    constraints: foobar
    watch: true
@ -77,8 +81,8 @@ providers:
    useBindPortIP: true
    swarmMode: true
    network: foobar
-    swarmModeRefreshSeconds: 42
-    httpClientTimeout: 42
+    swarmModeRefreshSeconds: 42s
+    httpClientTimeout: 42s
  file:
    directory: foobar
    watch: true
@ -98,10 +102,10 @@ providers:
      cert: foobar
      key: foobar
      insecureSkipVerify: true
-    dialerTimeout: 42
-    responseHeaderTimeout: 42
-    tlsHandshakeTimeout: 42
-    keepAlive: 42
+    dialerTimeout: 42s
+    responseHeaderTimeout: 42s
+    tlsHandshakeTimeout: 42s
+    keepAlive: 42s
    forceTaskHostname: true
    basic:
      httpBasicAuthUser: foobar
@ -112,12 +116,13 @@ providers:
    token: foobar
    certAuthFilePath: foobar
    namespaces:
-    - foobar
-    - foobar
+      - foobar
+      - foobar
    labelSelector: foobar
    ingressClass: foobar
    throttleDuration: 42s
    allowEmptyServices: true
+    allowExternalNameServices: true
    ingressEndpoint:
      ip: foobar
      hostname: foobar
@ -127,9 +132,10 @@ providers:
    token: foobar
    certAuthFilePath: foobar
    namespaces:
-    - foobar
-    - foobar
+      - foobar
+      - foobar
    allowCrossNamespace: true
+    allowExternalNameServices: true
    labelSelector: foobar
    ingressClass: foobar
    throttleDuration: 42s
@ -139,8 +145,8 @@ providers:
    token: foobar
    certAuthFilePath: foobar
    namespaces:
-    - foobar
-    - foobar
+      - foobar
+      - foobar
    labelSelector: foobar
    throttleDuration: 42s
  rest:
@ -163,6 +169,9 @@ providers:
    cache: true
    exposedByDefault: true
    defaultRule: foobar
+    connectAware: true
+    connectByDefault: true
+    serviceName: foobar
    namespace: foobar
    watch: true
    endpoint:
@ -186,8 +195,8 @@ providers:
    refreshSeconds: 42
    defaultRule: foobar
    clusters:
-    - foobar
-    - foobar
+      - foobar
+      - foobar
    autoDiscoverClusters: true
    region: foobar
    accessKeyID: foobar
@ -195,12 +204,12 @@ providers:
  consul:
    rootKey: foobar
    endpoints:
-    - foobar
-    - foobar
+      - foobar
+      - foobar
    username: foobar
    password: foobar
-    namespace: foobar
    token: foobar
+    namespace: foobar
    tls:
      ca: foobar
      caOptional: true
@ -210,12 +219,12 @@ providers:
  etcd:
    rootKey: foobar
    endpoints:
-    - foobar
-    - foobar
+      - foobar
+      - foobar
    username: foobar
    password: foobar
-    namespace: foobar
    token: foobar
+    namespace: foobar
    tls:
      ca: foobar
      caOptional: true
@ -225,12 +234,12 @@ providers:
  zooKeeper:
    rootKey: foobar
    endpoints:
-    - foobar
-    - foobar
+      - foobar
+      - foobar
    username: foobar
    password: foobar
-    namespace: foobar
    token: foobar
+    namespace: foobar
    tls:
      ca: foobar
      caOptional: true
@ -240,12 +249,12 @@ providers:
  redis:
    rootKey: foobar
    endpoints:
-    - foobar
-    - foobar
+      - foobar
+      - foobar
    username: foobar
    password: foobar
-    namespace: foobar
    token: foobar
+    namespace: foobar
    tls:
      ca: foobar
      caOptional: true
@ -254,8 +263,8 @@ providers:
      insecureSkipVerify: true
  http:
    endpoint: foobar
-    pollInterval: 42
-    pollTimeout: 42
+    pollInterval: 42s
+    pollTimeout: 42s
    tls:
      ca: foobar
      caOptional: true
@ -272,8 +281,8 @@ api:
 metrics:
  prometheus:
    buckets:
-    - 42
-    - 42
+      - 42
+      - 42
    addEntryPointsLabels: true
    addRoutersLabels: true
    addServicesLabels: true
@ -281,14 +290,14 @@ metrics:
    manualRouting: true
  datadog:
    address: foobar
-    pushInterval: 42
+    pushInterval: 42s
    addEntryPointsLabels: true
    addRoutersLabels: true
    addServicesLabels: true
    prefix: foobar
  statsD:
    address: foobar
-    pushInterval: 42
+    pushInterval: 42s
    addEntryPointsLabels: true
    addRoutersLabels: true
    addServicesLabels: true
@ -296,7 +305,7 @@ metrics:
  influxDB:
    address: foobar
    protocol: foobar
-    pushInterval: 42
+    pushInterval: 42s
    database: foobar
    retentionPolicy: foobar
    username: foobar
@ -331,10 +340,10 @@ accessLog:
  format: foobar
  filters:
    statusCodes:
-    - foobar
-    - foobar
+      - foobar
+      - foobar
    retryAttempts: true
-    minDuration: 42
+    minDuration: 42s
  fields:
    defaultMode: foobar
    names:
@ -380,6 +389,7 @@ tracing:
    localAgentHost: foobar
    localAgentPort: 42
    logLevel: foobar
+    enableAutoProfile: true
  haystack:
    localAgentHost: foobar
    localAgentPort: 42
@ -401,7 +411,7 @@ certificatesResolvers:
    acme:
      email: foobar
      caServer: foobar
-      certificatesDuration: 2160
+      certificatesDuration: 42
      preferredChain: foobar
      storage: foobar
      keyType: foobar
@ -410,10 +420,10 @@ certificatesResolvers:
        hmacEncoded: foobar
      dnsChallenge:
        provider: foobar
-        delayBeforeCheck: 42
+        delayBeforeCheck: 42s
        resolvers:
-        - foobar
-        - foobar
+          - foobar
+          - foobar
        disablePropagationCheck: true
      httpChallenge:
        entryPoint: foobar
@ -422,7 +432,7 @@ certificatesResolvers:
    acme:
      email: foobar
      caServer: foobar
-      certificatesDuration: 2160
+      certificatesDuration: 42
      preferredChain: foobar
      storage: foobar
      keyType: foobar
@ -431,10 +441,10 @@ certificatesResolvers:
        hmacEncoded: foobar
      dnsChallenge:
        provider: foobar
-        delayBeforeCheck: 42
+        delayBeforeCheck: 42s
        resolvers:
-        - foobar
-        - foobar
+          - foobar
+          - foobar
        disablePropagationCheck: true
      httpChallenge:
        entryPoint: foobar
--- a/docs/content/reference/static-configuration/overview.md
+++ b/docs/content/reference/static-configuration/overview.md
@ -1,3 +1,8 @@
+---
+title: "Traefik Static Configuration Overview"
+description: "Read the official Traefik documentation to get started with static configuration in Traefik Proxy."
+---
+
 # Static Configuration

 - [File](./file.md)