Container Service for Kubernetes:configure alb listeners using albconfig

Pré-requisitos

Antes de começar, verifique se você tem:

• Dois vSwitches em zonas diferentes, na mesma VPC do cluster e em zonas compatíveis com ALB. Para mais informações, consulte Criar e gerenciar vSwitches.

• O controlador de Ingress do ALB instalado no cluster. Para mais informações, consulte Gerenciar o controlador de Ingress do ALB.

  Para usar um Ingress do ALB e acessar serviços implantados em um cluster ACK dedicado, conceda primeiro ao cluster as permissões necessárias para o controlador de Ingress do ALB. Para mais informações, consulte Conceder acesso de um cluster ACK dedicado ao controlador de Ingress do ALB .

• Um recurso AlbConfig. Para mais informações, consulte Criar AlbConfig.

Parâmetros do listener

A tabela a seguir lista todos os parâmetros disponíveis em spec.listeners de um AlbConfig.

Comportamento de atualização do campo listeners

Como o campo listeners é um array, sua atualização ocorre por substituição completa: a nova configuração substitui integralmente a existente. Compreender esse comportamento ajuda a prever o resultado ao aplicar um AlbConfig atualizado.

listeners:
- port: 8001
  protocol: HTTP
- port: 8003
  protocol: HTTP
- port: 8005     # New — will be added
  protocol: HTTP

listeners:
- port: 8001
  protocol: HTTP
- port: 8002     # Missing from new config and in last-applied-configuration — will be deleted
  protocol: HTTP
- port: 8003
  protocol: HTTP
- port: 8004     # Missing from new config but not in last-applied-configuration — will be deleted
  protocol: HTTP

listeners:
- port: 8001
  protocol: HTTP
- port: 8002
  protocol: HTTP
- port: 8003
  protocol: HTTP

listeners:
- port: 8001    # Meets condition ① — retained
  protocol: HTTP
- port: 8003    # Meets condition ① — retained
  protocol: HTTP
- port: 8005    # Meets condition ② — added
  protocol: HTTP
# port 8002 meets condition ③ — deleted
# port 8004 meets condition ④ — deleted

Criar um listener

Um listener atua como ponto de entrada pelo qual uma instância ALB recebe e distribui tráfego com base em informações da camada de aplicação. Os campos port e protocol identificam exclusivamente um listener.

Listeners HTTP suportam WebSocket automaticamente. Nenhuma configuração adicional é necessária.

Opções de protocolo para protocol: HTTP, HTTPS, QUIC.

kubectl edit albconfig <AlbConfig_Name>

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: alb-demo
spec:
  config:
    # ... other config fields
  listeners:
  - port: 80
    protocol: HTTP   # Options: HTTP, HTTPS, QUIC

Configurar certificados HTTPS

Defina o campo certificates para atribuir um ou mais certificados a um listener HTTPS. O ALB define o primeiro certificado como padrão. Outros certificados são usados para criptografia de solicitações apenas se o certificado padrão expirar ou deixar de ser aplicável.

Se você não especificar um certificado, o listener não será criado imediatamente. Em vez disso, ele será criado após a associação de um Ingress e a descoberta automática de um certificado com base no nome de domínio. Para detalhes, consulte Configurar certificados HTTPS para comunicação criptografada .

listeners:
- caEnabled: false
  certificates:
  - CertificateId: 756****-cn-hangzhou   # Certificate ID
    IsDefault: true
  port: 443
  protocol: HTTPS

Configurar uma política de segurança TLS

Defina securityPolicyId para aplicar uma política de segurança TLS a um listener HTTPS. As políticas podem ser personalizadas ou predefinidas. Para mais informações, consulte Política de segurança TLS.

listeners:
- port: 443
  protocol: HTTPS
  securityPolicyId: tls_cipher_policy_1_1   # Security policy ID

Definir o tempo limite da solicitação

Configure requestTimeout para controlar por quanto tempo o Server Load Balancer (SLB) aguarda uma resposta de um servidor backend após receber uma solicitação do cliente. Caso nenhuma resposta seja retornada dentro do tempo limite, a instância SLB interrompe a espera e devolve um erro HTTP 504 ao cliente.

• Padrão: 60 segundos

• Valores válidos: 1–600 (inteiro, em segundos)

• Para utilizar um valor acima de 600, solicite um aumento de cota no Quota Center.

listeners:
- port: 80
  protocol: HTTP
  requestTimeout: 60   # Seconds. Default: 60. Valid values: 1–600.

Adicionar tags ao listener

Use o campo tags para adicionar tags de chave-valor a um listener.

listeners:
- port: 80
  protocol: HTTP
  tags:
  - key: "key"
    value: "value1"

Ativar compactação de dados

Defina gzipEnabled para controlar se o ALB compacta os dados de resposta antes de encaminhá-los aos clientes.

• true: Compacta respostas usando Brotli ou Gzip, dependendo do tipo de conteúdo.

• false: Desativa a compactação para todos os tipos de conteúdo.

A compactação ocorre apenas quando Content-Length no cabeçalho de resposta excede 1.024 bytes. Os dois algoritmos funcionam da seguinte forma:

• Brotli: Compacta todos os tipos de conteúdo.

• Gzip: Compacta text/plain, text/css, application/javascript, application/x-javascript, application/rss+xml, application/atom+xml, application/xml e application/json.

O exemplo abaixo desativa a compactação:

listeners:
- port: 80
  protocol: HTTP
  gzipEnabled: false   # true: compress specific content types. false: disable all compression.

Configurar cabeçalhos X-Forwarded-For

Use o campo xForwardedForConfig para controlar quais informações o ALB inclui nos cabeçalhos de solicitação ao encaminhar tráfego para servidores backend.

listeners:
- port: 80
  protocol: HTTP
  xForwardedForConfig:
    XForwardedForEnabled: true

listeners:
- port: 80
  protocol: HTTP
  xForwardedForConfig:
    XForwardedForProtoEnabled: true

listeners:
- port: 80
  protocol: HTTP
  xForwardedForConfig:
    XForwardedForSLBIdEnabled: true   # true: include SLB instance ID. false: omit it.

listeners:
- port: 80
  protocol: HTTP
  xForwardedForConfig:
    XForwardedForSLBPortEnabled: true   # true: include listening port. false: omit it.

listeners:
- port: 80
  protocol: HTTP
  xForwardedForConfig:
    XForwardedForClientSourceIpsEnabled: true
    XForwardedForClientSourceIpsTrusted: 192.168.x.x;192.168.x.x/16   # Semicolon-separated, no spaces

Definir controle de acesso

Use o campo aclConfig para ativar o controle de acesso em um listener do ALB. Esse mecanismo permite autorizar ou bloquear endereços IP específicos mediante a configuração de uma lista de permissões ou de bloqueios. Para mais informações, consulte Configurar ACLs para controle de acesso.

• aclType: Defina como White para lista de permissões ou Black para lista de bloqueios.

• aclEntries: Lista de blocos CIDR. Cada entrada deve ser um bloco CIDR completo.

listeners:
- port: 80
  protocol: HTTP
  aclConfig:
    aclEntries:
    - 127.0.0.1/32   # CIDR block must be complete
    aclType: White    # White: allowlist. Black: blocklist.

Excluir um listener

Para excluir um listener, remova-o do campo albconfig.spec.listeners.

Antes:

listeners:
- port: 8001
  protocol: HTTP
- port: 8002     # Listener to delete
  protocol: HTTP

Depois:

listeners:
- port: 8001
  protocol: HTTP