Container Service for Kubernetes:Advanced ALB Ingress usage

Encaminhar solicitações com base em nomes de domínio

Crie um Ingress para encaminhar solicitações com base em um nome de domínio ou em um nome de domínio vazio.

Encaminhamento com base em caminho

Exemplos para cada modo de correspondência:

Configurar verificações de integridade

Use anotações para configurar verificações de integridade para o ALB Ingress.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

Redirecionar solicitações HTTP para HTTPS

Adicione a seguinte anotação para redirecionar solicitações HTTP para a porta HTTPS 443.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/ssl-redirect: "true"
  name: demo-ssl
 ... ...

Configure HTTPS ou gRPC no backend

Adicione a seguinte anotação para usar HTTPS ou gRPC como protocolo de backend.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/backend-protocol: "grpc"
  name: demo-alb-ingress
... ...

Configure expressões regulares

Use a anotação alb.ingress.kubernetes.io/use-regex: "true" para ativar a correspondência de expressões regulares nas regras de caminho em spec.rules com pathType: Prefix.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/use-regex: "true"
  name: demo-alb-ingress
... ...

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
   alb.ingress.kubernetes.io/conditions.YOUR-SVC-NAME: | ## Replace YOUR-SVC-NAME with the actual Service name. It must match backend.service.name below.
     [{
       "type": "Path",
       "pathConfig": {
           "values": [
              "~*/pathvalue1", ## Add the ~* or ~ prefix to a regular expression. The text after the prefix is the regular expression itself. ~* indicates a case-sensitive match, and ~ indicates a case-insensitive match.
              "/pathvalue2"    ## An exact match does not require a prefix.
           ]
       }
      }]
  name: ingress-example
... ...

A tabela a seguir descreve as regras de correspondência de expressões regulares.

Correspondência de prefixo com regex

A correspondência de regex usa por padrão a "correspondência de contêm". Para corresponder apenas a caminhos que começam com um conteúdo específico, adicione ^ no início da expressão. Por exemplo, ^/api corresponde apenas a caminhos que começam com /api.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

Configure reescritas

O ALB Ingress reescreve os caminhos das requisições antes de encaminhá-las ao Service de backend. Use as duas anotações a seguir:

• alb.ingress.kubernetes.io/rewrite-target: /path/${number}: Especifica o caminho para o qual as requisições são reescritas.

  Importante

  • Use variáveis ${number} para referenciar grupos de captura da expressão regular no caminho do Ingress. É possível referenciar até três grupos de captura usando ${1}, ${2} e ${3}.

  • O pathType do Ingress deve ser definido como Prefix.

• alb.ingress.kubernetes.io/use-regex: true: Ativa o uso de uma expressão regular no caminho. Isso é ativado por padrão ao configurar o rewrite-target.

  Importante

  • Esta anotação ativa a correspondência de regex independentemente do seu valor (true ou false). Remova a anotação para desativar.

  • Sem esta anotação, a criação do Ingress falha se o caminho contiver caracteres especiais como "%#;!()[]^,"\"".

Exemplos de configuração

Exemplo 1: Remover um prefixo

No exemplo de YAML a seguir, o path: /something(/|$)(.*) usa uma expressão regular para dividir o caminho da requisição do cliente em três partes:

• /something: Corresponde ao prefixo a ser removido.

• (/|$): O primeiro grupo de captura, que corresponde a uma / após /something ou ao fim do caminho ($).

• (.*): O segundo grupo de captura, que corresponde a todos os caracteres após /something/ e é referenciado como ${2} no caminho reescrito.

A anotação alb.ingress.kubernetes.io/rewrite-target especifica o caminho reescrito como / seguido por ${2}. A tabela a seguir mostra os resultados da reescrita.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

Exemplo 2: Capturar e reorganizar várias partes

O exemplo a seguir captura e reorganiza várias partes do caminho /items/(.*)/(.*)/(.*). Ele também converte segmentos de caminho em parâmetros de consulta, o que não exige alterações no lado do cliente. O caminho reescrito é construído como /, seguido pelo segundo grupo de captura ${2}, a string ?code= e o terceiro grupo de captura ${3}. A tabela a seguir mostra os resultados da reescrita.

Este exemplo exige que o cliente use um formato de caminho fixo com quatro segmentos.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

Exemplo 3: Reescrever vários caminhos para um único caminho

O exemplo a seguir usa uma expressão regular para corresponder a vários caminhos (/app-a(/|$)(.*) e /app-b(/|$)(.*)) e os reescreve para um único caminho. O caminho reescrito é /app-c/ seguido por ${2}. A tabela a seguir mostra os resultados da reescrita.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

Exemplo 4: Reescrever nome de domínio

A anotação alb.ingress.kubernetes.io/rewrite-target oferece suporte apenas à alteração do caminho. Para alterar outras partes da URL, como o nome de domínio ou parâmetros de consulta, use uma regra de encaminhamento personalizada.

Testar regras de reescrita

Use o comando sed para testar se um caminho do cliente corresponde à expressão regular do caminho e para visualizar o caminho reescrito.

Este exemplo usa o caminho de captura /items/(.*)/(.*)/(.*) e a regra de reescrita /${2}?code=${3} do Exemplo 2: Capturar e reorganizar várias partes.

1. Salve os seguintes caminhos de exemplo em um arquivo chamado path2.txt:

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: alb-ingress
     namespace: default
     annotations:
       alb.ingress.kubernetes.io/cross-zone-enabled: "false"
   spec:
     ingressClassName: alb
     rules:
     - host: alb.ingress.alibaba.com
       http:
         paths:
         - path: /test
           pathType: Prefix
           backend:
             service:
               name: tea-svc
               port:
                 number: 80

2. Verifique se os caminhos correspondem e visualize os caminhos reescritos:

   O comando a seguir adapta a expressão regular do caminho do exemplo ( /items/(.*)/(.*)/(.*) ) e o caminho reescrito ( /${2}?code=${3} ) para o sed. Ao usar o sed, caracteres especiais como / devem ser escapados com uma barra invertida ( \ ), e as referências de grupos de captura são escritas como \2 em vez de ${2} .

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: alb-ingress
     namespace: default
     annotations:
       alb.ingress.kubernetes.io/cross-zone-enabled: "false"
   spec:
     ingressClassName: alb
     rules:
     - host: alb.ingress.alibaba.com
       http:
         paths:
         - path: /test
           pathType: Prefix
           backend:
             service:
               name: tea-svc
               port:
                 number: 80

   A saída esperada é a seguinte. Os dois primeiros caminhos correspondem à regra e são reescritos, enquanto os dois últimos não correspondem e permanecem inalterados.

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: alb-ingress
     namespace: default
     annotations:
       alb.ingress.kubernetes.io/cross-zone-enabled: "false"
   spec:
     ingressClassName: alb
     rules:
     - host: alb.ingress.alibaba.com
       http:
         paths:
         - path: /test
           pathType: Prefix
           backend:
             service:
               name: tea-svc
               port:
                 number: 80

Configure portas de listener personalizadas

Adicione uma anotação para expor um service tanto na porta 80 (HTTP) quanto na porta 443 (HTTPS).

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/listen-ports: '[{"HTTP": 80},{"HTTPS": 443}]'
... ...

Configure a prioridade da regra de encaminhamento

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/order: "2"
spec:
... ...

Implemente liberações canário com anotações

O ALB oferece suporte a liberações canário com base em cabeçalhos, cookies e pesos. Consulte Implemente liberações canário usando um ALB Ingress para conhecer as melhores práticas.

• Distribua o tráfego canário com base em um cabeçalho especificado

  Parâmetro	Descrição	Exemplo de YAML
  alb.ingress.kubernetes.io/canary-by-header	Essas anotações definem um cabeçalho e um valor de solicitação personalizados para o roteamento de tráfego. Ambas as anotações são obrigatórias. Quando o header e o header-value em uma solicitação correspondem aos valores configurados, o ALB direciona o tráfego da solicitação para o ponto de entrada do service canário. O ALB avalia as solicitações não correspondentes em relação a regras de prioridade mais baixa.	apiVersion: networking.k8s.io/v1 kind: Ingress metadata: annotations: alb.ingress.kubernetes.io/order: "1" alb.ingress.kubernetes.io/canary: "true" alb.ingress.kubernetes.io/canary-by-header: "location" alb.ingress.kubernetes.io/canary-by-header-value: "hz" name: demo-canary spec: ... ...
  alb.ingress.kubernetes.io/canary-by-header-value

  Se uma solicitação contiver o cabeçalho location: hz, o ALB roteará o tráfego para o Service canário. Outras solicitações são avaliadas com base em regras de prioridade mais baixa, como aquelas baseadas em cookie ou peso.

  Exemplo completo de YAML

  Kubernetes 1.19 ou posterior

  apiVersion: networking.k8s.io/v1
  kind: Ingress
  metadata:
    name: alb-ingress
    namespace: default
    annotations:
      alb.ingress.kubernetes.io/cross-zone-enabled: "false"
  spec:
    ingressClassName: alb
    rules:
    - host: alb.ingress.alibaba.com
      http:
        paths:
        - path: /test
          pathType: Prefix
          backend:
            service:
              name: tea-svc
              port:
                number: 80

  Kubernetes anterior ao 1.19

  apiVersion: networking.k8s.io/v1
  kind: Ingress
  metadata:
    name: alb-ingress
    namespace: default
    annotations:
      alb.ingress.kubernetes.io/cross-zone-enabled: "false"
  spec:
    ingressClassName: alb
    rules:
    - host: alb.ingress.alibaba.com
      http:
        paths:
        - path: /test
          pathType: Prefix
          backend:
            service:
              name: tea-svc
              port:
                number: 80

• Distribua o tráfego canário com base em um cookie especificado

  Parâmetro	Valor do cookie	Exemplo de YAML
  alb.ingress.kubernetes.io/canary-by-cookie	always: Roteia todas as solicitações para o Service canário. never: Nunca roteia solicitações para o Service canário. As liberações canário baseadas em cookie não aceitam valores personalizados, apenas always e never.	apiVersion: networking.k8s.io/v1 kind: Ingress metadata: annotations: alb.ingress.kubernetes.io/order: "2" alb.ingress.kubernetes.io/canary: "true" alb.ingress.kubernetes.io/canary-by-cookie: "demo" name: demo-canary-cookie ... ...

  Se uma solicitação contiver o cabeçalho Cookie: demo=always, o ALB roteará o tráfego para o Service canário. Se o cabeçalho contiver Cookie: demo=never, o ALB não roteará o tráfego para o Service canário.

  Exemplo completo de YAML

  Kubernetes 1.19 ou posterior

  apiVersion: networking.k8s.io/v1
  kind: Ingress
  metadata:
    name: alb-ingress
    namespace: default
    annotations:
      alb.ingress.kubernetes.io/cross-zone-enabled: "false"
  spec:
    ingressClassName: alb
    rules:
    - host: alb.ingress.alibaba.com
      http:
        paths:
        - path: /test
          pathType: Prefix
          backend:
            service:
              name: tea-svc
              port:
                number: 80

  Kubernetes anterior ao 1.19

  apiVersion: networking.k8s.io/v1
  kind: Ingress
  metadata:
    name: alb-ingress
    namespace: default
    annotations:
      alb.ingress.kubernetes.io/cross-zone-enabled: "false"
  spec:
    ingressClassName: alb
    rules:
    - host: alb.ingress.alibaba.com
      http:
        paths:
        - path: /test
          pathType: Prefix
          backend:
            service:
              name: tea-svc
              port:
                number: 80

• Distribua o tráfego por peso

  Parâmetro	Descrição	Exemplo de YAML
  alb.ingress.kubernetes.io/canary-weight	Porcentagem de tráfego roteado para o Service canário. Valores válidos: 0 a 100.	apiVersion: networking.k8s.io/v1 kind: Ingress metadata: annotations: alb.ingress.kubernetes.io/order: "3" alb.ingress.kubernetes.io/canary: "true" alb.ingress.kubernetes.io/canary-weight: "50" name: demo-canary-weight

  Exemplo completo de YAML

  Kubernetes 1.19 ou posterior

  apiVersion: networking.k8s.io/v1
  kind: Ingress
  metadata:
    name: alb-ingress
    namespace: default
    annotations:
      alb.ingress.kubernetes.io/cross-zone-enabled: "false"
  spec:
    ingressClassName: alb
    rules:
    - host: alb.ingress.alibaba.com
      http:
        paths:
        - path: /test
          pathType: Prefix
          backend:
            service:
              name: tea-svc
              port:
                number: 80

  Kubernetes anterior ao 1.19

  apiVersion: networking.k8s.io/v1
  kind: Ingress
  metadata:
    name: alb-ingress
    namespace: default
    annotations:
      alb.ingress.kubernetes.io/cross-zone-enabled: "false"
  spec:
    ingressClassName: alb
    rules:
    - host: alb.ingress.alibaba.com
      http:
        paths:
        - path: /test
          pathType: Prefix
          backend:
            service:
              name: tea-svc
              port:
                number: 80

Configure a persistência de sessão com anotações

Use as seguintes anotações para configurar a persistência de sessão para um ALB Ingress.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

Especifique o algoritmo de balanceamento de carga

Use uma anotação para especificar o algoritmo de balanceamento de carga para um grupo de servidores de backend.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/backend-scheduler: "uch" # Set this to wrr, sch, or wlc as needed.
    alb.ingress.kubernetes.io/backend-scheduler-uch-value: "test" # This parameter is required only when the load balancing algorithm is uch. It is not needed for wrr, sch, or wlc.
spec:
... ... 

Configuração de CORS

Use as seguintes anotações para configurar o Cross-Origin Resource Sharing (CORS) para o ALB Ingress.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

Conexão persistente de backend

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  annotations:
    alb.ingress.kubernetes.io/backend-keepalive: "true"
spec:

Associação de backend IPv6 para grupos de servidores

A associação de backend IPv6 permite Pods IPv4 e IPv6 em um grupo de servidores, mas requer um cluster dual-stack. Consulte Criar um cluster gerenciado ACK.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

Configure o Service e o ALB Ingress para dual-stack. Após criar uma instância ALB dual-stack, você pode associar servidores de backend IPv4 e IPv6 ao grupo de servidores.

apiVersion: v1
kind: Service
metadata:
  name: tea-svc
spec:
  # To configure dual-stack, set ipFamilyPolicy to RequireDualStack or PreferDualStack and specify both IPv4 and IPv6 in ipFamilies.
  ipFamilyPolicy: RequireDualStack
  ipFamilies:
  - IPv4
  - IPv6
... ...

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/enable-ipv6: "true"
spec:
... ...

Configure a limitação de QPS

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/traffic-limit-qps: "50"
spec:
... ...

Início lento

O início lento aumenta gradualmente o tráfego para os Pods recém-adicionados, o que evita sobrecargas causadas por picos repentinos de tráfego.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/slow-start-enabled: "true"
    alb.ingress.kubernetes.io/slow-start-duration: "100"
  name: alb-ingress
... ...

Drenagem de conexões

Quando um Pod entra no estado Terminating, o ALB Ingress o remove do grupo de servidores, mas não fecha as conexões existentes imediatamente, o que pode causar erros de requisição ou impedir o encerramento graceful. A drenagem de conexões mantém as conexões existentes abertas por um tempo limite configurável antes de fechá-las. Consulte Usar a drenagem de conexões com um ALB Ingress para encerrar um service de forma graceful.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/connection-drain-enabled: "true"
    alb.ingress.kubernetes.io/connection-drain-timeout: "199"
  name: alb-ingress
... ...

Desative o balanceamento de carga entre zonas

Por padrão, o ALB distribui o tráfego entre as zonas de disponibilidade. Desativar o balanceamento de carga entre zonas restringe o tráfego aos services de backend na mesma zona.

Use o exemplo a seguir para desativar o balanceamento de carga entre zonas:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
... ...