Complete configuration reference for ALB Ingress - Container Service for Kubernetes

Consultez l'ensemble des annotations Ingress et des champs AlbConfig pris en charge pour la configuration des instances et des écouteurs ALB.

Index

Champs d'annotation

Catégorie de fonctionnalité	Configuration d'annotation Ingress
YAML d'annotation	Exemple de YAML d'annotation
Configuration ALB Ingress	Contrôle de santé
Configuration de l'écouteur ou du protocole	Écouteur Protocole utilisé par le service backend
Configuration des règles de transfert de trafic	Redirection Déploiement progressif Cross-domain Transfert personnalisé
Configuration avancée	Démarrage lent Priorité Persistance de session Drainage de connexion Équilibrage de charge Attachement IPv6 pour le groupe de serveurs backend
Autre	Autre

Champs AlbConfig

Catégorie de champ	Liens vers les champs
YAML AlbConfig	YAML AlbConfig complet
AlbConfig	AlbConfig AlbConfigSpec
Instance ALB	LoadBalancerSpec
Configuration de l'écouteur	ListenerSpec[]
Commutateur virtuel	ZoneMapping
Simple Log Service	AccessLogConfig
Écouteur QUIC	QuicConfig
Configuration du certificat	Certificate
Contrôle d'accès	AclConfig
Tracing Analysis	AccessLogTracingConfig
Configuration X-Forwarded-	XForwardedForConfig
En-tête personnalisé dans les journaux	LogConfig
Champs réservés	BillingConfig ModificationProtectionConfig AlbConfigStatus LoadBalancerStatus ListenerStatus AppliedCertificate

Exemple de YAML d'annotation

Exemple de configuration d'une instance ALB à l'aide d'annotations Ingress.

Développer pour afficher l'exemple de YAML d'annotation pour Ingress

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/healthcheck-enabled: "true"
    alb.ingress.kubernetes.io/healthcheck-path: "/"
    alb.ingress.kubernetes.io/healthcheck-protocol: "HTTP"
    alb.ingress.kubernetes.io/healthcheck-httpversion: "HTTP1.1"
    alb.ingress.kubernetes.io/healthcheck-method: "HEAD"
    alb.ingress.kubernetes.io/healthcheck-code: "http_2xx"
    alb.ingress.kubernetes.io/healthcheck-timeout-seconds: "5"
    alb.ingress.kubernetes.io/healthcheck-interval-seconds: "2"
    alb.ingress.kubernetes.io/healthy-threshold-count: "3"
    alb.ingress.kubernetes.io/unhealthy-threshold-count: "3"
    alb.ingress.kubernetes.io/conditions.service-a: | # The service referenced here must exist in the cluster. Its name must match the service name in the backend field of the rule.
     [{
       "type": "Path",
       "pathConfig": {
           "values": [
              "~*^/pathvalue1", # Add ~* before a regular expression to mark it as such. The part after ~* is the actual regular expression.
              "/pathvalue2" # Do not add ~* before an exact match.
           ]
       }
      }]
    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"
    ... ...
spec:
  ingressClassName: alb
  rules:
  - http:
      paths:
      # Configure context path
      - path: /tea
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80
      # Configure context path
      - path: /coffee
        pathType: Prefix
        backend:
          service:
            name: coffee-svc
            port:
              number: 80

Annotations prises en charge par Ingress

Ajoutez des annotations aux ressources Ingress selon vos besoins.

Contrôle d'état

Annotation	Description
alb.ingress.kubernetes.io/healthcheck-enabled	Activez les contrôles d'état pour le groupe de serveurs backend. Consultez Configurer le contrôle d'état. `true` : Activer `false` : Désactiver Valeur par défaut : `false`.
alb.ingress.kubernetes.io/healthcheck-path	Chemin du contrôle d'état. Valeur par défaut : `/`.
alb.ingress.kubernetes.io/healthcheck-protocol	Protocole utilisé pour les contrôles d'état. `HTTP` : Utiliser HTTP. Envoyez des requêtes HEAD ou GET pour simuler l'accès via un navigateur et vérifier l'état de l'application. `HTTPS` : Utiliser HTTPS. Envoyez des requêtes HEAD ou GET pour simuler l'accès via un navigateur et vérifier l'état de l'application. `TCP` : Utiliser TCP. Envoyez des paquets de handshake SYN pour vérifier si le port du serveur est actif. `GRPC` : Utiliser gRPC. Envoyez des requêtes POST ou GET pour vérifier l'état de l'application. Valeur par défaut : `HTTP`.
alb.ingress.kubernetes.io/healthcheck-httpversion	Version HTTP. S'applique uniquement lorsque `healthcheck-protocol` est défini sur `HTTP` ou `HTTPS`. `HTTP1,0` `HTTP1,1` Valeur par défaut : `HTTP1,1`.
alb.ingress.kubernetes.io/healthcheck-method	Méthode du contrôle d'état. `HEAD` `POST` `GET` Valeur par défaut : `HEAD`. Important Sélectionnez `POST` ou `GET` lorsque `healthcheck-protocol` est défini sur `GRPC`.
alb.ingress.kubernetes.io/healthcheck-httpcode	Codes d'état du contrôle d'état. Un serveur backend est considéré comme sain uniquement si la sonde renvoie l'un de ces codes. Spécifiez une ou plusieurs valeurs, séparées par des virgules : `http_2xx` `http_3xx` `http_4xx` `http_5xx` Valeur par défaut : `http_2xx`.
alb.ingress.kubernetes.io/healthcheck-code	Codes d'état du contrôle d'état. Un serveur backend est considéré comme sain uniquement si la sonde renvoie l'un de ces codes. Si `healthcheck-httpcode` et ce champ sont tous deux définis, ce champ est prioritaire. Les valeurs valides dépendent de la valeur de `healthcheck-protocol` : `HTTP ou HTTPS` : Spécifiez une ou plusieurs valeurs, séparées par des virgules : `http_2xx` `http_3xx` `http_4xx` `http_5xx` Valeur par défaut : `http_2xx`. `GRPC` : Plage : [0, 99]. Valeur par défaut : `0`. Prend en charge jusqu'à 20 plages, séparées par des virgules.
alb.ingress.kubernetes.io/healthcheck-timeout-seconds	Délai d'attente du contrôle d'état, en secondes (s). Plage : [1, 300]. Valeur par défaut : `5`.
alb.ingress.kubernetes.io/healthcheck-interval-seconds	Intervalle entre les contrôles d'état, en secondes (s). Plage : [1, 50]. Valeur par défaut : `2`.
alb.ingress.kubernetes.io/healthy-threshold-count	Nombre de contrôles d'état réussis consécutifs requis pour marquer un serveur comme sain. Plage : [2, 10]. Valeur par défaut : `3`.
alb.ingress.kubernetes.io/unhealthy-threshold-count	Nombre de contrôles d'état échoués consécutifs requis pour marquer un serveur comme non sain. Plage : [2, 10]. Valeur par défaut : `3`.
alb.ingress.kubernetes.io/healthcheck-connect-port	Port utilisé pour les contrôles d'état. Valeur par défaut : `0`. Remarque `0` indique que le contrôle d'état utilise le port du serveur backend.

Redirection

Annotation

Description

alb.ingress.kubernetes.io/ssl-redirect

Redirigez les requêtes HTTP vers HTTPS (port 443) avec le code d'état 308. Consultez Configurer la redirection HTTP vers HTTPS.

true : Rediriger vers HTTPS.
false : Ne pas rediriger vers HTTPS.

Valeur par défaut : false.

Protocole utilisé par le service backend

Annotation

Description

alb.ingress.kubernetes.io/backend-protocol

Protocole utilisé par le groupe de serveurs backend. Consultez Prise en charge des protocoles HTTPS et gRPC sur les serveurs backend.

http : Utiliser HTTP.
https : Utiliser HTTPS.
grpc : Utiliser gRPC.

Valeur par défaut : http.

Remarque

Protocoles backend pris en charge par type d'écouteur :

Les écouteurs HTTP prennent en charge HTTP et HTTPS.
Les écouteurs HTTPS prennent en charge HTTP, HTTPS et gRPC.
Les écouteurs QUIC prennent en charge HTTP.

Réécriture

Annotation

Description

alb.ingress.kubernetes.io/rewrite-target

Chemin cible pour la réécriture du chemin. Consultez la section Réécriture du chemin.

Listener

Annotation

Description

alb.ingress.kubernetes.io/listen-ports

Ports et protocoles des listeners associés à la ressource Ingress. Consultez la section Configuration des ports d'écoute personnalisés.

Spécifiez les protocoles et les ports des listeners à associer aux règles Ingress :

'[{"HTTP": 80}]' : Associe au listener HTTP sur le port 80.
'[{"HTTPS": 443}]' : Associe au listener HTTPS sur le port 443.
'[{"QUIC": 443}]' : Associe au listener QUIC sur le port 443.
'[{"HTTP": 80}, {"HTTPS": 443}]' : Associe au listener HTTP sur le port 80 et au listener HTTPS sur le port 443.
'[{"HTTPS": 443}, {"QUIC": 443}]' : Associe au listener HTTPS sur le port 443 et au listener QUIC sur le port 443.

Démarrage progressif

Annotation

Description

alb.ingress.kubernetes.io/slow-start-enabled

Active le démarrage progressif. ALB Ingress transfère progressivement le trafic vers les nouveaux pods ajoutés afin d'éviter les pics de CPU et de mémoire lors du démarrage. Consultez la section Démarrage progressif du backend.

true : Activer
false : Désactiver

Valeur par défaut : désactivé.

alb.ingress.kubernetes.io/slow-start-duration

Durée en secondes (s) pendant laquelle le trafic augmente progressivement après le début du démarrage lent. Une durée plus longue signifie une augmentation plus lente.

Plage : [30, 900].

Valeur par défaut : 30.

Priorité

Annotation

Description

alb.ingress.kubernetes.io/order

Priorité relative de la règle de transfert. Les nombres les plus faibles indiquent une priorité plus élevée. Consultez la section Configuration de la priorité des règles de transfert.

Plage : [1, 1000].

Valeur par défaut : 10.

Déploiement progressif

Annotation	Description
alb.ingress.kubernetes.io/canary	Active le déploiement progressif Canary. Consultez la section Mise en œuvre du déploiement progressif avec ALB Ingress. `true` : Activer `false` : Désactiver Valeur par défaut : `false`.
alb.ingress.kubernetes.io/canary-by-header	En-tête de requête utilisé pour déclencher le routage Canary.
alb.ingress.kubernetes.io/canary-by-header-value	Valeur de l'en-tête qui déclenche le routage Canary.
alb.ingress.kubernetes.io/canary-by-cookie	Cookie utilisé pour déclencher le routage Canary.
alb.ingress.kubernetes.io/canary-weight	Pourcentage de requêtes acheminées vers le service spécifié (0–100). Consultez la section Pondération Canary.

Persistance de session

Annotation	Description
alb.ingress.kubernetes.io/sticky-session	Active la persistance de session pour le groupe de serveurs backend. Consultez la section Activation de la persistance de session avec des annotations. `true` : Activer la persistance de session. `false` : Désactiver la persistance de session. Valeur par défaut : `false`.
alb.ingress.kubernetes.io/sticky-session-type	Type de persistance de session. `Insert` : Mode d'insertion de cookie. ALB insère un cookie dans la réponse lors de la première visite du client. `Server` : Mode de réécriture de cookie. ALB réécrit le cookie existant si l'utilisateur en a défini un. Valeur par défaut : `Insert`.
alb.ingress.kubernetes.io/cookie-timeout	Délai d'expiration de la persistance de session, en secondes (s). Plage : [1, 86400]. Valeur par défaut : `1000`.
alb.ingress.kubernetes.io/cookie	Valeur de cookie personnalisée. Type : chaîne. Valeur par défaut : `""`.

Drainage de connexion

Annotation

Description

alb.ingress.kubernetes.io/connection-drain-enabled

Active le drainage de connexion. ALB Ingress maintient le trafic vers un pod pendant une période donnée après son passage à l'état Terminating ou en cas d'échec des vérifications d'intégrité. Après l'expiration du délai, les connexions sont fermées. Consultez la section Drainage de connexion.

true : Activer le drainage de connexion.
false : Désactiver le drainage de connexion.

Valeur par défaut : désactivé.

alb.ingress.kubernetes.io/connection-drain-timeout

Délai d'expiration du drainage de connexion, en secondes (s).

Plage : [0, 900].

Valeur par défaut : 300.

Équilibrage de charge

Annotation

Description

alb.ingress.kubernetes.io/backend-scheduler

Algorithme d'équilibrage de charge pour le groupe de serveurs backend. Consultez Spécifier l'algorithme d'équilibrage de charge pour le groupe de serveurs backend.

wrr : Tourniquet pondéré (Weighted Round-Robin). Des poids plus élevés augmentent la probabilité de sélection.
wlc : Moindre connexion pondérée (Weighted Least Connections). À poids égal, les serveurs ayant le moins de connexions actives ont une probabilité de sélection plus élevée.
sch : Hachage de l'adresse IP source. Les requêtes provenant de la même adresse IP source sont dirigées vers le même serveur.
uch : Hachage d'URL. Les requêtes comportant des paramètres d'URL identiques sont dirigées vers le même serveur.

Valeur par défaut : wrr.

alb.ingress.kubernetes.io/backend-scheduler-uch-value

Paramètre de hachage d'URL utilisé lorsque l'algorithme d'équilibrage de charge est défini sur uch.

Cross-domain

Annotation	Description
alb.ingress.kubernetes.io/enable-cors	Activez le partage de ressources cross-origin (CORS). Consultez Configuration CORS. `true` : Activez CORS. `false` : Désactivez CORS. Valeur par défaut : `false`.
alb.ingress.kubernetes.io/cors-allow-origin	Origines autorisées à effectuer des requêtes cross-domain. Valeur par défaut : `*`.
alb.ingress.kubernetes.io/cors-expose-headers	Liste des en-têtes exposés au client.
alb.ingress.kubernetes.io/cors-allow-methods	Méthodes HTTP autorisées pour les requêtes cross-domain. Spécifiez une ou plusieurs valeurs : `GET` `POST` `PUT` `DELETE` `HEAD` `OPTIONS` `PATCH` Valeur par défaut : `"GET, PUT, POST, DELETE, PATCH, OPTIONS"`.
alb.ingress.kubernetes.io/cors-allow-credentials	Autorisez les informations d'identification dans les requêtes cross-domain. `true` : Autorisez les informations d'identification. `false` : Interdisez les informations d'identification. Valeur par défaut : `true`.
alb.ingress.kubernetes.io/cors-max-age	Durée maximale, en secondes (s), pendant laquelle les réponses préliminaires (preflight) sont mises en cache par les navigateurs. Plage : [-1, 172800]. Valeur par défaut : `172800`. Remarque `-1` signifie une durée de mise en cache infinie.
alb.ingress.kubernetes.io/cors-allow-headers	Liste des en-têtes autorisés dans les requêtes cross-domain. Valeur par défaut : `"DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Authorization"`.

Transfert personnalisé

Annotation	Description
alb.ingress.kubernetes.io/actions.{svcName}	Action de transfert personnalisée. Consultez Définir des règles de transfert personnalisées pour ALB Ingress.
alb.ingress.kubernetes.io/conditions.{svcName}	Condition de transfert personnalisée.
alb.ingress.kubernetes.io/rule-direction.{svcName}	Direction du transfert personnalisé. `Request` : Appliquez le transfert personnalisé lors de la réception des requêtes. `Response` : Appliquez le transfert personnalisé lors de l'envoi des réponses. Valeur par défaut : `Request`.

Attachement IPv6 pour le groupe de serveurs backend

Annotation

Description

alb.ingress.kubernetes.io/enable-ipv6

Activez l'attachement IPv6 pour le groupe de serveurs backend. Consultez Attacher des adresses IPv6 aux groupes de serveurs backend.

true : Activez.
false : Désactivez.

Valeur par défaut : false.

Autre

Annotation

Description

alb.ingress.kubernetes.io/backend-keepalive

Activez les connexions persistantes vers les serveurs backend. Consultez Connexions persistantes vers les serveurs backend.

Valeur par défaut : false.

alb.ingress.kubernetes.io/traffic-limit-qps

Limitation du débit de requêtes par seconde (QPS).

Plage : [1, 1000000].

alb.ingress.kubernetes.io/use-regex

Autorisez les expressions régulières dans le champ Path. S'applique uniquement aux types de chemin Prefix.

Valeur par défaut : false.

Champs AlbConfig

Une ressource personnalisée AlbConfig définit une instance ALB et ses écouteurs. Consultez les détails des champs ci-dessous.

Développer pour afficher le YAML AlbConfig complet

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: alb-config-example
spec:
  # Set ALB instance properties based on your needs.
  config:
    id: ""   # ALB instance ID. Leave empty to create a new instance.
    name: alb-instance-name       
    addressAllocatedMode: Fixed
    addressType: Internet
    ipv6AddressType: Intranet
    addressIpVersion: IPv4
    resourceGroupId: ""
    edition: Standard
    deletionProtectionEnabled: false
    forceOverride: false
    listenerForceOverride: false
    zoneMappings:            # Virtual switches.
      - vSwitchId: vsw-uf6ccg2a9g71hx8go****
        zoneId: "" 
        allocationId:   eip-asdfas****         
        eipType: ""
      - vSwitchId: vsw-uf6nun9tql5t8nh15****
        zoneId: ""      
        allocationId: "eip-xxxx"
        eipType: ""
    securityGroupids:           
      - sg-uf6blkp8************ # Security group ID.
      - sg-djladhla************ # Security group ID.
    accessLogConfig:        # Simple Log Service.
      logProject: ""
      logStore: "alb_******"    
    billingConfig:           
      internetBandwidth: 0
      internetChargeType: ""
      payType: ""
      bandWidthPackageId: "cbwp-xxx" 
    modificationProtectionConfig:
      reason: ""
      status: ""
    tags:
      - key: example-key
        value: example-value
  listeners:
    # Set listener properties based on your needs.
    - port: 80
      protocol: HTTP         # HTTP: Use HTTP. HTTPS: Use HTTPS. QUIC: Use QUIC.
      gzipEnabled: null
      http2Enabled: null
      securityPolicyId: ""
      idleTimeout: 15
      loadBalancerId: ""
      description: "Listener description"
      caEnabled: false
      requestTimeout: 60
      quicConfig:
        quicUpgradeEnabled: false
        quicListenerId: ""
      defaultActions: []
      caCertificates: []
      certificates: []
      xForwardedForConfig:     # X-Forwarded- configuration.
        XForwardedForClientCertSubjectDNEnabled: false
        XForwardedForProtoEnabled: false
        XForwardedForClientCertIssuerDNEnabled: false
        XForwardedForSLBIdEnabled: false
        XForwardedForClientSrcPortEnabled: false
        XForwardedForClientCertFingerprintEnabled: false
        XForwardedForEnabled: true
        XForwardedForProcessingMode: append
        XForwardedForHostEnabled: false
        XForwardedForSLBPortEnabled: false
        XForwardedForClientCertClientVerifyEnabled: false
        XForwardedForClientCertSubjectDNAlias: ""
        XForwardedForClientCertClientVerifyAlias: ""
        XForwardedForClientCertIssuerDNAlias: ""
        XForwardedForClientCertFingerprintAlias: ""
        XForwardedForClientSourceIpsEnabled: false
        XForwardedForClientSourceIpsTrusted: ""
      logConfig:
        accessLogRecordCustomizedHeadersEnabled: false
        accessLogTracingConfig:
          tracingEnabled: false
          tracingSample: 100
          tracingType: Zipkin
      aclConfig:
        aclName: ""
        aclType: Black
        aclEntries: []
        aclIds: []
status:
  loadBalancer:
    dnsname: ""
    id: ""
    listeners:
      portAndProtocol: ""
      certificates:
        certificateId: ""
        isDefault: false

AlbConfig

Champ

Type de données

Description

apiVersion

Valeur fixe

Version de l'API pour cette ressource.

Valeur fixe : alibabacloud.com/v1.

kind

Valeur fixe

Type de ressource.

Valeur fixe : AlbConfig.

metadata

ObjectMeta

Métadonnées d'objet standard metadata.

spec

AlbConfigSpec

Paramètres décrivant les propriétés de l'instance ALB et des écouteurs.

status

AlbConfigStatus

Après réconciliation, l'état de l'instance est écrit dans status. Reflète l'état actuel de l'instance.

AlbConfigSpec

Champ

Type de données

Description

config

LoadBalancerSpec

Propriétés de l'instance ALB.

listeners

[ListenerSpec[]](#ApyPx)

Propriétés des écouteurs associés à l'instance.

LoadBalancerSpec

Champ	Type de données	Description
id	string	ID d'instance ALB. Renseignez ce champ pour activer le mode de réutilisation. Laissez-le vide pour créer une nouvelle instance. Consultez Créer un AlbConfig. Valeur par défaut : `""`.
name	string	Nom de l'instance ALB. Valeur par défaut : Généré automatiquement selon le modèle suivant : `k8s-{namespace}-{name}-{hashCode}`.
addressAllocatedMode	enum	Mode d'allocation des adresses. `Dynamic` : Au moins une adresse IP par zone. Les adresses IP s'adaptent automatiquement au trafic. Prend en charge jusqu'à 1 million de QPS. `Fixed` : Exactement une adresse IP fixe par zone. Élasticité limitée. Prend en charge jusqu'à 100 000 QPS. Valeur par défaut : `Fixed`.
addressType	enum	Type d'adresse IPv4. `Internet` : Mode public. Obtient automatiquement un nom de domaine public. `Intranet` : Mode privé. Valeur par défaut : `Internet`.
ipv6AddressType	enum	Type d'adresse IPv6. Ne doit pas nécessairement correspondre au type d'adresse IPv4. `Internet` : Mode public. Obtient automatiquement un nom de domaine public. `Intranet` : Mode privé. Valeur par défaut : `Intranet`.
addressIpVersion	enum	Indique si l'instance prend en charge la double pile (dual-stack). `IPv4` : IPv4 uniquement. `DualStack` : Double pile. Prend en charge à la fois IPv4 et IPv6. Valeur par défaut : `IPv4`.
resourceGroupId	string	ID du groupe de ressources. Valeur par défaut : `""`.
edition	enum	Édition des fonctionnalités. Impossible de la modifier en mode de réutilisation. `Standard` : Édition Standard. `StandardWithWaf` : Édition WAF améliorée. Consultez Protéger les services avec l'édition WAF améliorée d'ALB. Valeur par défaut : `Standard`.
deletionProtectionEnabled	bool	Champ réservé. Ne pas modifier.
forceOverride	bool	Forcer le remplacement des propriétés de l'instance en mode de réutilisation. `true` : Forcer le remplacement. `false` : Ne pas forcer le remplacement. `null` : Ne pas forcer le remplacement. Valeur par défaut : `false`.
listenerForceOverride	bool	Forcer le remplacement des propriétés de l'écouteur en mode de réutilisation. `true` : Forcer le remplacement. `false` : Ne pas forcer le remplacement. `null` : Ne pas forcer le remplacement. Valeur par défaut : `null`.
zoneMappings	ZoneMapping[]	Zones et configurations EIP.
accessLogConfig	AccessLogConfig	Collecte des journaux.
billingConfig	BillingConfig	Méthode de facturation.
modificationProtectionConfig	ModificationProtectionConfig	Mode de lecture seule de la configuration.
tags	Tag[]	Tags de l'instance.
securityGroupIds	string[]	IDs des groupes de sécurité pour l'instance ALB. Consultez Configurer les groupes de sécurité avec AlbConfig.

ZoneMapping

Champ

Type de données

Description

vSwitchId

string

(Obligatoire) ID du commutateur virtuel.

Valeur par défaut : "".

zoneId

string

Zone du commutateur virtuel. Conservez la valeur par défaut.

Valeur par défaut : "".

allocationId

string

ID de l'adresse IP élastique (EIP). Consultez Configurer les instances ALB avec AlbConfig.

Valeur par défaut : "eip-xxxx".

eipType

string

Champ réservé. Ne pas modifier.

AccessLogConfig

Champ

Type de données

Description

logProject

string

Nom du projet Simple Log Service.

Valeur par défaut : "".

logStore

string

Nom du Logstore Simple Log Service (SLS). Doit commencer par alb_. Si le Logstore n'existe pas, il est créé automatiquement. Consultez Activer les journaux d'accès pour Simple Log Service.

Valeur par défaut : "alb_****".

BillingConfig

Champ

Type de données

Description

internetBandwidth

int

Champ réservé. Ne le modifiez pas.

internetChargeType

string

Champ réservé. Ne le modifiez pas.

payType

enum

Champ réservé. Ne le modifiez pas.

bandWidthPackageId

string

ID du package Internet Shared Bandwidth à associer. Le détachement n'est pas possible après l'association. Consultez la section Configuration du package Internet Shared Bandwidth.

Valeur par défaut : "cbwp-xxx".

ModificationProtectionConfig

Champ

Type de données

Description

reason

string

Champ réservé.

status

string

Champ réservé.

Tag

Champ

Type de données

Description

key

string

Clé du tag.

Valeur par défaut : "".

value

string

Valeur du tag.

Valeur par défaut : "".

ListenerSpec

Champ	Type de données	Description
gzipEnabled	bool	Activez la compression des données. Consultez la section Utilisation de la compression des données. `true` : active la compression. `false` : désactive la compression. `null` : active la compression. Valeur par défaut : `null`.
http2Enabled	bool	Activez le protocole HTTP/2. `true` : active HTTP/2. `false` : désactive HTTP/2. `null` : active HTTP/2. Valeur par défaut : `null`.
port	int	(Obligatoire) Port utilisé par l'écouteur. Valeur par défaut : `0`.
protocol	enum	(Obligatoire) Protocole utilisé par l'écouteur. `HTTP` : utilise HTTP. `HTTPS` : utilise HTTPS. `QUIC` : utilise QUIC.
securityPolicyId	string	ID de la politique de sécurité TLS. Valeur par défaut : `""`.
idleTimeout	int	Délai d'inactivité de la connexion, en secondes (s). Plage : [1, 600]. Valeur par défaut : `15`. Remarque Une valeur de 0 utilise la valeur par défaut.
loadBalancerId	string	Champ réservé. Ne le modifiez pas.
description	string	Nom de l'écouteur. Valeur par défaut : généré automatiquement selon ce modèle : `ingress-auto-listener-{port}`.
caEnabled	bool	Activez l'authentification mutuelle. `true` : active l'authentification mutuelle. `false` : désactive l'authentification mutuelle. Valeur par défaut : `false`.
requestTimeout	int	Délai d'expiration de la requête, en secondes (s). Plage : [1, 600]. Valeur par défaut : `60`.
quicConfig	QuicConfig	Configuration de l'écouteur QUIC.
defaultActions	Action[]	Champ réservé. Ne le modifiez pas.
caCertificates	Certificate[]	Certificat CA racine pour l'écouteur.
certificates	Certificate[]	Certificat serveur pour l'écouteur.
xForwardedForConfig	XForwardedForConfig	Configuration X-Forwarded-.
logConfig	LogConfig	Configuration de journalisation pour l'écouteur.
aclConfig	AclConfig	Contrôle d'accès.

QuicConfig

Champ

Type de données

Description

quicUpgradeEnabled

bool

Activez la mise à niveau QUIC. Associez ou dissociez les écouteurs QUIC et HTTPS. Consultez Utilisation des écouteurs QUIC pour prendre en charge HTTP/3.

true : activez la mise à niveau QUIC et associez QUIC à HTTPS.
false : désactivez la mise à niveau QUIC et n'associez pas QUIC à HTTPS.

Valeur par défaut : false.

quicListenerId

string

Écouteur HTTPS associé à l'écouteur QUIC.

Valeur par défaut : "".

Certificate

Champ

Type de données

Description

IsDefault

bool

Définissez ce certificat comme certificat par défaut. Consultez Configuration des certificats HTTPS pour une communication chiffrée.

true : définissez comme certificat par défaut.
false : ne définissez pas comme certificat par défaut.

Valeur par défaut : false.

Important

Vous ne pouvez définir qu'un seul certificat comme certificat par défaut.

CertificateId

string

Identifiant du certificat (CertIdentifier).

Valeur par défaut : "".

XForwardedForConfig

Champ	Type de données	Description
XForwardedForClientCertSubjectDNEnabled	bool	Ajoute l'en-tête `X-Forwarded-Clientcert-subjectdn` aux messages HTTP transférés. Conserve les informations relatives au propriétaire du certificat client. `true` : ajoute le champ. `false` : n'ajoute pas le champ. Valeur par défaut : `false`.
XForwardedForProtoEnabled	bool	Ajoute l'en-tête `X-Forwarded-Proto` aux messages HTTP transférés. Enregistre le protocole de l'écouteur ALB. `true` : ajoute le champ. `false` : n'ajoute pas le champ. Valeur par défaut : `false`.
XForwardedForClientCertIssuerDNEnabled	bool	Ajoute l'en-tête `X-Forwarded-Clientcert-issuerdn` aux messages HTTP transférés. Conserve les informations relatives à l'émetteur du certificat client. `true` : ajoute le champ. `false` : n'ajoute pas le champ. Valeur par défaut : `false`.
XForwardedForSLBIdEnabled	bool	Ajoute l'en-tête `X-Forwarded-For-SLB-ID` aux messages HTTP transférés. Enregistre l'ID de l'instance ALB. `true` : ajoute le champ. `false` : n'ajoute pas le champ. Valeur par défaut : `false`.
XForwardedForClientSrcPortEnabled	bool	Ajoute l'en-tête `X-Forwarded-Client-Port` aux messages HTTP transférés. Conserve le port client. `true` : ajoute le champ. `false` : n'ajoute pas le champ. Valeur par défaut : `false`.
XForwardedForClientCertFingerprintEnabled	bool	Ajoute l'en-tête `X-Forwarded-Clientcert-fingerprint` aux messages HTTP transférés. Conserve l'empreinte numérique du certificat client. `true` : ajoute le champ. `false` : n'ajoute pas le champ. Valeur par défaut : `false`.
XForwardedForEnabled	bool	Le champ `X-Forwarded-For` est ajouté aux en-têtes de requête des messages HTTP transférés par une instance ALB afin de conserver l'adresse IP d'origine du client. Actuellement, vous ne pouvez pas désactiver cette fonctionnalité en définissant la valeur sur `false` . Pour désactiver cette fonctionnalité ou utiliser des fonctions avancées, mettez à niveau ALB Ingress Controller vers la version 2.15.0 ou ultérieure et utilisez `XForwardedForProcessingMode`.
XForwardedForProcessingMode	string	`append` : si la requête d'origine ne contient pas d'en-tête X-Forwarded-For, ALB en crée un avec l'adresse IP du client. Sinon, ALB ajoute l'adresse IP du client à l'en-tête X-Forwarded-For existant avant de l'envoyer au serveur backend. `remove` : ALB supprime l'en-tête X-Forwarded-For de la requête avant de l'envoyer au serveur backend. `preserve` : ALB ne modifie pas l'en-tête X-Forwarded-For de la requête avant de l'envoyer au serveur backend. Si `XForwardedForEnabled` et `XForwardedForProcessingMode` sont tous deux configurés dans `XForwardedForConfig`, `XForwardedForProcessingMode` est prioritaire. L'écouteur de l'instance ALB ajoutera, supprimera ou conservera l'en-tête X-Forwarded-For en fonction de la valeur configurée.
XForwardedForHostEnabled	bool	Ajoute l'en-tête `X-Forwarded-Host` aux messages HTTP transférés. Enregistre le nom de domaine utilisé par le client pour accéder à l'instance ALB.
XForwardedForSLBPortEnabled	bool	Ajoute l'en-tête `X-Forwarded-Port` aux messages HTTP transférés. Enregistre le port de l'écouteur ALB. `true` : ajoute le champ. `false` : n'ajoute pas le champ. Valeur par défaut : `false`.
XForwardedForClientCertClientVerifyEnabled	bool	Ajoute l'en-tête `X-Forwarded-Clientcert-clientverify` aux messages HTTP transférés. Conserve le résultat de la vérification du certificat client. `true` : ajoute le champ. `false` : n'ajoute pas le champ. Valeur par défaut : `false`.
XForwardedForClientCertSubjectDNAlias	string	Alias personnalisé pour l'en-tête `X-Forwarded-Clientcert-subjectdn` ajouté par `XForwardedForClientCertSubjectDNEnabled`. Nécessite que `XForwardedForClientCertSubjectDNEnabled` soit défini sur `true`. Valeur par défaut : `""`.
XForwardedForClientCertClientVerifyAlias	string	Alias personnalisé pour l'en-tête `X-Forwarded-Clientcert-clientverify` ajouté par `XForwardedForClientCertClientVerifyEnabled`. Nécessite que `XForwardedForClientCertClientVerifyEnabled` soit défini sur `true`. Valeur par défaut : `""`.
XForwardedForClientCertIssuerDNAlias	string	Alias personnalisé pour l'en-tête `X-Forwarded-ClientCert-IssuerDN` ajouté par `XForwardedForClientCertIssuerDNEnabled`. Nécessite que `XForwardedForClientCertIssuerDNEnabled` soit défini sur `true`. Valeur par défaut : `""`.
XForwardedForClientCertFingerprintAlias	string	Alias personnalisé pour l'en-tête `X-Forwarded-Client-Cert-Fingerprint` ajouté par `XForwardedForClientCertFingerprintEnabled`. Nécessite que `XForwardedForClientCertFingerprintEnabled` soit défini sur `true`. Valeur par défaut : `""`.
XForwardedForClientSourceIpsEnabled	bool	Permet à ALB de trouver l'adresse IP d'origine du client à partir de l'en-tête `X-Forwarded-For`. `true` : autoriser. Vous devez également configurer `XForwardedForClientSourceIpsTrusted` avec une valeur valide. `false` : interdire. Valeur par défaut : `false`.
XForwardedForClientSourceIpsTrusted	string	Spécifiez les adresses IP de proxy de confiance. Indiquez des adresses IP ou des blocs CIDR valides, séparés par des points-virgules (`;`), sans espaces. Nécessite que `XForwardedForClientSourceIpsEnabled` soit défini sur `true`. Définissez la liste des IP de confiance sur `0.0.0.0/0` : obtient l'adresse la plus à gauche de l'en-tête `X-Forwarded-For`, qui correspond à l'adresse IP d'origine du client. Définissez la liste des IP de confiance sur `IP proxy1 ; IP proxy2,..` : obtient la première adresse à partir de la droite qui ne figure pas dans la liste et l'utilise comme adresse IP d'origine du client. Exemple : `192.168.x.x;192 168.x.x/16`

AclConfig

Champ	Type de données	Description
aclName	string	Nom de la politique ACL associée en mode AclEntry. Consultez Configurer une ACL pour le contrôle d'accès. Valeur par défaut : `""`.
aclType	enum	Mode de contrôle d'accès. `Black` : Mode liste de blocage. Bloque l'accès depuis des adresses IP spécifiques. `White` : Mode liste d'autorisation. Autorise l'accès uniquement depuis des adresses IP spécifiques.
aclEntries	string	Entrées de la politique d'accès. Valeur par défaut : `""`. Important N'utilisez pas conjointement `aclEntries` et `aclIds`. Consultez Configurer une ACL pour le contrôle d'accès.
aclIds	string	Liste des ID de politiques existantes à associer. Valeur par défaut : `""`.

LogConfig

Champ

Type de données

Description

accessLogRecordCustomizedHeadersEnabled

bool

Utiliser des en-têtes personnalisés dans les journaux d'accès de l'instance ALB.

true : Utiliser des en-têtes personnalisés.
false : Ne pas utiliser d'en-têtes personnalisés.

Valeur par défaut : false.

accessLogTracingConfig

AccessLogTracingConfig

Configuration de Tracing Analysis. Consultez Activer Xtrace pour Tracing Analysis avec AlbConfig.

AccessLogTracingConfig

Champ	Type de données	Description
tracingEnabled	bool	Activez Tracing Analysis. `true` : Activer Tracing Analysis. `false` : Désactiver Tracing Analysis. Valeur par défaut : `false`.
tracingSample	int	Taux d'échantillonnage pour Tracing Analysis, en unités de `0.01 %`. Plage : [1, 10000].
tracingType	enum	Algorithme d'échantillonnage pour Tracing Analysis. `Zipkin` : Utiliser l'algorithme Zipkin.

AlbConfigStatus

Important

Les champs suivants sont réservés à ALB Ingress pour enregistrer l'état. Ne modifiez pas ces champs : AlbConfigStatus, LoadBalancerStatus, ListenerStatus et AppliedCertificate.

Champ

Sortie

Description

loadBalancer

LoadBalancerStatus

Champ réservé. Ne pas modifier.

État de l'instance ALB.

LoadBalancerStatus

Champ

Sortie

Description

dnsname

string

Champ réservé. Ne pas modifier.

Adresse DNS de l'instance ALB.

string

Champ réservé. Ne pas modifier.

ID de l'instance ALB.

listeners

ListenerStatus

Champ réservé. Ne pas modifier.

Propriétés des écouteurs de l'instance ALB.

ListenerStatus

Champ

Sortie

Description

portAndProtocol

string

Champ réservé. Ne pas modifier.

Port et protocole utilisés par l'écouteur.

certificates

AppliedCertificate

Champ réservé. Ne pas modifier.

Certificat associé à l'écouteur.

AppliedCertificate

Champ

Sortie

Description

certificateId

string

Champ réservé. Ne pas modifier.

CertIdentifier du certificat.

isDefault

bool

Champ réservé. Ne pas modifier.

Indique si le certificat est le certificat par défaut.

Références

Consultez Configurer des instances ALB avec AlbConfig.
Consultez Utilisation avancée d'ALB Ingress.