Alibaba Cloud Service Mesh:Champs CRD ASMLocalRateLimiter

Fonctionnement

ASMLocalRateLimiter utilise un algorithme de bucket à jetons pour contrôler le débit des requêtes :

1. Chaque proxy Envoy maintient un bucket à jetons contenant un nombre configuré de jetons (quota).

2. Les jetons sont reconstitués à intervalles réguliers (fill_interval).

3. Si aucun jeton n'est disponible, la requête est rejetée avec le statut HTTP 429 (configurable).

Par défaut, tous les threads de travail d'un même processus Envoy partagent un seul bucket à jetons. Définissez per_downstream_connection sur true pour allouer un bucket distinct par connexion.

Aperçu de la structure CRD

Ce squelette illustre l'imbrication des champs au sein de la CRD :

apiVersion: istio.alibabacloud.com/v1beta1   # or v1
kind: ASMLocalRateLimiter
metadata:
  name: <rule-name>
  namespace: <namespace>
spec:
  workloadSelector:
    labels:
      <label-key>: <label-value>
  isGateway: true | false
  configs:
    - name: <config-name>
      match:
        vhost:
          name: <virtual-host-name>
          port: <port>
          route:
            name_match: <route-name>
      limit:
        status: <http-status-code>
        fill_interval:
          seconds: <int>
          nanos: <int>
        quota: <int>
        per_downstream_connection: true | false
        custom_response_body: <string>
        response_header_to_add:
          <header-name>: <header-value>
      limit_overrides:
        - request_match:
            header_match:
              - name: <header-name>
                exact_match: <value>
            query_match:
              - name: <param-name>
                exact_match: <value>
          limit:
            fill_interval:
              seconds: <int>
            quota: <int>

Exemple de configuration

L'exemple suivant applique une limitation de débit à une passerelle d'entrée. Deux hôtes virtuels bénéficient de limites différentes : www.example1.com à 10 requêtes par seconde, et www.example2.com à 100 requêtes par seconde.

apiVersion: istio.alibabacloud.com/v1beta1
kind: ASMLocalRateLimiter
metadata:
  name: for-api-test
  namespace: default
spec:
  workloadSelector:
    labels:
      app: istio-ingressgateway
  isGateway: true
  configs:
    - match:
        vhost:
          name: "www.example1.com" # If multiple vhosts are configured on the gateway, enter the name of the last vhost.
          port: 80
          route:
            name_match: "test1" # The name of the route that is configured for the virtual service. If the virtual service does not have the specified route, the rate limiting does not take effect.
      limit:
         fill_interval:
            seconds: 1
         quota: 10
    - match:
        vhost:
          name: "www.example2.com"
          port: 80
          route:
            name_match: "test1"
      limit:
         fill_interval:
            seconds: 1
         quota: 100

Valeurs apiVersion prises en charge

Si vous avez précédemment défini l'apiVersion sur istio.alibabacloud.com/v1beta1 pour ASMCircuitBreaker dans un cluster Container Service for Kubernetes (ACK), remplacez cette valeur par istio.alibabacloud.com/v1 et redéployez le cluster.

spec

Pour plus d'informations, consultez Configurer la limitation de débit locale sur une passerelle d'entrée.

LocalRateLimiterConfig

RatelimitMatch

LimitConfig

RateLimitOverrideConfig

Utilisez les remplacements pour appliquer une limite de débit différente aux requêtes correspondant à des en-têtes ou paramètres de requête spécifiques, tout en conservant la limite de débit de base pour le reste du trafic.

VirtualHostMatch

RouteMatch

RequestMatcher

Lorsque header_match et query_match sont tous deux spécifiés, une requête doit satisfaire toutes les conditions pour être mise en correspondance.

HeaderMatcher

Spécifiez exactement un champ de mode de correspondance (regex_match, exact_match, prefix_match, suffix_match ou present_match) par matcher.

QueryParameterMatcher

Spécifiez exactement un champ de mode de correspondance (exact_match, prefix_match, suffix_match, regex_match, contains_match ou present_match) par matcher.