ALB Ingress 基于火山引擎应用型负载均衡（Application Load Balancer，ALB），提供更加丰富的七层负载均衡能力。本文主要介绍通过 YAML 文件创建 ALBInstance，并配置 ALB Ingress 的相关操作。

背景信息

ALBInstance 是 ALB Ingress Controller 管理的 CRD 资源，ALB Ingress Controller 使用 ALBInstance 来配置和监听 ALB 实例。

使用限制

• 请勿擅自在 ALB 控制台上更改通过创建 ALB Ingress 维护的 ALB 实例、监听器、后端服务器组和转发规则，否则将造成集群中的 Ingress 服务异常，须自行承担责任。
• 请勿修改监听器和后端服务器组的名称中带有k8s_前缀的内容。
• 请勿修改转发规则描述中带有k8s_前缀的内容。
• 若在 ALB 控制台上修改 ALB Ingress 指定或维护的资源和配置（例如：转发规则），可能存在配置被覆盖的风险。
• 当 ALBInstance 中listeners字段的内容发生变化时，系统会自动调谐更新监听器与证书。
• 当不同 ALBInstance 针对同一个域名提供了不同证书 ID 时，如果该域名已存在证书，则系统会根据 ALBInstance 指定证书的状态选择是否更新证书，包括：
  • 如果 ALBInstance 指定的证书不存在，则不会更新。
  • 如果 ALBInstance 指定的证书已过期，则不会更新。
  • 如果 ALB Ingress 指定的证书已存在且未过期，则会更新证书。
• 使用应用型负载均衡（Application Load Balancer，ALB）产品，会产生云基础资源使用费用。详细信息，请参见 应用型负载均衡产品计费。

前提条件

• 已创建集群，详情请参见 创建集群。
• 已连接集群，详情请参见 连接集群。
• （可选）配置 HTTPS 协议的 ALB Ingress 时，需要提前完成证书配置。详情请参见 证书管理。
• （可选）如需使用证书中心的证书，请首先登录您的火山引擎账号，然后单击 服务授权，并在弹出的页面中单击 立即授权，完成跨服务授权。

创建 ALBInstance

对接已有 ALB 实例

使用如下 YAML 配置，创建 ALBInstance 并对接已有 ALB 实例。

apiVersion: loadbalancer.vke.volcengine.com/v1beta1
kind: ALBInstance
metadata:
  name: alb # ALBInstance 资源名称
spec:
  instanceID: "alb-2dgns526uiv41fi5***" # 已有 ALB 实例的 ID。
  listeners:
  - protocol: "HTTP" # 监听器的协议
    port: 80 # 监听器协议为 HTTP 时的监听端口
  - protocol: "HTTPS" # 监听器的协议
    port: 443 # 监听器协议为 HTTPS 时的监听端口
    certificateSource: "cert_center" # 监听器证书来源，取值：alb（ALB）、cert_center（证书中心）
    certificateID: "cert-2wx20lm7uquww7oot***" # 监听器协议为 HTTPS 时默认全域名使用的服务器证书
    domainExtensions:
    - domain: "example.com" # 监听器协议为 HTTPS 时支持指定域名绑定服务器证书
      certificateSource: "cert_center" # 监听器证书来源，取值：alb（ALB）、cert_center（证书中心）
      certificateID: "cert-2wx20lo6vuww07oot***" # 监听器协议为 HTTPS 时支持指定域名绑定服务器证书
    enableHTTP2: true
    enableQUIC: true

spec字段中的详细参数说明如下所示。

新建 ALB 实例

使用如下 YAML 配置，创建 ALBInstance 并同时创建新的 ALB 实例。

apiVersion: loadbalancer.vke.volcengine.com/v1beta1
kind: ALBInstance
metadata:
  name: alb # ALBInstance 资源名称
spec:
  instance:
    name: "demo-alb" # ALB 实例名称
    zoneMappings: # ALB 实例位于多可用区的子网列表
    - subnetId: "subnet-bp12mw1f8k3jg0****" # 子网 ID，用于 ALB 实例在此可用区下的私网 IP 地址分配
    - subnetId: "subnet-bp12mw1f8k3jg1****" 
    addressType: "public" # 负载均衡类型。取值：public（公网类型）、 private（私网类型）
    eipSpec:
      isp: "BGP" # 公网负载均衡实例的 EIP 线路类型。取值：BGP
      bandwidth: 10 # 带宽上限。当 billingType 为 2 时，取值范围为 1～500Mbps；当 billingType 为 3 时，取值范围为 1～200Mbps
      billingType: 2 # 计费类型。取值：2（按量计费-按带宽上限）、3（按量计费-按实际流量）
      bandwidthPackageID: "bwp-2d63yyj3ki4u858oz***" # 共享带宽资源包 ID
    ipVersion: "ipv4" # IP 版本。取值：ipv4
    deleteProtection: "on" # ALB 实例的删除保护功能，on 表示开启，off 表示关闭
  blockCascadeDeletion: true # 删除 ALB Ingress 时，是否同步删除 ALBInstance
  listeners:
  - protocol: "HTTP" # 监听器的协议
    port: 80 # 监听器协议为 HTTP 时的监听端口
  - protocol: "HTTPS" # 监听器的协议
    port: 443 # 监听器协议为 HTTPS 时的监听端口
    certificateSource: "cert_center" # 监听器证书来源，取值：alb（ALB）、cert_center（证书中心）
    certificateID: "cert-2wx20lm7uquww7oot********" # 监听器协议为 HTTPS 时默认全域名使用的服务器证书
    domainExtensions:
    - domain: "test.com" # 监听器协议为 HTTPS 时支持指定域名绑定服务器证书
      certificateSource: "cert_center" # 监听器证书来源，取值：alb（ALB）、cert_center（证书中心）
      certificateID: "cert-2wx20lo6vuww07oot********" # 监听器协议为 HTTPS 时支持指定域名绑定服务器证书
    enableHTTP2: true
    enableQUIC: true

spec字段中的详细参数说明如下所示。

查看 ALBInstance 名称和状态

当您在集群中创建 ALBInstance 后，可以使用如下方法确定 ALBInstance 的状态。

1. 登录 容器服务控制台。

2. 单击左侧导航栏中的 集群。

3. 在集群列表页面，单击目标集群。

4. 在集群管理页面的左侧导航栏中，选择 工作负载 > 对象浏览器。

5. 在 对象浏览器 页面的 CRD 分类下，单击 albinstance。
   

6. 在 albinstance 详情页面，查看创建的 ALBInstance 资源名称。
   

7. 单击 操作 栏中的 编辑 Yaml，查看 ALBInstance 资源详情。其中status字段展示了 ALBInstance 资源的状态信息。
   

   status字段中不同的取值含义如下表所示。

   字段	类型	含义
   phase	String	表示 ALBInstance 资源状态： Pending：表示关联的 ALBInstance 还未调谐完成。 Running：表示 ALBInstance 对应的配置都已经更新到服务端。 Configuring：表示 ALBInstance 处于调谐中。 Deleting：表示 ALBInstance 处于删除中。
   instanceID	String	表示关联的 ALB 实例 ID。
   ingress	*v1.LoadBalancerIngress	表示 ALB 的 IP 地址、监听器端口和协议。

创建 ALB Ingress

基于域名转发

ALB Ingress 支持将不同的域名访问，转发到不同的后端。示例alb-ingress.yaml代码如下：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress # 路由规则的名称
  namespace: default  # 路由规则所属的命名空间
spec:
  ingressClassName: alb  # ALBInstance 资源名称
  rules:
    - host: first.example.com  # 需要对外提供访问的域名
      http:
        paths:
        - pathType: Prefix # 路径匹配规则，默认为 Prefix（前缀匹配）
          path: / # 请求匹配的路径
          backend:
            service:
              name: service-demo-a # 需要对接的服务名称
              port: 
                number: 80 # 需要对接服务的端口号
    - host: second.example.com  # 需要对外提供访问的域名
      http:
        paths:
        - pathType: Prefix # 路径匹配规则。取值：Exact（精确匹配）、Prefix（前缀匹配）
          path: / # 请求匹配的路径
          backend:
            service:
              name: service-demo-b # 需要对接的服务名称
              port: 
                number: 80 # 需要对接服务的端口号

基于路径转发

ALB Ingress 支持将相同域名、不同路径的访问，转发到不同的后端。示例alb-ingress.yaml代码如下：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress # 路由规则的名称
  namespace: default  # 路由规则所属的命名空间
spec:
  ingressClassName: alb  # ALBInstance 资源名称
  rules:
    - host: example.com  # 需要对外提供访问的域名
      http:
        paths:
        - path: /foo # 请求匹配的路径
          pathType: Prefix # 路径匹配规则，默认为 Prefix（前缀匹配）
          backend:
            service:
              name: service-demo-a # 需要对接的服务名称
              port: 
                number: 80 # 需要对接服务的端口号
        - path: /bar # 请求匹配的路径
          pathType: Prefix # 路径匹配规则，默认为 Prefix（前缀匹配）
          backend:
            service:
              name: service-demo-b # 需要对接的服务名称
              port: 
                number: 80 # 需要对接服务的端口号

配置未指定 host 规则

ALB Ingress 支持配置未指定 host 规则。示例alb-ingress.yaml代码如下：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress # 路由规则的名称
  namespace: default  # 路由规则所属的命名空间
spec:
  ingressClassName: alb  # ALBInstance 资源名称
  rules:
    - host: first.example.com  # 需要对外提供访问的域名
      http:
        paths:
        - pathType: Prefix # 路径匹配规则，默认为 Prefix（前缀匹配）
          path: / # 请求匹配的路径
          backend:
            service:
              name: service-demo-a # 需要对接的服务名称
              port: 
                number: 80 # 需要对接服务的端口号
    - host: second.example.com  # 需要对外提供访问的域名
      http:
        paths:
        - pathType: Prefix # 路径匹配规则，默认为 Prefix（前缀匹配）
          path: / # 请求匹配的路径
          backend:
            service:
              name: service-demo-b # 需要对接的服务名称
              port: 
                number: 80 # 需要对接服务的端口号
    - http:
       paths:
       - pathType: Prefix
         path: /
         backend:
           service:
             name: service-demo
             port:
               number: 80

配置默认转发规则的后端服务器

示例alb-ingress.yaml代码如下：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress # 路由规则的名称
  namespace: default  # 路由规则所属的命名空间
spec:
  ingressClassName: alb  # ALBInstance 资源名称
  rules:
    - http:
       paths:
       - pathType: Prefix
         path: /
         backend:
           service:
             name: service-demo
             port:
               number: 80

匹配正则表达式路径

ALB Ingress 支持在 path 路径上定义正则表达式路径或非正则表达式路径，如下表所示。

示例alb-ingress.yaml代码如下：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default 
spec:
  ingressClassName: alb
  rules:
    - host: example.com
      http:
        paths:
        - path: /~/test/[a-z]* # 使用正则表达式匹配路径
          pathType: Prefix
          backend:
            service:
              name: service-demo
              port: 
                number: 80