Introdução às configurações globais do ALB Ingress - Container Compute Service: Central de Documentação do Alibaba Cloud

Esta referência abrange todas as anotações compatíveis com os Ingresses do Application Load Balancer (ALB) e os campos do recurso personalizado AlbConfig. Use essas anotações para configure verificações de integridade, regras de encaminhamento, persistência de sessão, entre outros recursos.

Todos os valores de anotação no Kubernetes são strings. Ao definir valores booleanos ou inteiros, coloque-os entre aspas no YAML: 'true' , 'false' , '5' . Valores JSON também devem estar entre aspas: '[{"HTTP": 80}]' .

Referência rápida de anotações

A tabela a seguir lista todas as anotações do ALB Ingress. Clique em no nome da anotação para ir diretamente à sua descrição completa.

Anotação	Tipo	Padrão
alb.ingress.kubernetes.io/healthcheck-enabled	boolean	`false`
alb.ingress.kubernetes.io/healthcheck-path	string	`/`
alb.ingress.kubernetes.io/healthcheck-protocol	HTTP	TCP	`HTTP`
alb.ingress.kubernetes.io/healthcheck-method	HEAD	POST	GET	`HEAD`
alb.ingress.kubernetes.io/healthcheck-httpcode	string	`http_2xx`
alb.ingress.kubernetes.io/healthcheck-timeout-seconds	integer (1–300)	`5`
alb.ingress.kubernetes.io/healthcheck-interval-seconds	integer (1–50)	`2`
alb.ingress.kubernetes.io/healthy-threshold-count	integer (2–10)	`3`
alb.ingress.kubernetes.io/unhealthy-threshold-count	integer (2–10)	`3`
alb.ingress.kubernetes.io/healthcheck-connect-port	integer (0–65535)	`0`
alb.ingress.kubernetes.io/ssl-redirect	boolean	`false`
alb.ingress.kubernetes.io/backend-protocol	http	https	grpc	`http`
alb.ingress.kubernetes.io/rewrite-target	string	None
alb.ingress.kubernetes.io/listen-ports	JSON	`'[{"HTTP": 80},{"HTTPS": 443}]'`
alb.ingress.kubernetes.io/order	integer (1–1000)	`10`
alb.ingress.kubernetes.io/canary	boolean	`false`
alb.ingress.kubernetes.io/canary-by-header	string	None
alb.ingress.kubernetes.io/canary-by-header-value	string	None
alb.ingress.kubernetes.io/canary-by-cookie	string	None
alb.ingress.kubernetes.io/canary-weight	integer (0–100)	None
alb.ingress.kubernetes.io/sticky-session	boolean	`false`
alb.ingress.kubernetes.io/sticky-session-type	Insert	Server	`Insert`
alb.ingress.kubernetes.io/cookie-timeout	integer (1–86400)	`1000`
alb.ingress.kubernetes.io/backend-scheduler	wrr	wlc	sch	uch	`wrr`
alb.ingress.kubernetes.io/backend-scheduler-uch-value	string	None
alb.ingress.kubernetes.io/enable-cors	boolean	`false`
alb.ingress.kubernetes.io/cors-allow-origin	string	`*`
alb.ingress.kubernetes.io/cors-expose-headers	string array	None
alb.ingress.kubernetes.io/cors-allow-methods	string	`"GET, PUT, POST, DELETE, PATCH, OPTIONS"`
alb.ingress.kubernetes.io/cors-allow-credentials	boolean	`true`
alb.ingress.kubernetes.io/cors-max-age	integer (–1 to 172800)	`172800`
alb.ingress.kubernetes.io/cors-allow-headers	string array	`"DNT,X-CustomHeader,Keep-Alive,..."`
alb.ingress.kubernetes.io/actions.{svcName}	JSON	None
alb.ingress.kubernetes.io/conditions.{svcName}	JSON	None
alb.ingress.kubernetes.io/rule-direction.{svcName}	Request	Response	`Request`
alb.ingress.kubernetes.io/backend-keepalive	boolean	`false`
alb.ingress.kubernetes.io/traffic-limit-qps	integer (1–100,000)	None
alb.ingress.kubernetes.io/use-regex	boolean	`false`

Anotações compatíveis com o ALB Ingress

Verificação de integridade

Estas anotações configure as verificações de integridade para grupos de servidores de backend.

Anotação	Valor válido	Padrão	Descrição
`alb.ingress.kubernetes.io/healthcheck-enabled`	`true` \| `false`	`false`	Ative as verificações de integridade para os grupos de servidores de backend.
`alb.ingress.kubernetes.io/healthcheck-path`	string	`/`	Caminho de destino das requisições de verificação de integridade.
`alb.ingress.kubernetes.io/healthcheck-protocol`	`HTTP` \| `TCP`	`HTTP`	Protocolo das verificações de integridade.
`alb.ingress.kubernetes.io/healthcheck-method`	`HEAD` \| `POST` \| `GET`	`HEAD`	Método HTTP das verificações de integridade.
`alb.ingress.kubernetes.io/healthcheck-httpcode`	`http_2xx`, `http_3xx`, `http_4xx`, `http_5xx`	`http_2xx`	Códigos de status HTTP que indicam um backend íntegro. Especifique um ou mais valores como uma string separada por vírgulas.
`alb.ingress.kubernetes.io/healthcheck-timeout-seconds`	`1`–`300`	`5`	Tempo limite da verificação de integridade em segundos.
`alb.ingress.kubernetes.io/healthcheck-interval-seconds`	`1`–`50`	`2`	Intervalo entre as verificações de integridade, em segundos.
`alb.ingress.kubernetes.io/healthy-threshold-count`	`2`–`10`	`3`	Número de verificações de integridade consecutivas com sucesso necessárias para considerar o backend íntegro.
`alb.ingress.kubernetes.io/unhealthy-threshold-count`	`2`–`10`	`3`	Número de falhas consecutivas na verificação de integridade exigidas para classificar o backend como não íntegro.
`alb.ingress.kubernetes.io/healthcheck-connect-port`	`0`–`65535`	`0`	Porta usada para as verificações de integridade. Defina como `0` para usar a própria porta do servidor de backend.

Redirecionamento

Anotação	Valor válido	Padrão	Descrição
`alb.ingress.kubernetes.io/ssl-redirect`	`true`	`false`	`false`	Redireciona requisições HTTP (porta 80) para HTTPS (porta 443) com o código de status 301.

Protocolo de backend

Anotação	Valor válido	Padrão	Descrição
`alb.ingress.kubernetes.io/backend-protocol`	`http`	`https`	`grpc`	`http`	Protocolo de comunicação com os grupos de servidores de backend. Listeners HTTP aceitam `http` e `https`. Listeners HTTPS aceitam `http`, `https` e `grpc`. Listeners QUIC aceitam apenas `http`.

Reescrita

Anotação	Valor válido	Padrão	Descrição
`alb.ingress.kubernetes.io/rewrite-target`	string	None	Sobrescreve o caminho da requisição antes do encaminhamento para o backend.

Listeners

Anotação	Valor válido	Padrão	Descrição
`alb.ingress.kubernetes.io/listen-ports`	JSON array	`'[{"HTTP": 80},{"HTTPS": 443}]'`	Associa protocolos de listener a portas. Valores válidos: `'[{"HTTP": 80}]'`, `'[{"HTTPS": 443}]'`, `'[{"HTTP": 80},{"HTTPS": 443}]'`, `'[{"QUIC": 443}]'`.

Prioridades

Anotação	Valor válido	Padrão	Descrição
`alb.ingress.kubernetes.io/order`	`1`–`1000`	`10`	Prioridade das regras de encaminhamento.

Canary

Use estas anotações para rotear parte do tráfego a uma implantação canary e permitir lançamentos graduais.

Anotação	Valor válido	Padrão	Descrição
`alb.ingress.kubernetes.io/canary`	`true`	`false`	`false`	Habilita o roteamento canary para este Ingress. Defina como `true` para que as demais anotações canary tenham efeito.
`alb.ingress.kubernetes.io/canary-by-header`	string	None	Header das requisições roteadas para a versão canary.
`alb.ingress.kubernetes.io/canary-by-header-value`	string	None	Valor do header das requisições roteadas para a versão canary.
`alb.ingress.kubernetes.io/canary-by-cookie`	string	None	Cookie das requisições roteadas para a versão canary.
`alb.ingress.kubernetes.io/canary-weight`	integer (`0`–`100`)	None	Percentual de requisições roteadas para a versão canary. Especifique um número inteiro entre 0 e 100.

Persistência de sessão

Anotação	Valor válido	Padrão	Descrição
`alb.ingress.kubernetes.io/sticky-session`	`true`	`false`	`false`	Ative a persistência de sessão (sticky sessions).
`alb.ingress.kubernetes.io/sticky-session-type`	`Insert`	`Server`	`Insert`	Método de gerenciamento do cookie.
`alb.ingress.kubernetes.io/cookie-timeout`	`1`–`86400`	`1000`	Tempo limite da persistência de sessão em segundos.

Balanceamento de carga

Anotação	Valor válido	Padrão	Descrição
`alb.ingress.kubernetes.io/backend-scheduler`	`wrr`	`wlc`	`sch`	`uch`	`wrr`	Algoritmo de balanceamento de carga. `wrr` = round-robin ponderado, `wlc` = menor número de conexões ponderado, `sch` = hash de endereço IP de source, `uch` = hash de URI.
`alb.ingress.kubernetes.io/backend-scheduler-uch-value`	string	None	Disponível apenas quando o algoritmo de balanceamento de carga é `uch`.

Compartilhamento de recursos de origem cruzada (CORS)

Anotação	Valor válido	Padrão	Descrição
`alb.ingress.kubernetes.io/enable-cors`	`true`	`false`	`false`	Habilita o CORS para este Ingress.
`alb.ingress.kubernetes.io/cors-allow-origin`	string	`*`	Origens permitidas para requisições de domínio cruzado.
`alb.ingress.kubernetes.io/cors-expose-headers`	string array	None	Headers de resposta expostos ao navegador.
`alb.ingress.kubernetes.io/cors-allow-methods`	`GET`, `POST`, `PUT`, `DELETE`, `HEAD`, `OPTIONS`, `PATCH`	`"GET, PUT, POST, DELETE, PATCH, OPTIONS"`	Métodos HTTP permitidos em requisições de domínio cruzado. Especifique um ou mais métodos como uma string separada por vírgulas.
`alb.ingress.kubernetes.io/cors-allow-credentials`	`true`	`false`	`true`	Define se credenciais (cookies, headers de autorização) são incluídas nas requisições de domínio cruzado.
`alb.ingress.kubernetes.io/cors-max-age`	`–1` a `172800`	`172800`	Tempo máximo, em segundos, de cache dos resultados da requisição preflight pelo navegador.
`alb.ingress.kubernetes.io/cors-allow-headers`	string array	`"DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Authorization"`	Headers de requisição permitidos em chamadas de domínio cruzado.

Encaminhamento personalizado

Anotação	Valor válido	Padrão	Descrição
`alb.ingress.kubernetes.io/actions.{svcName}`	JSON	None	Ações de encaminhamento personalizadas para o serviço nomeado. Substitua `{svcName}` pelo nome do serviço.
`alb.ingress.kubernetes.io/conditions.{svcName}`	JSON	None	Condições de encaminhamento personalizadas para o serviço especificado. Substitua `{svcName}` pelo nome do serviço.
`alb.ingress.kubernetes.io/rule-direction.{svcName}`	`Request`	`Response`	`Request`	Direção de aplicação da regra de encaminhamento personalizado.

Outras anotações

Anotação	Valor válido	Padrão	Descrição
`alb.ingress.kubernetes.io/backend-keepalive`	`true`	`false`	`false`	Mantém conexões TCP persistentes entre o balanceador de carga e os servidores de backend.
`alb.ingress.kubernetes.io/traffic-limit-qps`	`1`–`100,000`	None	Limite de throttling de QPS para este Ingress.
`alb.ingress.kubernetes.io/use-regex`	`true`	`false`	`false`	Permite expressões regulares no campo `path`. Válido apenas quando o tipo de caminho é `Prefix`.

Campos do AlbConfig

O AlbConfig é uma CustomResourceDefinition (CRD) que descreve uma instância ALB e seus listeners. As tabelas a seguir detalham todos os campos disponíveis.

AlbConfig

Campo	Valor válido	Padrão	Descrição
`apiVersion`	`alibabacloud.com/v1`	None	Versão da API do objeto.
`kind`	`AlbConfig`	None	Tipo de recurso REST do objeto.
`metadata`	ObjectMeta	None	Metadados padrão de objetos Kubernetes. Para mais detalhes, consulte metadata.
`spec`	AlbConfigSpec	None	Atributos da instância ALB e de seus listeners.
`status`	AlbConfigStatus	None	Status atual da instância ALB, preenchido após a reconciliação.

AlbConfigSpec

Campo	Valor válido	Padrão	Descrição
`config`	LoadBalancerSpec	None	Atributos da instância ALB.
`listeners`	ListenerSpec	None	Atributos dos listeners da instância ALB.

LoadBalancerSpec

Campo	Valor válido	Padrão	Descrição
`id`	string	`""`	ID da instância ALB. A instância ALB pode ser reutilizada se um ID de instância for especificado.
`name`	string	`k8s-{namespace}-{name}-{hashCode}`	Nome da instância ALB.
`addressAllocatedMode`	`Dynamic`	`Fixed`	`Dynamic`	Modo de alocação de endereço IP da instância ALB.
`addressType`	`Internet`	`Intranet`	`Internet`	Tipo de rede do bloco CIDR IPv4.
`ipv6AddressType`	`Internet`	`Intranet`	`Intranet`	Tipo de rede do bloco CIDR IPv6.
`addressIpVersion`	`IPv4`	`DualStack`	`IPv4`	Versão do protocolo IP da instância ALB.
`resourceGroupId`	string	Grupo de recursos padrão	ID do grupo de recursos ao qual a instância ALB pertence.
`edition`	`Standard`	`StandardWithWaf`	`Standard`	Edição de recursos da instância ALB.
`deletionProtectionEnabled`	`*bool`	`null`	Reservado. Não configurável.
`forceOverride`	`*bool`	`false`	No modo de reutilização, sobrescreve forçosamente os atributos da instância ALB.
`listenerForceOverride`	`*bool`	`null`	Define se os atributos dos listeners devem ser sobrescritos forçosamente no modo de reutilização.
`zoneMappings`	ZoneMapping	None	Configuração de zona e endereço IP elástico (EIP).
`accessLogConfig`	AccessLogConfig	None	Configuração de coleta de logs de acesso.
`billingConfig`	BillingConfig	None	Configuração de faturamento.
`modificationProtectionConfig`	ModificationProtectionConfig	None	Configuração de proteção contra modificações.
`tags`	Tag	None	Tags a serem aplicadas à instância ALB.

ZoneMapping

Campo	Valor válido	Padrão	Descrição
`vSwitchId`	string	`""`	Obrigatório. ID do vSwitch na zona.
`zoneId`	string	`""`	Zona do vSwitch. Definido automaticamente.
`allocationId`	string	`""`	ID do EIP a ser associado a esta zona.
`eipType`	string	`""`	Reservado.

AccessLogConfig

Campo	Valor válido	Padrão	Descrição
`logStore`	string	`""`	Nome do Logstore do Simple Log Service.
`logProject`	string	`""`	Nome do Log Project do Simple Log Service.

BillingConfig

Campo	Valor válido	Padrão	Descrição
`internetBandwidth`	int	`0`	Reservado.
`internetChargeType`	string	`""`	Reservado.
`payType`	`PostPay`	`PostPay`	Método de faturamento. Apenas pagamento conforme o uso (`PostPay`) é compatível.
`bandWidthPackageId`	string	`""`	ID da instância Internet Shared Bandwidth a ser associada. A associação não pode ser removida após ser definida.

ModificationProtectionConfig

Campo	Valor válido	Padrão	Descrição
`reason`	string	`""`	Reservado.
`status`	string	`""`	Reservado.

Tag

Campo	Valor válido	Padrão	Descrição
`key`	string	`""`	Chave da tag.
`value`	string	`""`	Valor da tag.

ListenerSpec

Campo	Valor válido	Padrão	Descrição
`port`	int	string	`0`	Obrigatório. Porta de escuta.
`protocol`	`HTTP`	`HTTPS`	`QUIC`	`""`	Obrigatório. Protocolo do listener.
`gzipEnabled`	`null`	`true`	`false`	`null`	Ative a compressão de resposta.
`http2Enabled`	`null`	`true`	`false`	`null`	Habilita HTTP/2 no listener.
`securityPolicyId`	string	`""`	ID da política de segurança TLS a ser aplicada.
`idleTimeout`	int	`60`	Tempo limite de conexão ociosa em segundos. O valor `0` usa o padrão.
`requestTimeout`	int	`60`	Tempo limite da requisição em segundos.
`description`	string	`ingress-auto-listener-{port}`	Nome do listener.
`certificates`	Certificate	`null`	Certificado de servidor associado ao listener.
`xForwardedForConfig`	XForwardedForConfig	None	Configuração do header X-Forwarded-For.
`aclConfig`	AclConfig	None	Configuração de controle de acesso.
`quicConfig`	QuicConfig	None	Configuração do listener QUIC.
`loadBalancerId`	string	`""`	Reservado.
`caEnabled`	bool	`false`	Reservado.
`defaultActions`	Action	`null`	Reservado.
`caCertificates`	Certificate	`null`	Reservado.
`logConfig`	LogConfig	None	Reservado.

QuicConfig

Campo	Valor válido	Padrão	Descrição
`quicUpgradeEnabled`	bool	`false`	Define se as atualizações QUIC estão habilitadas.
`quicListenerId`	string	`""`	Listener QUIC.

Certificate

Campo	Valor válido	Padrão	Descrição
`IsDefault`	bool	`false`	Marca este certificado como padrão. Cada serviço ou sistema pode ter apenas um certificado padrão.
`CertificateId`	string	`""`	ID do certificado.

XForwardedForConfig

Todos os campos têm como padrão false, salvo indicação em contrário. Os campos *Alias só são válidos quando o campo *Enabled correspondente estiver definido como true.

Campo	Valor válido	Padrão	Descrição
`XForwardedForEnabled`	bool	`false`	Habilita o header `X-Forwarded-For` para transmitir o endereço IP do cliente aos backends.
`XForwardedForProtoEnabled`	bool	`false`	Habilita o header `X-Forwarded-Proto` para transmitir o protocolo do listener aos backends.
`XForwardedForSLBIdEnabled`	bool	`false`	Habilita o header `X-Forwarded-For-SLB-ID` para transmitir o ID da instância ALB aos backends.
`XForwardedForSLBPortEnabled`	bool	`false`	Habilita o header `X-Forwarded-Port` para transmitir a porta do listener aos backends.
`XForwardedForClientSrcPortEnabled`	bool	`false`	Habilita o header `X-Forwarded-Client-Port` para transmitir a porta do cliente aos backends.
`XForwardedForClientCertSubjectDNEnabled`	bool	`false`	Habilita o header `X-Forwarded-Clientcert-subjectdn` para transmitir informações do proprietário do certificado do cliente aos backends.
`XForwardedForClientCertSubjectDNAlias`	string	`""`	Nome de header personalizado para substituir `X-Forwarded-Clientcert-subjectdn`. Válido apenas quando `XForwardedForClientCertSubjectDNEnabled` for `true`.
`XForwardedForClientCertIssuerDNEnabled`	bool	`false`	Habilita o header `X-Forwarded-Clientcert-issuerdn` para transmitir informações da autoridade certificadora do cliente aos backends.
`XForwardedForClientCertIssuerDNAlias`	string	`""`	Nome de header personalizado para substituir `X-Forwarded-Clientcert-issuerdn`. Válido apenas quando `XForwardedForClientCertIssuerDNEnabled` for `true`.
`XForwardedForClientCertFingerprintEnabled`	bool	`false`	Habilita o header `X-Forwarded-Clientcert-fingerprint` para transmitir a impressão digital do certificado do cliente aos backends.
`XForwardedForClientCertFingerprintAlias`	string	`""`	Nome de header personalizado para substituir `X-Forwarded-Clientcert-fingerprint`. Válido apenas quando `XForwardedForClientCertFingerprintEnabled` for `true`.
`XForwardedForClientCertClientVerifyEnabled`	bool	`false`	Habilita o header `X-Forwarded-Clientcert-clientverify` para transmitir o resultado da verificação do certificado do cliente aos backends.
`XForwardedForClientCertClientVerifyAlias`	string	`""`	Nome de header personalizado para substituir `X-Forwarded-Clientcert-clientverify`. Válido apenas quando `XForwardedForClientCertClientVerifyEnabled` for `true`.

AclConfig

Campo	Valor válido	Padrão	Descrição
`aclName`	string	None	Nome da ACL de rede (usado no modo AclEntry).
`aclType`	`Black`	`White`	`""`	Tipo de ACL: `Black` para lista de bloqueios, `White` para lista de permissões.
`aclEntries`	string	`null`	Regras de ACL a serem aplicadas inline.
`aclIds`	string array	`null`	IDs das ACLs de rede existentes a serem aplicadas.

AlbConfigStatus

O campo status é preenchido após a reconciliação e reflete o estado atual da instância ALB.

Campo	Saída	Descrição
`loadBalancer`	LoadBalancerStatus	Status da instância ALB.

LoadBalancerStatus

Campo	Saída	Descrição
`dnsname`	string	Nome DNS da instância ALB.
`id`	string	ID da instância ALB.
`listeners`	ListenerStatus	Status dos listeners.

ListenerStatus

Campo	Saída	Exemplo	Descrição
`portAndProtocol`	string	`80/HTTP`	Porta e protocolo do listener.
`certificates`	AppliedCertificate	None	Certificados associados ao listener.

AppliedCertificate

Campo	Saída	Exemplo	Descrição
`certificateId`	string	`xxxx-cn-hangzhou`	ID do certificado.
`isDefault`	bool	`true`	Indica se este é o certificado padrão do listener.

Próximos passos

Para começar a usar o ALB Ingress, consulte Acessar serviços usando um ALB Ingress.
Para exemplos de configurações avançadas com essas anotações, consulte Configurações avançadas do ALB Ingress.