[kubernetes]-k8s部署Ingress控制器Traefik v2.1

怼烎@ 2022-10-26 04:00 223阅读 0赞

##### 导语：安装Traefik2 感受一下ingress控制器的魅力 以便后期使用 #####

**系统环境：**

*  Traefik 版本：v2.1.2
 *  Kubernetes 版本：1.18

### kubernetes 部署 Traefik ###

##### 创建 CRD 资源 #####

**traefik-crd.yaml**

#  traefik-crd.yaml 
    ## IngressRoute
    apiVersion: apiextensions.k8s.io/v1beta1
    kind: CustomResourceDefinition
    metadata:
      name: ingressroutes.traefik.containo.us
    spec:
      scope: Namespaced
      group: traefik.containo.us
      version: v1alpha1
      names:
        kind: IngressRoute
        plural: ingressroutes
        singular: ingressroute
    ---
    ## IngressRouteTCP
    apiVersion: apiextensions.k8s.io/v1beta1
    kind: CustomResourceDefinition
    metadata:
      name: ingressroutetcps.traefik.containo.us
    spec:
      scope: Namespaced
      group: traefik.containo.us
      version: v1alpha1
      names:
        kind: IngressRouteTCP
        plural: ingressroutetcps
        singular: ingressroutetcp
    ---
    ## Middleware
    apiVersion: apiextensions.k8s.io/v1beta1
    kind: CustomResourceDefinition
    metadata:
      name: middlewares.traefik.containo.us
    spec:
      scope: Namespaced
      group: traefik.containo.us
      version: v1alpha1
      names:
        kind: Middleware
        plural: middlewares
        singular: middleware
    ---
    ## TLSOption
    apiVersion: apiextensions.k8s.io/v1beta1
    kind: CustomResourceDefinition
    metadata:
      name: tlsoptions.traefik.containo.us
    spec:
      scope: Namespaced
      group: traefik.containo.us
      version: v1alpha1
      names:
        kind: TLSOption
        plural: tlsoptions
        singular: tlsoption
    ---
    ## TraefikService
    apiVersion: apiextensions.k8s.io/v1beta1
    kind: CustomResourceDefinition
    metadata:
      name: traefikservices.traefik.containo.us
    spec:
      scope: Namespaced
      group: traefik.containo.us
      version: v1alpha1
      names:
        kind: TraefikService
        plural: traefikservices
        singular: traefikservice

##### **创建 Traefik CRD 资源** #####

kubectl apply -f traefik-crd.yaml

##### 创建 RBAC 权限 #####

kubernetes 在 1.6 版本中引入了基于角色的访问控制（RBAC）策略，方便对 Kubernetes 资源和 API 进行细粒度控制。Traefik 需要一定的权限，所以这里提前创建好 Traefik ServiceAccount 并分配一定的权限。

**traefik-rbac.yaml**

# traefik-rbac.yaml 
    ## ServiceAccount
    apiVersion: v1
    kind: ServiceAccount
    metadata:
      namespace: kube-system
      name: traefik-ingress-controller
    ---
    ## ClusterRole
    kind: ClusterRole
    apiVersion: rbac.authorization.k8s.io/v1beta1
    metadata:
      name: traefik-ingress-controller
    rules:
      - apiGroups: [""]
        resources: ["services","endpoints","secrets"]
        verbs: ["get","list","watch"]
      - apiGroups: ["extensions"]
        resources: ["ingresses"]
        verbs: ["get","list","watch"]
      - apiGroups: ["extensions"]
        resources: ["ingresses/status"]
        verbs: ["update"]
      - apiGroups: ["traefik.containo.us"]
        resources: ["middlewares"]
        verbs: ["get","list","watch"]
      - apiGroups: ["traefik.containo.us"]
        resources: ["ingressroutes"]
        verbs: ["get","list","watch"]
      - apiGroups: ["traefik.containo.us"]
        resources: ["ingressroutetcps"]
        verbs: ["get","list","watch"]
      - apiGroups: ["traefik.containo.us"]
        resources: ["tlsoptions"]
        verbs: ["get","list","watch"]
      - apiGroups: ["traefik.containo.us"]
        resources: ["traefikservices"]
        verbs: ["get","list","watch"]
    ---
    ## ClusterRoleBinding
    kind: ClusterRoleBinding
    apiVersion: rbac.authorization.k8s.io/v1beta1
    metadata:
      name: traefik-ingress-controller
    roleRef:
      apiGroup: rbac.authorization.k8s.io
      kind: ClusterRole
      name: traefik-ingress-controller
    subjects:
      - kind: ServiceAccount
        name: traefik-ingress-controller
        namespace: kube-system

**创建 Traefik RBAC 资源**

*  \-n：指定部署的 Namespace

kubectl apply -f traefik-rbac.yaml -n kube-system

##### 创建 Traefik 配置文件 #####

**traefik-config.yaml**

kind: ConfigMap
    apiVersion: v1
    metadata:
      name: traefik-config
    data:
      traefik.yaml: |-
        ping: ""                    ## 启用 Ping
        serversTransport:
          insecureSkipVerify: true  ## Traefik 忽略验证代理服务的 TLS 证书
        api:
          insecure: true            ## 允许 HTTP 方式访问 API
          dashboard: true           ## 启用 Dashboard
          debug: false              ## 启用 Debug 调试模式
        metrics:
          prometheus: ""            ## 配置 Prometheus 监控指标数据，并使用默认配置
        entryPoints:
          web:
            address: ":80"          ## 配置 80 端口，并设置入口名称为 web
          websecure:
            address: ":443"         ## 配置 443 端口，并设置入口名称为 websecure
        providers:
          kubernetesCRD: ""         ## 启用 Kubernetes CRD 方式来配置路由规则
          kubernetesIngress: ""     ## 启动 Kubernetes Ingress 方式来配置路由规则
        log:
          filePath: ""              ## 设置调试日志文件存储路径，如果为空则输出到控制台
          level: error              ## 设置调试日志级别
          format: json              ## 设置调试日志格式
        accessLog:
          filePath: ""              ## 设置访问日志文件存储路径，如果为空则输出到控制台
          format: json              ## 设置访问调试日志格式
          bufferingSize: 0          ## 设置访问日志缓存行数
          filters:
            #statusCodes: ["200"]   ## 设置只保留指定状态码范围内的访问日志
            retryAttempts: true     ## 设置代理访问重试失败时，保留访问日志
            minDuration: 20         ## 设置保留请求时间超过指定持续时间的访问日志
          fields:                   ## 设置访问日志中的字段是否保留（keep 保留、drop 不保留）
            defaultMode: keep       ## 设置默认保留访问日志字段
            names:                  ## 针对访问日志特别字段特别配置保留模式
              ClientUsername: drop  
            headers:                ## 设置 Header 中字段是否保留
              defaultMode: keep     ## 设置默认保留 Header 中字段
              names:                ## 针对 Header 中特别字段特别配置保留模式
                User-Agent: redact
                Authorization: drop
                Content-Type: keep

**创建 Traefik ConfigMap 资源**

kubectl apply -f traefik-config.yaml -n kube-system

##### 节点设置 Label 标签 #####

*  格式：kubectl label nodes \[节点名\] \[key=value\]

kubectl label nodes op-jmx-n01 IngressProxy=true

**查看节点是否设置 Label 成功**

kubectl get nodes --show-labels

![53eb95d5c5069292a7cfad5acf55a486.png][]

##### DaemonSet 部署 Traefik #####

*  用 DaemonSet 方式部署，便于在多服务器间扩展，用 hostport 方式占用服务器 80、443 端口，方便流量进入。

**traefik-deploy.yaml**

# traefik-deploy.yaml
    apiVersion: v1
    kind: Service
    metadata:
      name: traefik
    spec:
      ports:
        - name: web
          port: 80
        - name: websecure
          port: 443
        - name: admin
          port: 8080
      selector:
        app: traefik
    ---
    apiVersion: apps/v1
    kind: DaemonSet
    metadata:
      name: traefik-ingress-controller
      labels:
        app: traefik
    spec:
      selector:
        matchLabels:
          app: traefik
      template:
        metadata:
          name: traefik
          labels:
            app: traefik
        spec:
          serviceAccountName: traefik-ingress-controller
          terminationGracePeriodSeconds: 1
          containers:
            - image: traefik:v2.1.2
              name: traefik-ingress-lb
              ports:
                - name: web
                  containerPort: 80
                  hostPort: 80         ## 将容器端口绑定所在服务器的 80 端口
                - name: websecure
                  containerPort: 443
                  hostPort: 443        ## 将容器端口绑定所在服务器的 443 端口
                - name: admin
                  containerPort: 8080  ## Traefik Dashboard 端口
              resources:
                limits:
                  cpu: 2000m
                  memory: 1024Mi
                requests:
                  cpu: 1000m
                  memory: 1024Mi
              securityContext:
                capabilities:
                  drop:
                    - ALL
                  add:
                    - NET_BIND_SERVICE
              args:
                - --configfile=/config/traefik.yaml
              volumeMounts:
                - mountPath: "/config"
                  name: "config"
          volumes:
            - name: config
              configMap:
                name: traefik-config 
          tolerations:              ## 设置容忍所有污点，防止节点被设置污点
            - operator: "Exists"
          nodeSelector:             ## 设置node筛选器，在特定label的节点上启动
            IngressProxy: "true"

**部署 Traefik**

kubectl apply -f traefik-deploy.yaml -n kube-system

![7df3ae037b13435c0b7846713e64a766.png][]

### Traefik 路由规则配置 ###

##### 配置 HTTP 路由规则 （Traefik Dashboard 为例） #####

Traefik 应用已经部署完成，但是想让外部访问 Kubernetes 内部服务，还需要配置路由规则，这里开启了 Traefik Dashboard 配置，所以首先配置 Traefik Dashboard 看板的路由规则，使外部能够访问 Traefik Dashboard。

**创建 Traefik Dashboard 路由规则文件 traefik-dashboard-route.yaml**

# traefik-dashboard-route.yaml
    apiVersion: traefik.containo.us/v1alpha1
    kind: IngressRoute
    metadata:
      name: traefik-dashboard-route
    spec:
      entryPoints:
        - web
      routes:
      # 这里设置你的域名
        - match: Host(`traefik.mydlq.club`)
          kind: Rule
          services:
            - name: traefik
              port: 8080

**创建 Traefik Dashboard 路由规则对象**

kubectl apply -f traefik-dashboard-route.yaml -n kube-system

**配置 Hosts**，客户端想通过域名访问服务，必须要进行 DNS 解析，由于这里没有 DNS 服务器进行域名解析，所以修改 hosts 文件将 Traefik 指定节点的 IP 和自定义 host 绑定。

# vi /etc/hosts
    192.168.1.121 traefik.mydlq.club

**配置完成后，打开浏览器输入地址：http://\**traefik\**.mydlq.club 打开 Traefik Dashboard。**

![3ddd86e95c6016da91a44df02d30a728.png][]

### traefik-migration-tool将 Ingress 对象转换成新的 IngressRoute 格式 ###

选择一台主机 下载traefik-migration-tool 最好装在master上

cd /opt
    wget https://github.com/traefik/traefik-migration-tool/releases/download/v0.13.1/traefik-migration-tool_v0.13.1_linux_386.tar.gz
    tar zxvf traefik-migration-tool_v0.13.1_linux_386.tar.gz

# ingress 文件夹
    mkdir test 
    # 转换后的
    mkdir out
    
    
    # 创建ingress文件 
    cat  >/opt/test/jenkins-ingress.yaml <<EOF
    apiVersion: extensions/v1beta1
    kind: Ingress
    metadata:
    # 通过添加下面的annotations 来开启白名单
    # 关闭80强制跳转443 为ingress配置增加注解（annotations）：nginx.ingress.kubernetes.io/ssl-redirect: 'false' 就可以禁止http强制跳转至https
      annotations:
        #nginx.ingress.kubernetes.io/whitelist-source-range: "60.191.70.64/29, xx.xxx.0.0/16"
        nginx.ingress.kubernetes.io/ssl-redirect: 'false'
      name: test-jenkins
      namespace: devops
    spec:
      tls:
       - hosts:
         - test-jenkins.ihaozhuo.com
        # secretName: aircourses
      rules:
        - host: test-jenkins.ihaozhuo.com
          http:
            paths:
            - path: /
              backend:
                serviceName: test-jenkins
                servicePort: 80
    
    EOF

##### 执行转换 #####

./traefik-migration-tool ingress -i test -o out

##### 查看转换后的文件 #####

cd /opt/out
    cat test/jenkins-ingress.yaml

![59ab3150ff2db19665237ab228f00c46.png][]

##### 将文件拷贝到master进行语法校验 #####

# node
    scp test/jenkins-ingress.yaml  op-jmx-m01:/tmp/
    
    # master
    kubectl apply -f /tmp/jenkins-ingress.yaml --dry-run

![2610db35586ee8faae77a3ade6d48617.png][]

参考文档

http://www.mydlq.club/article/58/

https://github.com/traefik/traefik-migration-tool/blob/master/docs/traefik-migration-tool\_ingress.md

[53eb95d5c5069292a7cfad5acf55a486.png]: /images/20221024/0f329ade28624f92a41fe0e7a2d402e7.png
[7df3ae037b13435c0b7846713e64a766.png]: /images/20221024/3a536a130fb44ff9b131f346305f9544.png
[3ddd86e95c6016da91a44df02d30a728.png]: /images/20221024/c511e4e51f3a4bb792d130ef126c1ff0.png
[59ab3150ff2db19665237ab228f00c46.png]: /images/20221024/8e81b11dadca4745bdc8bead57a060a9.png
[2610db35586ee8faae77a3ade6d48617.png]: /images/20221024/454221e031a240d0a2bf0be6e98e1f28.png