From 37b6edb28c27be634ddef92985e6442ad524b426 Mon Sep 17 00:00:00 2001 From: Dylan Rodgers <94392934+tomatokoolaid@users.noreply.github.com> Date: Fri, 9 Sep 2022 09:17:53 -0600 Subject: [PATCH] Added resources for businesses --- docs/content/getting-started/concepts.md | 2 ++ .../getting-started/configuration-overview.md | 15 +-------------- .../getting-started/install-traefik.md | 15 +-------------- docs/content/getting-started/quick-start.md | 15 +-------------- docs/content/https/acme.md | 19 +++---------------- docs/content/https/overview.md | 2 ++ docs/content/https/tls.md | 2 ++ docs/content/includes/.markdownlint.json | 4 ++++ .../traefik-for-business-applications.md | 16 ++++++++++++++++ docs/content/middlewares/http/headers.md | 2 ++ docs/content/middlewares/http/overview.md | 2 ++ docs/content/middlewares/overview.md | 2 ++ docs/content/operations/dashboard.md | 2 ++ docs/content/providers/docker.md | 15 +-------------- docs/content/providers/file.md | 2 ++ docs/content/providers/kubernetes-crd.md | 2 ++ docs/content/providers/kubernetes-ingress.md | 15 +-------------- docs/content/providers/overview.md | 2 ++ docs/content/routing/entrypoints.md | 15 +-------------- docs/content/routing/overview.md | 2 ++ .../routing/providers/kubernetes-crd.md | 2 ++ .../routing/providers/kubernetes-ingress.md | 2 ++ docs/content/routing/routers/index.md | 15 +-------------- docs/content/routing/services/index.md | 15 +-------------- .../docker-compose/basic-example/index.md | 2 ++ docs/mkdocs.yml | 6 +++--- 26 files changed, 62 insertions(+), 131 deletions(-) create mode 100644 docs/content/includes/.markdownlint.json create mode 100644 docs/content/includes/traefik-for-business-applications.md diff --git a/docs/content/getting-started/concepts.md b/docs/content/getting-started/concepts.md index fb5066927..ea0119837 100644 --- a/docs/content/getting-started/concepts.md +++ b/docs/content/getting-started/concepts.md @@ -39,3 +39,5 @@ You no longer need to create and synchronize configuration files cluttered with !!! question "How does Traefik discover the services?" Traefik is able to use your cluster API to discover the services and read the attached information. In Traefik, these connectors are called [providers](../providers/overview.md) because they _provide_ the configuration to Traefik. To learn more about them, read the [provider overview](../providers/overview.md) section. + +{!traefik-for-business-applications.md!} diff --git a/docs/content/getting-started/configuration-overview.md b/docs/content/getting-started/configuration-overview.md index af8ecc0c2..df67afea7 100644 --- a/docs/content/getting-started/configuration-overview.md +++ b/docs/content/getting-started/configuration-overview.md @@ -94,17 +94,4 @@ All the configuration options are documented in their related section. You can browse the available features in the menu, the [providers](../providers/overview.md), or the [routing section](../routing/overview.md) to see them in action. -!!! question "Using Traefik for Business Applications?" - - If you are using Traefik for commercial applications, - consider the [Enterprise Edition](https://traefik.io/traefik-enterprise/). - You can use it as your: - - - [Kubernetes Ingress Controller](https://traefik.io/solutions/kubernetes-ingress/) - - [Load Balancer](https://traefik.io/solutions/docker-swarm-ingress/) - - [API Gateway](https://traefik.io/solutions/api-gateway/) - - Traefik Enterprise enables centralized access management, - distributed Let's Encrypt, - and other advanced capabilities. - Learn more in [this 15-minute technical walkthrough](https://info.traefik.io/watch-traefikee-demo). +{!traefik-for-business-applications.md!} diff --git a/docs/content/getting-started/install-traefik.md b/docs/content/getting-started/install-traefik.md index caedc2475..4d55152e9 100644 --- a/docs/content/getting-started/install-traefik.md +++ b/docs/content/getting-started/install-traefik.md @@ -179,17 +179,4 @@ And run it: All the details are available in the [Contributing Guide](../contributing/building-testing.md) -!!! question "Using Traefik for Business Applications?" - - If you are using Traefik for commercial applications, - consider the [Enterprise Edition](https://traefik.io/traefik-enterprise/). - You can use it as your: - - - [Kubernetes Ingress Controller](https://traefik.io/solutions/kubernetes-ingress/) - - [Load Balancer](https://traefik.io/solutions/docker-swarm-ingress/) - - [API Gateway](https://traefik.io/solutions/api-gateway/) - - Traefik Enterprise enables centralized access management, - distributed Let's Encrypt, - and other advanced capabilities. - Learn more in [this 15-minute technical walkthrough](https://info.traefik.io/watch-traefikee-demo). +{!traefik-for-business-applications.md!} diff --git a/docs/content/getting-started/quick-start.md b/docs/content/getting-started/quick-start.md index bed7b1ef2..0127337fe 100644 --- a/docs/content/getting-started/quick-start.md +++ b/docs/content/getting-started/quick-start.md @@ -116,17 +116,4 @@ IP: 172.27.0.4 Now that you have a basic understanding of how Traefik can automatically create the routes to your services and load balance them, it is time to dive into [the documentation](/) and let Traefik work for you! -!!! question "Using Traefik for Business Applications?" - - If you are using Traefik for commercial applications, - consider the [Enterprise Edition](https://traefik.io/traefik-enterprise/). - You can use it as your: - - - [Kubernetes Ingress Controller](https://traefik.io/solutions/kubernetes-ingress/) - - [Load Balancer](https://traefik.io/solutions/docker-swarm-ingress/) - - [API Gateway](https://traefik.io/solutions/api-gateway/) - - Traefik Enterprise enables centralized access management, - distributed Let's Encrypt, - and other advanced capabilities. - Learn more in [this 15-minute technical walkthrough](https://info.traefik.io/watch-traefikee-demo). +{!traefik-for-business-applications.md!} diff --git a/docs/content/https/acme.md b/docs/content/https/acme.md index 302fdbf9a..af23dc2d6 100644 --- a/docs/content/https/acme.md +++ b/docs/content/https/acme.md @@ -661,23 +661,10 @@ certificatesResolvers: If Let's Encrypt is not reachable, the following certificates will apply: 1. Previously generated ACME certificates (before downtime) - 1. Expired ACME certificates - 1. Provided certificates + 2. Expired ACME certificates + 3. Provided certificates !!! important For new (sub)domains which need Let's Encrypt authentication, the default Traefik certificate will be used until Traefik is restarted. - -!!! question "Using Traefik for Business Applications?" - If you are using Traefik for commercial applications, - consider the [Enterprise Edition](https://traefik.io/traefik-enterprise/). - You can use it as your: - - - [Kubernetes Ingress Controller](https://traefik.io/solutions/kubernetes-ingress/) - - [Load Balancer](https://traefik.io/solutions/docker-swarm-ingress/) - - [API Gateway](https://traefik.io/solutions/api-gateway/) - - Traefik Enterprise enables centralized access management, - distributed Let's Encrypt, - and other advanced capabilities. - Learn more in [this 15-minute technical walkthrough](https://info.traefik.io/watch-traefikee-demo). +{!traefik-for-business-applications.md!} diff --git a/docs/content/https/overview.md b/docs/content/https/overview.md index 26e147ca2..9261d0db8 100644 --- a/docs/content/https/overview.md +++ b/docs/content/https/overview.md @@ -19,3 +19,5 @@ The next sections of this documentation explain how to configure the TLS connect That is to say, how to obtain [TLS certificates](./tls.md#certificates-definition): either through a definition in the dynamic configuration, or through [Let's Encrypt](./acme.md) (ACME). And how to configure [TLS options](./tls.md#tls-options), and [certificates stores](./tls.md#certificates-stores). + +{!traefik-for-business-applications.md!} diff --git a/docs/content/https/tls.md b/docs/content/https/tls.md index eb498d005..62a5098cc 100644 --- a/docs/content/https/tls.md +++ b/docs/content/https/tls.md @@ -490,3 +490,5 @@ spec: - secretCA clientAuthType: RequireAndVerifyClientCert ``` + +{!traefik-for-business-applications.md!} diff --git a/docs/content/includes/.markdownlint.json b/docs/content/includes/.markdownlint.json new file mode 100644 index 000000000..130b2f29a --- /dev/null +++ b/docs/content/includes/.markdownlint.json @@ -0,0 +1,4 @@ +{ + "extends": "../../.markdownlint.json", + "MD041": false +} diff --git a/docs/content/includes/traefik-for-business-applications.md b/docs/content/includes/traefik-for-business-applications.md new file mode 100644 index 000000000..962ca9ff9 --- /dev/null +++ b/docs/content/includes/traefik-for-business-applications.md @@ -0,0 +1,16 @@ +--- + +!!! question "Using Traefik for Business Applications?" + + If you are using Traefik for commercial applications, + consider the [Enterprise Edition](https://traefik.io/traefik-enterprise/). + You can use it as your: + + - [Kubernetes Ingress Controller](https://traefik.io/solutions/kubernetes-ingress/) + - [Docker Swarm and Docker Enterprise](https://traefik.io/solutions/docker-swarm-ingress/) + - [API Gateway](https://traefik.io/solutions/api-gateway/) + + Traefik Enterprise enables centralized access management, + distributed Let's Encrypt, + and other advanced capabilities. + Learn more in [this 15-minute technical walkthrough](https://info.traefik.io/watch-traefikee-demo). diff --git a/docs/content/middlewares/http/headers.md b/docs/content/middlewares/http/headers.md index 856a38c4a..b31b628ec 100644 --- a/docs/content/middlewares/http/headers.md +++ b/docs/content/middlewares/http/headers.md @@ -469,3 +469,5 @@ The `permissionsPolicy` allows sites to control browser features. Set `isDevelopment` to `true` when developing to mitigate the unwanted effects of the `AllowedHosts`, SSL, and STS options. Usually testing takes place using HTTP, not HTTPS, and on `localhost`, not your production domain. If you would like your development environment to mimic production with complete Host blocking, SSL redirects, and STS headers, leave this as `false`. + +{!traefik-for-business-applications.md!} diff --git a/docs/content/middlewares/http/overview.md b/docs/content/middlewares/http/overview.md index d270ea8c2..8d281f663 100644 --- a/docs/content/middlewares/http/overview.md +++ b/docs/content/middlewares/http/overview.md @@ -157,3 +157,5 @@ http: ## Community Middlewares Please take a look at the community-contributed plugins in the [plugin catalog](https://pilot.traefik.io/plugins). + +{!traefik-for-business-applications.md!} diff --git a/docs/content/middlewares/overview.md b/docs/content/middlewares/overview.md index fad2221a6..90748ef6c 100644 --- a/docs/content/middlewares/overview.md +++ b/docs/content/middlewares/overview.md @@ -129,3 +129,5 @@ http: A list of HTTP middlewares can be found [here](http/overview.md). A list of TCP middlewares can be found [here](tcp/overview.md). + +{!traefik-for-business-applications.md!} diff --git a/docs/content/operations/dashboard.md b/docs/content/operations/dashboard.md index a0f527c53..af1ce1058 100644 --- a/docs/content/operations/dashboard.md +++ b/docs/content/operations/dashboard.md @@ -128,3 +128,5 @@ api: You can now access the dashboard on the port `8080` of the Traefik instance, at the following URL: `http://:8080/dashboard/` (trailing slash is mandatory). + +{!traefik-for-business-applications.md!} diff --git a/docs/content/providers/docker.md b/docs/content/providers/docker.md index 89e5b3d38..f2c60d931 100644 --- a/docs/content/providers/docker.md +++ b/docs/content/providers/docker.md @@ -715,17 +715,4 @@ providers: --providers.docker.tls.insecureSkipVerify=true ``` -!!! question "Using Traefik for Business Applications?" - - If you are using Traefik for commercial applications, - consider the [Enterprise Edition](https://traefik.io/traefik-enterprise/). - You can use it as your: - - - [Kubernetes Ingress Controller](https://traefik.io/solutions/kubernetes-ingress/) - - [Load Balancer](https://traefik.io/solutions/docker-swarm-ingress/) - - [API Gateway](https://traefik.io/solutions/api-gateway/) - - Traefik Enterprise enables centralized access management, - distributed Let's Encrypt, - and other advanced capabilities. - Learn more in [this 15-minute technical walkthrough](https://info.traefik.io/watch-traefikee-demo). +{!traefik-for-business-applications.md!} diff --git a/docs/content/providers/file.md b/docs/content/providers/file.md index 5283cdb25..8abce45d6 100644 --- a/docs/content/providers/file.md +++ b/docs/content/providers/file.md @@ -291,3 +291,5 @@ To illustrate, it is possible to easily define multiple routers, services, and T # ... {{ end }} ``` + +{!traefik-for-business-applications.md!} diff --git a/docs/content/providers/kubernetes-crd.md b/docs/content/providers/kubernetes-crd.md index 8b2a9894d..10e408e0a 100644 --- a/docs/content/providers/kubernetes-crd.md +++ b/docs/content/providers/kubernetes-crd.md @@ -344,3 +344,5 @@ providers: ## Full Example For additional information, refer to the [full example](../user-guides/crd-acme/index.md) with Let's Encrypt. + +{!traefik-for-business-applications.md!} diff --git a/docs/content/providers/kubernetes-ingress.md b/docs/content/providers/kubernetes-ingress.md index 51a771c4b..801820ee2 100644 --- a/docs/content/providers/kubernetes-ingress.md +++ b/docs/content/providers/kubernetes-ingress.md @@ -502,17 +502,4 @@ providers: To learn more about the various aspects of the Ingress specification that Traefik supports, many examples of Ingresses definitions are located in the test [examples](https://github.com/traefik/traefik/tree/v2.8/pkg/provider/kubernetes/ingress/fixtures) of the Traefik repository. -!!! question "Using Traefik for Business Applications?" - - If you are using Traefik for commercial applications, - consider the [Enterprise Edition](https://traefik.io/traefik-enterprise/). - You can use it as your: - - - [Kubernetes Ingress Controller](https://traefik.io/solutions/kubernetes-ingress/) - - [Load Balancer](https://traefik.io/solutions/docker-swarm-ingress/) - - [API Gateway](https://traefik.io/solutions/api-gateway/) - - Traefik Enterprise enables centralized access management, - distributed Let's Encrypt, - and other advanced capabilities. - Learn more in [this 15-minute technical walkthrough](https://info.traefik.io/watch-traefikee-demo). +{!traefik-for-business-applications.md!} diff --git a/docs/content/providers/overview.md b/docs/content/providers/overview.md index 8bacfc7d2..8366d1155 100644 --- a/docs/content/providers/overview.md +++ b/docs/content/providers/overview.md @@ -230,3 +230,5 @@ List of providers that support constraints: - [Kubernetes CRD](./kubernetes-crd.md#labelselector) - [Kubernetes Ingress](./kubernetes-ingress.md#labelselector) - [Kubernetes Gateway](./kubernetes-gateway.md#labelselector) + +{!traefik-for-business-applications.md!} diff --git a/docs/content/routing/entrypoints.md b/docs/content/routing/entrypoints.md index 31f22f24b..f20c0b456 100644 --- a/docs/content/routing/entrypoints.md +++ b/docs/content/routing/entrypoints.md @@ -968,17 +968,4 @@ entrypoints.foo.address=:8000/udp entrypoints.foo.udp.timeout=10s ``` -!!! question "Using Traefik for Business Applications?" - - If you are using Traefik for commercial applications, - consider the [Enterprise Edition](https://traefik.io/traefik-enterprise/). - You can use it as your: - - - [Kubernetes Ingress Controller](https://traefik.io/solutions/kubernetes-ingress/) - - [Load Balancer](https://traefik.io/solutions/docker-swarm-ingress/) - - [API Gateway](https://traefik.io/solutions/api-gateway/) - - Traefik Enterprise enables centralized access management, - distributed Let's Encrypt, - and other advanced capabilities. - Learn more in [this 15-minute technical walkthrough](https://info.traefik.io/watch-traefikee-demo). +{!traefik-for-business-applications.md!} diff --git a/docs/content/routing/overview.md b/docs/content/routing/overview.md index ee3b61b84..b49c9748b 100644 --- a/docs/content/routing/overview.md +++ b/docs/content/routing/overview.md @@ -406,3 +406,5 @@ serversTransport: ## Static configuration --serversTransport.forwardingTimeouts.idleConnTimeout=1s ``` + +{!traefik-for-business-applications.md!} diff --git a/docs/content/routing/providers/kubernetes-crd.md b/docs/content/routing/providers/kubernetes-crd.md index 82aa6021f..80a93953d 100644 --- a/docs/content/routing/providers/kubernetes-crd.md +++ b/docs/content/routing/providers/kubernetes-crd.md @@ -1782,3 +1782,5 @@ If the ServersTransport CRD is defined in another provider the cross-provider fo ## Further Also see the [full example](../../user-guides/crd-acme/index.md) with Let's Encrypt. + +{!traefik-for-business-applications.md!} diff --git a/docs/content/routing/providers/kubernetes-ingress.md b/docs/content/routing/providers/kubernetes-ingress.md index b7aa294f0..02d6e91e5 100644 --- a/docs/content/routing/providers/kubernetes-ingress.md +++ b/docs/content/routing/providers/kubernetes-ingress.md @@ -947,3 +947,5 @@ This will allow users to create a "default router" that will match all unmatched to avoid this global ingress from satisfying requests that could match other ingresses. To do this, use the `traefik.ingress.kubernetes.io/router.priority` annotation (as seen in [Annotations on Ingress](#on-ingress)) on your ingresses accordingly. + +{!traefik-for-business-applications.md!} diff --git a/docs/content/routing/routers/index.md b/docs/content/routing/routers/index.md index e3198e46e..5e80ef04b 100644 --- a/docs/content/routing/routers/index.md +++ b/docs/content/routing/routers/index.md @@ -1322,17 +1322,4 @@ Services are the target for the router. !!! important "UDP routers can only target UDP services (and not HTTP or TCP services)." -!!! question "Using Traefik for Business Applications?" - - If you are using Traefik for commercial applications, - consider the [Enterprise Edition](https://traefik.io/traefik-enterprise/). - You can use it as your: - - - [Kubernetes Ingress Controller](https://traefik.io/solutions/kubernetes-ingress/) - - [Load Balancer](https://traefik.io/solutions/docker-swarm-ingress/) - - [API Gateway](https://traefik.io/solutions/api-gateway/) - - Traefik Enterprise enables centralized access management, - distributed Let's Encrypt, - and other advanced capabilities. - Learn more in [this 15-minute technical walkthrough](https://info.traefik.io/watch-traefikee-demo). +{!traefik-for-business-applications.md!} diff --git a/docs/content/routing/services/index.md b/docs/content/routing/services/index.md index 9ebcea2cd..aaf0a7254 100644 --- a/docs/content/routing/services/index.md +++ b/docs/content/routing/services/index.md @@ -1646,17 +1646,4 @@ udp: address = "private-ip-server-2:8080/" ``` -!!! question "Using Traefik for Business Applications?" - - If you are using Traefik for commercial applications, - consider the [Enterprise Edition](https://traefik.io/traefik-enterprise/). - You can use it as your: - - - [Kubernetes Ingress Controller](https://traefik.io/solutions/kubernetes-ingress/) - - [Load Balancer](https://traefik.io/solutions/docker-swarm-ingress/) - - [API Gateway](https://traefik.io/solutions/api-gateway/) - - Traefik Enterprise enables centralized access management, - distributed Let's Encrypt, - and other advanced capabilities. - Learn more in [this 15-minute technical walkthrough](https://info.traefik.io/watch-traefikee-demo). +{!traefik-for-business-applications.md!} diff --git a/docs/content/user-guides/docker-compose/basic-example/index.md b/docs/content/user-guides/docker-compose/basic-example/index.md index 80f1a6a07..643df4505 100644 --- a/docs/content/user-guides/docker-compose/basic-example/index.md +++ b/docs/content/user-guides/docker-compose/basic-example/index.md @@ -93,3 +93,5 @@ whoami: # Allow request only from the predefined entry point named "web" - "traefik.http.routers.whoami.entrypoints=web" ``` + +{!traefik-for-business-applications.md!} diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml index 03a3f7f5e..87ad026fc 100644 --- a/docs/mkdocs.yml +++ b/docs/mkdocs.yml @@ -55,9 +55,9 @@ markdown_extensions: - pymdownx.tasklist - pymdownx.snippets: check_paths: true -# - markdown_include.include: -# base_path: content/includes/ -# encoding: utf-8 + - markdown_include.include: + base_path: content/includes/ + encoding: utf-8 - toc: permalink: true