Container Service for Kubernetes:Expor serviços com ALB e Gateway API

Contexto

A Gateway API é um conjunto de recursos no Kubernetes para modelar o tráfego de rede de serviços. O objetivo é criar um modelo de rede de serviços expressivo, extensível e orientado a funções.

A Gateway API consiste em uma coleção de recursos no Kubernetes destinada à modelagem de tráfego de rede. Seu propósito é fornecer um modelo de rede de serviços expressivo, extensível e orientado a papéis.

O ALB Ingress Controller oferece suporte à Gateway API desde a versão 2.17.0. Instale o ALB Ingress Controller para expor serviços por meio de um ALB utilizando a Gateway API.

O ALB Ingress Controller fornece suporte para a Gateway API na versão 2.17.0 e posteriores. Instale o ALB Ingress Controller para utilizar a Gateway API e expor serviços através de um ALB.

Pré-requisitos

• Você criou um cluster gerenciado ACK executando Kubernetes 1.24 ou posterior.

• Instalou o ALB Ingress Controller versão 2.17 ou superior no cluster.

• Instalou a Gateway API versão 1.1.0 ou superior no cluster.

• Criou dois vSwitches compatíveis com ALB na Virtual Private Cloud (VPC) do cluster.

Pré-requisitos

• Você criou um cluster ACS executando Kubernetes 1.31 ou posterior.

• Instalou o ALB Ingress Controller versão 2.17 ou superior no cluster.

• Instalou a Gateway API versão 1.3.0 ou superior no cluster.

• Criou dois vSwitches compatíveis com ALB na Virtual Private Cloud (VPC) do cluster.

Verifique o ambiente

Se o cluster atender aos pré-requisitos, um recurso GatewayClass chamado alb será criado automaticamente. Siga os passos abaixo para confirmar essa configuração.

kubectl get gatewayclass

NAME   CONTROLLER                         ACCEPTED   AGE
alb    gateways.alibabacloud.com/alb/v1   True       1m

Implantar uma aplicação de exemplo

1. Crie um arquivo chamado httpbin.yaml.

   Nota

   Por padrão, o Service da aplicação neste tópico utiliza o tipo ClusterIP. Caso o tipo de rede do seu cluster seja Flannel, altere o campo spec.type do Service para NodePort.

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: go-httpbin
     namespace: default
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: go-httpbin
     template:
       metadata:
         labels:
           app: go-httpbin
           version: v1
       spec:
         containers:
           - image: registry.cn-hangzhou.aliyuncs.com/mse/go-httpbin
             args:
               - "--port=8090"
               - "--version=v1"
             imagePullPolicy: Always
             name: go-httpbin
             ports:
               - containerPort: 8090
   ---
   apiVersion: v1
   kind: Service
   metadata:
     name: go-httpbin
     namespace: default
   spec:
     type: ClusterIP 
     ports:
       - port: 80
         targetPort: 8090
         protocol: TCP
     selector:
       app: go-httpbin

2. Implante a aplicação.

   kubectl apply -f httpbin.yaml

Implantar o Gateway e as rotas

1. Crie um arquivo chamado gateway.yaml.

   apiVersion: gateway.networking.k8s.io/v1
   kind: Gateway
   metadata:
     name: alb
     namespace: default
   spec:
     gatewayClassName: alb
     listeners:
       - name: http
         protocol: HTTP
         port: 80
         hostname: "*.ingress.top"
         allowedRoutes:
           namespaces:
             from: Same
   ---
   apiVersion: gateway.networking.k8s.io/v1beta1
   kind: HTTPRoute
   metadata:
     name: demo-route
   spec:
     parentRefs: # Reference the Gateway resource.
       - group: gateway.networking.k8s.io
         kind: Gateway
         name: alb
     hostnames:
       - demo.ingress.top # Set the hostname to demo.ingress.top.
     rules:
       - matches: # The matching rule is a path prefix match.
           - path:
               type: PathPrefix
               value: /
         backendRefs: # The backend is a Service named go-httpbin on port 80.
           - kind: Service
             name: go-httpbin
             port: 80

2. Implante o Gateway e as regras de roteamento.

   kubectl apply -f gateway.yaml

3. Aguarde cerca de 2 minutos e verifique o status do Gateway.

   kubectl get gateway alb

   Saída esperada:

   NAME   CLASS   ADDRESS                                                  PROGRAMMED   AGE
   alb    alb     alb-0mwhq4ck6xxxxxxxxx.cn-hangzhou.alb.aliyuncsslb.com   True         2m12s

4. Verifique o status da rota.

   kubectl describe httproute demo-route|grep Status -A 20

   Saída esperada:

   Status:
     Parents:
       Conditions:
         Last Transition Time:  2025-05-23T08:21:25Z
         Message:               Route is accepted.
         Observed Generation:   1
         Reason:                Accepted
         Status:                True
         Type:                  Accepted
         Last Transition Time:  2025-05-23T08:21:25Z
         Message:               Route is resolved.
         Observed Generation:   1
         Reason:                ResolvedRefs
         Status:                True
         Type:                  ResolvedRefs
       Controller Name:         gateways.alibabacloud.com/alb/v1
       Parent Ref:
         Group:  gateway.networking.k8s.io
         Kind:   Gateway
         Name:   alb

5. Teste o acesso à aplicação.

   1. Obtenha o endereço do Gateway.

      export ALB_DOMAIN=$(kubectl get gateway alb -n default -o jsonpath='{.status.addresses[?(@.type=="Hostname")].value}')

   2. Acesse a aplicação.

      curl -H "Host: demo.ingress.top" http://${ALB_DOMAIN}/version

      Saída esperada:

      version: v1
      hostname: go-httpbin-547xxxxxf6-xxxxx

Casos de uso

Operações relacionadas