AlbConfig是由ALB Ingress Controller提供的CRD资源,ALB Ingress Controller使用AlbConfig来配置ALB实例和监听。本文介绍如何创建、修改AlbConfig以及开启日志服务等操作。

背景信息

ALB Ingress Controller通过API Server获取Ingress资源的变化,动态地生成AlbConfig,然后依次创建ALB实例、监听、路由转发规则以及后端服务器组。Kubernetes中Service、Ingress与AlbConfig有着以下关系:

  • Service是后端真实服务的抽象,一个Service可以代表多个相同的后端服务。
  • Ingress是反向代理规则,用来规定HTTP/HTTPS请求应该被转发到哪个Service上。例如:根据请求中不同的Host和URL路径,让请求转发到不同的Service上。
  • AlbConfig是在ALB Ingress Controller提供的CRD资源,使用AlbConfig CRD来配置ALB实例和监听。一个AlbConfig对应一个ALB实例。
ALB Ingress

一个AlbConfig对应一个ALB实例,如果一个ALB实例配置多个转发规则,那么一个AlbConfig则对应多个Ingress,所以AlbConfig与Ingress是一对多的对应关系。

创建AlbConfig

一个AlbConfig对应一个ALB实例,如果您需要使用多个ALB实例,可以通过创建多个AlbConfig实现。创建AlbConfig操作如下:

  1. 创建并拷贝以下内容到alb-test.yaml文件中,用于创建AlbConfig。
    apiVersion: alibabacloud.com/v1
    kind: AlbConfig
    metadata:
      name: default
      namespace: kube-system
    spec:
      config:
        name: alb-test
        addressType: Internet
        zoneMappings:
        - vSwitchId: vsw-uf6ccg2a9g71hx8go****
        - vSwitchId: vsw-uf6nun9tql5t8nh15****
    参数 说明
    spec.config.name (可选)表示ALB实例名称。
    addressType (必选)表示负载均衡的地址类型。取值如下:
    • Internet(默认值):负载均衡具有公网IP地址,DNS域名被解析到公网IP,因此可以在公网环境访问。
    • Intranet:负载均衡只有私网IP地址,DNS域名被解析到私网IP,因此只能被负载均衡所在VPC的内网环境访问。
    zoneMappings (必选)用于设置ALB Ingress交换机ID,您需要至少指定两个不同可用区交换机ID。关于ALB Ingress支持的地域与可用区,请参见支持的地域与可用区
  2. 执行以下命令,创建AlbConfig。
    kubectl apply -f alb-test.yaml
    预期输出:
    AlbConfig.alibabacloud.com/default created
  3. 执行以下命令,查看AlbConfig名称。
    kubectl -n kube-system get AlbConfig
    预期输出:
    NAME      AGE
    default   87m
    AlbConfig默认配置的内容如下:
    apiVersion: alibabacloud.com/v1
    kind: AlbConfig
    metadata:
      name: default                      #AlbConfig名称。
      namespace: kube-system             #AlbConfig所属命名空间。
    spec:
      config:
        accessLogConfig:
          logProject: ""
          logStore: ""
        addressAllocatedMode: Dynamic
        addressType: Internet
        billingConfig:
          internetBandwidth: 0
          internetChargeType: ""
          payType: PostPay
        deletionProtectionEnabled: true
        edition: Standard
        forceOverride: false
        zoneMappings:
        - vSwitchId: vsw-wz92lvykqj1siwvif****        #AlbConfig的vSwitch,AlbConfig需要配置两个vSwitch。
        - vSwitchId: vsw-wz9mnucx78c7i6iog****        #AlbConfig的vSwitch。
    status:
      loadBalancer:
        dnsname: alb-s2em8fr9debkg5****.cn-shenzhen.alb.aliyuncs.com
        id: alb-s2em8fr9debkg5****

关联Ingress

AlbConfig通过K8s中标准的IngressClass资源与Ingress进行关联。您需要先创建IngressClass,然后关联AlbConfig。

  1. 创建并拷贝以下内容到alb.yaml文件中,用于创建IngressClass。
    apiVersion: networking.k8s.io/v1beta1
    kind: IngressClass
    metadata:
      name: alb
    spec:
      controller: ingress.k8s.alibabacloud/alb
      parameters:
        apiGroup: alibabacloud.com
        kind: AlbConfig
        name: default
    apiVersion: networking.k8s.io/v1
    kind: IngressClass
    metadata:
      name: alb
    spec:
      controller: ingress.k8s.alibabacloud/alb
      parameters:
        apiGroup: alibabacloud.com
        kind: AlbConfig
        name: default

  2. 执行以下命令,创建IngressClass。
    kubectl apply -f alb.yaml
    预期输出:
    ingressclass.networking.k8s.io/alb created
  3. 在Ingress的YAML中通过ingressClassName参数指定名称为alb的IngressClass,关联AlbConfig。
    apiVersion: networking.k8s.io/v1beta1
    kind: Ingress
    metadata:
      name: cafe-ingress
    spec:
      ingressClassName: alb
      rules:
      - http:
          paths:
          # 配置Context Path。
          - path: /tea
            backend:
              serviceName: tea-svc
              servicePort: 80
          # 配置Context Path。
          - path: /coffee
            backend:
              serviceName: coffee-svc
              servicePort: 80
    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      name: cafe-ingress 
    spec:
      ingressClassName: alb
      rules:
      - http:
          paths:
          # 配置Context Path。
          - path: /tea
            pathType: ImplementationSpecific
            backend:
              service:
                name: tea-svc
                port:
                  number: 80
          # 配置Context Path。
          - path: /coffee
            pathType: ImplementationSpecific
            backend:
              service:
                name: coffee-svc
                port: 
                  number: 80

修改AlbConfig的名称

如果您需要修改AlbConfig的名称,可以执行以下命令。保存之后,新名称自动生效。
kubectl -n kube-system edit AlbConfig default
...
  spec:
    config:
      name: test   #输入修改后的名称。
...

修改AlbConfig的vSwitch配置

如果您需要修改AlbConfig的vSwitch配置。保存之后,新配置自动生效。
kubectl -n kube-system edit AlbConfig default
...
  zoneMappings:
    - vSwitchId: vsw-wz92lvykqj1siwvif****
    - vSwitchId: vsw-wz9mnucx78c7i6iog****
...

开启日志服务访问日志

如果您希望ALB Ingress能够收集访问日志Access Log,则只需要在AlbConfig中指定logProjectlogStore

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: default
  namespace: kube-system
spec:
  config:
    accessLogConfig:
      logProject: "k8s-log-xz92lvykqj1siwvif****"
      logStore: "alb_****"
    ...
说明 logStore命名需要以alb_开头,若指定logStore不存在,系统则会自动创建。
保存命令之后,可以在日志服务控制台,单击目标LogStore,查看收集的访问日志。ALB Ingress日志.png

复用已有ALB实例

如果您希望复用已有ALB实例,只需要创建AlbConfig时指定ALB实例ID即可。
apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: reuse-alb
  namespace: kube-system
spec:
  config:
    id: ****
    forceOverride: false   #表示是否覆盖已有监听,true表示强制覆盖,false表示不覆盖。

使用多个ALB实例

如果您希望使用多个ALB实例,在Ingress中通过spec.ingressClassName指定不同的IngressClass即可。

  1. 创建并拷贝以下内容到alb-demo2.yaml文件中,用于创建AlbConfig。
    apiVersion: alibabacloud.com/v1
    kind: AlbConfig
    metadata:
      name: demo
      namespace: kube-system
    spec:
      config:
        name: alb-demo2        #ALB实例名称。
        addressType: Internet  #负载均衡具有公网IP地址。
        zoneMappings:
        - vSwitchId: vsw-uf6ccg2a9g71hx8go****
        - vSwitchId: vsw-uf6nun9tql5t8nh15****
  2. 执行以下命令,创建AlbConfig。
    kubectl apply -f alb-demo2.yaml
    预期输出:
    AlbConfig.alibabacloud.com/demo created
  3. 创建并拷贝以下内容到alb.yaml文件中,用于创建IngressClass。
    apiVersion: networking.k8s.io/v1beta1
    kind: IngressClass
    metadata:
      name: alb-demo2
    spec:
      controller: ingress.k8s.alibabacloud/alb
      parameters:
        apiGroup: alibabacloud.com
        kind: AlbConfig
        name: demo
    apiVersion: networking.k8s.io/v1
     kind: IngressClass
     metadata:
       name: alb-demo2
     spec:
       controller: ingress.k8s.alibabacloud/alb
       parameters:
         apiGroup: alibabacloud.com
         kind: AlbConfig
         name: demo
  4. 执行以下命令,创建IngressClass。
    kubectl apply -f alb.yaml
    预期输出:
    ingressclass.networking.k8s.io/alb-demo2 created
  5. 在Ingress的YAML中通过ingressClassName指定不同的ALB实例。
    apiVersion: networking.k8s.io/v1beta1
    kind: Ingress
    metadata:
      name: demo
      namespace: default
    spec:
      ingressClassName: alb-demo2
      rules:
        - host: ""
          http:
            paths:
              - backend:
                  serviceName: demo-service
                  servicePort: 80
                path: /hello
                pathType: ImplementationSpecific
    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      name: demo
      namespace: default
    spec:
      ingressClassName: alb-demo2
      rules:
        - host: ""
          http:
            paths:
              - backend:
                 service:
                  name: demo-service
                  port:
                    number: 80
                path: /hello
                pathType: ImplementationSpecific

删除ALB实例

一个ALB实例对应一个AlbConfig, 因此可以通过删除AlbConfig实现删除ALB实例,但前提是先需要删除AlbConfig关联的所有Ingress。

kubectl -n kube-system delete AlbConfig default

default可以替换为您实际需要删除的AlbConfig。