Rancher backend

Træfɪk can be configured to use Rancher as a backend configuration:

  1. ################################################################
  2. # Rancher configuration backend
  3. ################################################################
  5. # Enable Rancher configuration backend
  6. #
  7. # Optional
  8. #
  9. [rancher]
  11. # Default domain used.
  12. # Can be overridden by setting the "traefik.domain" label on an service.
  13. #
  14. # Required
  15. #
  16. domain = "rancher.localhost"
  18. # Enable watch Rancher changes
  19. #
  20. # Optional
  21. # Default: true
  22. #
  23. Watch = true
  25. # Expose Rancher services by default in traefik
  26. #
  27. # Optional
  28. # Default: true
  29. #
  30. ExposedByDefault = false
  32. # Endpoint to use when connecting to Rancher
  33. #
  34. # Optional
  35. # Endpoint = "http://rancherserver.example.com"
  37. # AccessKey to use when connecting to Rancher
  38. #
  39. # Optional
  40. # AccessKey = "XXXXXXXXX"
  42. # SecretKey to use when connecting to Rancher
  43. #
  44. # Optional
  45. # SecretKey = "XXXXXXXXXXX"

If you're deploying traefik as a service within rancher, you can alternatively set these labels on the service to let it only fetch data of its current environment. The settings endpoint, accesskey and secretkey can be omitted then.

  • io.rancher.container.create_agent=true

  • io.rancher.container.agent.role=environment
    Labels can be used on task containers to override default behaviour:

  • traefik.protocol=https: override the default http protocol

  • traefik.weight=10: assign this weight to the container
  • traefik.enable=false: disable this container in Træfɪk
  • traefik.frontend.rule=Host:test.traefik.io: override the default frontend rule (Default: Host:{containerName}.{domain}).
  • traefik.frontend.passHostHeader=true: forward client Host header to the backend.
  • traefik.frontend.priority=10: override default frontend priority
  • traefik.frontend.entryPoints=http,https: assign this frontend to entry points http and https. Overrides defaultEntryPoints.