Traefik la gi

Welcome¶

Traefik la gi

Traefik is an open-source Edge Router that makes publishing your services a fun and easy experience. It receives requests on behalf of your system and finds out which components are responsible for handling them.

What sets Traefik apart, besides its many features, is that it automatically discovers the right configuration for your services. The magic happens when Traefik inspects your infrastructure, where it finds relevant information and discovers which service serves which request.

Traefik is natively compliant with every major cluster technology, such as Kubernetes, Docker, Docker Swarm, AWS, Mesos, Marathon, and the list goes on; and can handle many at the same time. (It even works for legacy software running on bare metal.)

With Traefik, there is no need to maintain and synchronize a separate configuration file: everything happens automatically, in real time (no restarts, no connection interruptions). With Traefik, you spend time developing and deploying new features to your system, not on configuring and maintaining its working state.

Developing Traefik, our main goal is to make it simple to use, and we're sure you'll enjoy it.

-- The Traefik Maintainer Team

Xin chào mọi người, bài viết này mình lại đề cập đôi chút về Traefik – một phần mềm opensource mà mình đã từng giới thiệu trên Viblo. Thời điểm đó, phiên bản mới nhất của Traefik ở version v1.7. Sau một thời gian dài phát triển thì vào tháng 10 năm 2019, Traefik đã được release phiên bản v2 với rất nhiều thay đổi cũng như cải tiến. Hãy cũng mình khám phá xem Traefik v2 khá khẩm gì hơn qua bài viết này nhé!

Traefik v1.7 – Điểm qua

Điểm qua lại một tẹo! Traefik là một reverse-proxy, thân thiện với kiến trúc micro services – giúp chúng ta dễ dàng hơn trong việc deploy các service của hệ thống. Được sử dụng kết hợp với Docker, K8s… Cấu hình Traefik để publish một web service với Docker thông qua docker label nên việc triển khai khá đơn giản:

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

<span class="token key atrule">version</span><span class="token punctuation">:</span><span class="token string">'3.7'</span>

<span class="token key atrule">services</span><span class="token punctuation">:</span>

  <span class="token key atrule">traefik</span><span class="token punctuation">:</span>

    <span class="token key atrule">image</span><span class="token punctuation">:</span>traefik<span class="token punctuation">:</span>v1.7

    <span class="token key atrule">command</span><span class="token punctuation">:</span>

      <span class="token punctuation">-</span><span class="token punctuation">-</span><span class="token punctuation">-</span>logLevel=INFO

      <span class="token punctuation">-</span><span class="token punctuation">-</span><span class="token punctuation">-</span>api

      <span class="token punctuation">-</span><span class="token punctuation">-</span><span class="token punctuation">-</span>docker

    <span class="token key atrule">volumes</span><span class="token punctuation">:</span>

      <span class="token punctuation">-</span>/var/run/docker.sock<span class="token punctuation">:</span>/var/run/docker.sock<span class="token punctuation">:</span>ro

    <span class="token key atrule">ports</span><span class="token punctuation">:</span>

      <span class="token punctuation">-</span><span class="token datetime number">80:80</span>

    <span class="token key atrule">labels</span><span class="token punctuation">:</span>

      <span class="token punctuation">-</span> traefik.port=8080

      <span class="token punctuation">-</span>traefik.frontend.rule=Host<span class="token punctuation">:</span>traefik.lc

  <span class="token key atrule">ctf</span><span class="token punctuation">:</span>

    <span class="token key atrule">image</span><span class="token punctuation">:</span>containous/whoami<span class="token punctuation">:</span>v1.4.0

    <span class="token key atrule">labels</span><span class="token punctuation">:</span>

      <span class="token punctuation">-</span>traefik.frontend.rule=Host<span class="token punctuation">:</span>ctf.viblo.lc

  <span class="token key atrule">code</span><span class="token punctuation">:</span>

    <span class="token key atrule">image</span><span class="token punctuation">:</span>containous/whoami<span class="token punctuation">:</span>v1.4.0

    <span class="token key atrule">labels</span><span class="token punctuation">:</span>

      <span class="token punctuation">-</span> traefik.frontend.rule=Host<span class="token punctuation">:</span>code.viblo.lc

Bạn có thể dựng thử stack đơn giản ở trên nhé:

docker-compose-ftraefik-v1.yml up-d

Ở Traefik v1.7 thì chúng ta biết tới có ba khái niệm chính đó là Entrypoint, FrontendBackend:

  • Entrypoint: Các điểm kết nối giữa Traefik và “the world” như tên entrypoint, listen port bao nhiêu, ssl hay không?…
  • Frontend: Chứa các khai báo có quy tắc để xác định cách routing sang backend hợp lý.
  • Backend: Mapping tương ứng với service, hỗ trợ loadbalancing.

Traefik v2 bây giờ ngoài support static configuration file ở format TOML thì còn support thêm cả YAML. Nếu bạn là fan của YAML thì quả thực xin chúc mừng nhé!

Trong phần tiếp theo dưới đây chúng ta sẽ cùng khám phá những điều mới trên v2 và migrate stack nhỏ bên trên sang v2.

Provider

Traefik la gi

Mặc dù Traefik v1 cũng support khá nhiều Infrastructure như: Docker, Kubernetes, Amazon ECS… nhưng các cấu hình còn khá rời rạc. Sang v2, tất cả đã được quy về một mối gọi là Provider. Ý tưởng là Traefik sẽ query các API của provider để tìm các thông tin cho việc định tuyến (routing). Các provider được support gồm:

ProviderTypeConfiguration Type
Docker Orchestrator Label
Kubernetes Orchestrator Custom Resource
Consul Catalog Orchestrator Label
Marathon Orchestrator Label
Rancher Orchestrator Label
File Manual TOML/YAML format

Trong bài này, mình sử dụng Traefik + Docker nên mình sẽ dùng provider là Docker. Ngoài ra, một số provider chưa được hỗ trợ nhưng có lẽ sẽ được cung cấp trong thời gian tới gồm:

#Provider
1 Azure Service Fabric
2 BoltDB
3 Consul
4 DynamoDB
5 ECS
6 Etcd
7 Eureka
8 Mesos
9 Zookeeper

Do đó, hãy cân nhắc kỹ lưỡng nếu bạn có dự định upgrade Traefik lên v2 nhé!

Traefik la gi

Frontend, Backend are dead?

Traefik la gi

Ngoài Provider ở trên, Traefik cũng viết lại và tổ chức lại một số các thành phần trong đó có FrontendBackend – Chúng đều đã được khai tử. Và thay thế sẽ là các thành phần mới gồm các router, service và các middleware.

  • Router: Vai trò tương tự như Frontend ở v1 giúp detect xem request sẽ cần điều hướng tới “Service” nào với mỗi router sẽ nhắm vào một service tương ứng.
  • Service: đảm nhận vai trò tương tự Backend ở v1, chỉ cách để incomming request sẽ tới được các service thực tế như mong muốn của Router. Và nó vẫn đi kèm các cấu hình load balancer giống v1.
  • Middleware: Vai trò y chang trong Laravel :v Nó được sử dụng để tinh chỉnh các request trước khi router gửi chúng sang service, hoặc trước response từ services trả về cho client.

Chính vì sự thay đổi lớn này nên toàn bộ các config cho việc routing đều bị thay đổi. Chi tiết các rule/matcher sẽ bị thay đổi như nào ở trang https://docs.traefik.io/routing/routers/#rule. Một số thay đổi matcher để check request cơ bản gồm:

RuleDescription
Headers(key, value) Nếu header chứa key=value
HeadersRegexp(key, regexp) Nếu header có key với value thỏa mãn regex regexp
Host(domain-1, …) Request tới một trong các domain domain-1,…
HostRegexp(traefik.io, {subdomain:[a-z]+}.traefik.io, ...) Request tới domain thỏa mãn bởi regex
Method(GET, ...) Check theo HTTP method
Path(/path, /articles/{category}/{id:[0-9]+}, ...) Kiểm tra nếu URL chưa path trùng khớp với /path hoặc regex
PathPrefix(/products/, /articles/{category}/{id:[0-9]+}) Kiểm tra URL có path bắt đầu bằng /products/ hoặc regex
Query(foo=bar, bar=baz) Nếu request có query string trùng khớp: ?foo=bar hoặc ?bar=baz

Traefik v2 "lột xác"

Cũng chính vì việc tái cấu trúc như trên nên v2 có rất nhiều breaking change với v1. Bây giờ mình sẽ convert cấu hình Traefik v1 lên v2 xem khác bọt gì không nhé!

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

<span class="token key atrule">version</span><span class="token punctuation">:</span><span class="token string">'3.7'</span>

<span class="token key atrule">services</span><span class="token punctuation">:</span>

  <span class="token key atrule">traefik</span><span class="token punctuation">:</span>

    <span class="token key atrule">image</span><span class="token punctuation">:</span>traefik<span class="token punctuation">:</span>v2.1

    <span class="token key atrule">command</span><span class="token punctuation">:</span>

      <span class="token punctuation">-</span><span class="token punctuation">-</span><span class="token punctuation">-</span>log.level=INFO

      <span class="token punctuation">-</span> <span class="token punctuation">-</span><span class="token punctuation">-</span>api.insecure=true

      <span class="token punctuation">-</span><span class="token punctuation">-</span><span class="token punctuation">-</span>providers.docker

    <span class="token key atrule">volumes</span><span class="token punctuation">:</span>

      <span class="token punctuation">-</span>/var/run/docker.sock<span class="token punctuation">:</span>/var/run/docker.sock<span class="token punctuation">:</span>ro

    <span class="token key atrule">ports</span><span class="token punctuation">:</span>

      <span class="token punctuation">-</span><span class="token datetime number">80:80</span>

    <span class="token key atrule">labels</span><span class="token punctuation">:</span>

      <span class="token punctuation">-</span> traefik.http.routers.rule=Host(`traefik.lc`)

  <span class="token key atrule">ctf</span><span class="token punctuation">:</span>

    <span class="token key atrule">image</span><span class="token punctuation">:</span>containous/whoami<span class="token punctuation">:</span>v1.4.0

    <span class="token key atrule">labels</span><span class="token punctuation">:</span>

      <span class="token punctuation">-</span>traefik.http.routers.ctf.rule=Host(`ctf.viblo.lc`)

  <span class="token key atrule">code</span><span class="token punctuation">:</span>

    <span class="token key atrule">image</span><span class="token punctuation">:</span>containous/whoami<span class="token punctuation">:</span>v1.4.0

    <span class="token key atrule">labels</span><span class="token punctuation">:</span>

      <span class="token punctuation">-</span>traefik.http.routers.code.rule=Host(`code.viblo.lc`)

Chạy thử:

docker-compose-ftraefik-v2.yml up-d

Thay vì sử dụng label traefik.frontend.rule=Host:ctf.viblo.lc thì bây giờ chúng ta sẽ sử dụng traefik.http.routers.ctf.rule=Host(ctf.viblo.lc`). Đó là một breaking change trong việc routing. Chúng ta có thể xem các label mới tại trang Docker Provider và Routing with Docker.

Một số docker label rất hay dùng vẫn được giữ nguyên giống v1 như:

  • traefik.enable=true // override lại config exposedByDefault
  • traefik.docker.network=traefik-net // chỉ định rõ docker network

Ngoài ra, Traefik v2 cũng đã lột xác với một bộ áo mới rất hiện đại, bố cục rõ ràng và bắt mắt:

Traefik la gi

Traefik Dashboard

Traefik la gi

Traefik Routers

Traefik la gi

Traefik Service Detail, load lablancer với 5 server

HTTPS redirection

Config để redirect từ HTTP sang HTTPS bị loại bỏ khỏi entryPoints. Thay vào đó, nó sẽ được áp dụng trong Router bằng cách sử dụng một trong các middleware: RedirectRegex hoặc RedirectScheme. Ví dụ sử dụng RedirectScheme với docker:

<span class="token comment"># Redirect to https

<span class="token key atrule">labels</span><span class="token punctuation">:</span>

  <span class="token punctuation">-</span><span class="token string">"traefik.http.middlewares.test-redirectscheme.redirectscheme.scheme=https"</span>

ACME (Let’s Encrypt)

ACME là config để sử dụng Let’s Encrypt để tự động tạo cert key cho https free. Phiên bản này sẽ thay config key acme bằng certificatesResolvers.

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

# static configuration

defaultEntryPoints=["web-secure","web"]

[entryPoints.web]

address=":80"

  [entryPoints.web.redirect]

  entryPoint="webs"

[entryPoints.web-secure]

  address=":443"

  [entryPoints.https.tls]

[acme]

  email="[email protected]"

  storage="acme.json"

  entryPoint="web-secure"

  onHostRule=true

  [acme.httpChallenge]

    entryPoint ="web"

# static configuration

[entryPoints]

  [entryPoints.web]

    address=":80"

  [entryPoints.web-secure]

    address=":443"

[certificatesResolvers.sample.acme]

  email="[email protected]"

  storage="acme.json"

  [certificatesResolvers.sample.acme.httpChallenge]

    # used during the challenge

    entryPoint="web"

Traefik Logs

Có một thay đổi nhỏ đối với cấu hình logs của Traefik. Lưu ý, có nhiều loại cấu hình logs như: Traefik log, access log, metric logs… và phần này mình đang đề cập tới là Traefik log nhé. Ở version 2, tất cả các config cho traefik log bây giờ đã vào trong [log]; logLevel sẽ rút gọn thành level, trông như sau:

logLevel="INFO"

[traefikLog]

    filePath="/path/to/file"

    format="json"

[log]

    level="INFO"

    filePath="/path/to/file"

    format="json"

Tracing

Traefik vẫn implement tuân thủ theo các đặc tả của OpenTracing. V2 sẽ hỗ trợ nhiều distributed tracing system hơn:

Distributed SystemVersion 1Version 2
Jaeger
Traefik la gi
Traefik la gi
Zipkin
Traefik la gi
Traefik la gi
Datadog
Traefik la gi
Traefik la gi
Instana
Traefik la gi
Traefik la gi
Haystack
Traefik la gi
Traefik la gi

Cùng với đó là một thay đổi nhỏ trong config. Key backend sẽ không còn trên version 2:

# static configuration

[tracing]

  backend="jaeger"

  servicename="tracing"

  [tracing.jaeger]

    samplingParam =1.0

    samplingServerURL="http://12.0.0.1:5778/sampling"

    samplingType="const"

    localAgentHostPort="12.0.0.1:6831"

# static configuration

[tracing]

  servicename="tracing"

  [tracing.jaeger]

    samplingParam=1.0

    samplingServerURL ="http://12.0.0.1:5778/sampling"

    samplingType="const"

    localAgentHostPort="12.0.0.1:6831"

Metrics

Metrics trong version 2 sẽ support cho các services. Ngoài ra, Traefik vẫn support metric cho entry point giống version 1. Còn về config thì vẫn giống v1.

# static configuration

[metrics.prometheus]

  buckets=[0.1,0.3,1.2,5.0]

  entryPoint="metrics"

Version 2 vẫn hỗ trợ 4 system gồm:

Backend SystemVersion 1Version 2
Datadog
Traefik la gi
Traefik la gi
InfluxDB
Traefik la gi
Traefik la gi
Prometheus
Traefik la gi
Traefik la gi
StatsD
Traefik la gi
Traefik la gi

Không còn config ở Root Level

Nếu bạn để ý các config thay đổi ở trên thì sẽ nhận ra rằng các key ở root level đều đã bị chuyển vào trong một group nào đó. Thực sự thì phiên bản này đã loại bỏ toàn bộ các key ở root level trong file config. Chẳng hạn:

# static configuration

checkNewVersion=false

sendAnonymousUsage=true

logLevel="DEBUG"

insecureSkipVerify=true

rootCAs= ["/mycert.cert"]

maxIdleConnsPerHost=200

providersThrottleDuration="2s"

AllowMinWeightZero=true

debug=true

defaultEntryPoints =["web","web-secure"]

keepTrailingSlash=false

# static configuration

[global]

  checkNewVersion=true

  sendAnonymousUsage=true

[log]

  level= "DEBUG"

[serversTransport]

  insecureSkipVerify=true

  rootCAs=["/mycert.cert"]

  maxIdleConnsPerHost= 42

[providers]

  providersThrottleDuration=42