Documentation

Welcome to the Traefik Playground! This tool allows you to experiment with Traefik dynamic configurations and observe how HTTP requests are handled. It provides a safe and interactive environment to test configurations as if you were using the Traefik file provider. Below, you will find an overview of how the playground works and how to use it effectively.

Overview

The Traefik Playground simulates a Traefik instance where you can:

• Define and test dynamic configurations.
• Send HTTP requests (method, URL, headers, and body).
• View responses from an upstream server and inspect the HTTP request as received by the upstream server.

Important Notes:

• The playground uses a preconfigured static configuration:

  
  entryPoints:
    web:
      address: ":80"
            

• The playground is preconfigured with the service whoami@playground. You can create your own service and use http://10.10.10.10 as its server
• The upstream server always responds with an HTTP 418 (Teapot) status and includes the HTTP request it received in the response body.
• Each "Run" starts with a fresh simulated Traefik instance. No state is retained between runs.
• The simulated Traefik instance is isolated and cannot communicate with the outside world.

How It Works

Input Panel

In the left-hand panel, you can input your dynamic configuration using the Traefik file provider syntax. This configuration determines how Traefik will handle incoming requests during the simulation.

Request Panel

In the right-hand panel, you can define an HTTP request to be sent to the simulated Traefik instance. Specify the following:

• Method: The HTTP method (e.g., GET, POST).
• URL: The target URL for the request.
• Headers: Key-value pairs for request headers.
• Body: The payload for the request (if applicable).

Output Panel

The output panel displays the result of your "Run" in two sections:

1. Response from the Upstream Server: The response generated by whoami@playground.
2. HTTP Request as Received: A detailed view of how the upstream server interpreted the request sent through Traefik.

This allows you to see both the final response and any transformations applied to the request by Traefik.

We hope you enjoy using the Traefik Playground! If you encounter any issues or have suggestions for improvement, feel free to reach out.