diff --git a/docs/content/migration/v2-to-v3.md b/docs/content/migration/v2-to-v3.md index 08a45d741..e654fb158 100644 --- a/docs/content/migration/v2-to-v3.md +++ b/docs/content/migration/v2-to-v3.md @@ -533,6 +533,8 @@ The default rule matchers syntax is now the v3 one, but for backward compatibili The v2 rule matchers syntax is deprecated and its support will be removed in the next major version. For this reason, we encourage migrating to the new syntax. +By default, the `defaultRuleSyntax` static option is automatically set to `v3`, meaning that the default rule is the new one. + #### New V3 Syntax Notable Changes The `Headers` and `HeadersRegexp` matchers have been renamed to `Header` and `HeaderRegexp` respectively. diff --git a/docs/content/routing/routers/index.md b/docs/content/routing/routers/index.md index 9a4b8c7d0..04d979dda 100644 --- a/docs/content/routing/routers/index.md +++ b/docs/content/routing/routers/index.md @@ -517,10 +517,15 @@ A value of `0` for the priority is ignored: `priority = 0` means that the defaul ### RuleSyntax +_Optional, Default=""_ + In Traefik v3 a new rule syntax has been introduced ([migration guide](../../migration/v2-to-v3.md#router-rule-matchers)). `ruleSyntax` option allows to configure the rule syntax to be used for parsing the rule on a per-router basis. This allows to have heterogeneous router configurations and ease migration. +The default value of the `ruleSyntax` option is inherited from the `defaultRuleSyntax` option in the static configuration. +By default, the `defaultRuleSyntax` static option is `v3`, meaning that the default rule syntax is also `v3`. + ??? example "Set rule syntax -- using the [File Provider](../../providers/file.md)" ```yaml tab="File (YAML)" @@ -870,7 +875,7 @@ The [supported `provider` table](../../https/acme.md#providers) indicates if the ### General -If both HTTP routers and TCP routers listen to the same EntryPoint, the TCP routers will apply *before* the HTTP routers. +If both HTTP routers and TCP routers listen to the same EntryPoint, the TCP routers will apply _before_ the HTTP routers. If no matching route is found for the TCP routers, then the HTTP routers will take over. ### EntryPoints @@ -1217,10 +1222,15 @@ A value of `0` for the priority is ignored: `priority = 0` means that the defaul ### RuleSyntax +_Optional, Default=""_ + In Traefik v3 a new rule syntax has been introduced ([migration guide](../../migration/v2-to-v3.md#router-rule-matchers)). `ruleSyntax` option allows to configure the rule syntax to be used for parsing the rule on a per-router basis. This allows to have heterogeneous router configurations and ease migration. +The default value of the `ruleSyntax` option is inherited from the `defaultRuleSyntax` option in the static configuration. +By default, the `defaultRuleSyntax` static option is `v3`, meaning that the default rule syntax is also `v3`. + ??? example "Set rule syntax -- using the [File Provider](../../providers/file.md)" ```yaml tab="File (YAML)"