Container Service for Kubernetes:Mettre à l'échelle les pods en fonction des métriques Nginx Ingress

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

• Un cluster ACK avec kubectl configuré

• Un contrôleur Ingress avec la collecte de journaux SLS activée (activée par défaut lors de la création d'un cluster)

• Les permissions nécessaires pour installer des charts Helm et créer des ressources HPA

Fonctionnement

Le composant ack-alibaba-cloud-metrics-adapter fait le lien entre les services de surveillance Alibaba Cloud et l'API External Metrics de Kubernetes. Une fois installé, le HPA peut interroger les métriques Ingress SLS, telles que sls_ingress_qps et sls_ingress_latency_p9999, et ajuster le nombre de réplicas de votre Deployment en conséquence.

Étape 1 : Installer ack-alibaba-cloud-metrics-adapter

Le composant ack-alibaba-cloud-metrics-adapter permet à Kubernetes de récupérer les données de surveillance des services Alibaba Cloud, notamment ECS, SLB et RDS, via l'API External Metrics.

1. Connectez-vous à la Console de gestion Container Service. Dans le volet de navigation de gauche, cliquez sur Clusters.

2. Cliquez sur le nom de votre cluster. Dans le volet de navigation de gauche, choisissez Applications > Helm.

3. Sur la page Helm, cliquez sur Create. Renseignez la configuration des Basic Information, sélectionnez ack-alibaba-cloud-metrics-adapter, puis cliquez sur Next.

4. Sur la page Parameter Settings, sélectionnez une Chart Version et cliquez sur OK.

Étape 3 : Créer un Ingress

1. Dans le volet de navigation de gauche de la page de gestion du cluster, choisissez Network > Ingress. Sur la page Ingress, cliquez sur Create Ingress.

2. Remplissez les champs obligatoires et cliquez sur OK. La console vous redirige vers la page Ingress.

3. Dans la colonne Name, cliquez sur le nom de l'Ingress pour afficher ses règles de routage. Pour plus de détails, consultez la rubrique Gérer Ingress.

Étape 4 : Configurer le HPA

Le HPA prend en charge deux métriques Ingress SLS aux sémantiques de mise à l'échelle différentes :

1. Créez le fichier ingress-hpa.yaml avec le contenu suivant :

   Paramètre	Obligatoire	Description
   sls.ingress.route	Oui	Format : <namespace>-<svc>-<port>. Exemple : default-nginx-80
   sls.logstore	Oui	Le Logstore dans Simple Log Service. Par défaut : nginx-ingress
   sls.project	Oui	Le Project dans Simple Log Service. Par défaut : k8s-log-<cluster-id>
   sls.internal.endpoint	Non	Indique si l'accès à SLS se fait via le réseau interne. Par défaut : true. Définissez la valeur sur false pour utiliser le réseau public.

   apiVersion: autoscaling/v2
   kind: HorizontalPodAutoscaler
   metadata:
     name: ingress-hpa
   spec:
     scaleTargetRef:
       apiVersion: apps/v1
       kind: Deployment
       name: nginx-deployment-basic
     minReplicas: 2
     maxReplicas: 10
     metrics:
       - type: External
         external:
           metric:
             name: sls_ingress_qps
             selector:
               matchLabels:
                 sls.project: "<your-sls-project>"      # Default: k8s-log-<cluster-id>
                 sls.logstore: "nginx-ingress"           # Default SLS Logstore for Nginx Ingress logs
                 sls.ingress.route: "default-nginx-80"  # Format: <namespace>-<svc>-<port>
           target:
             type: AverageValue
             averageValue: 10   # Scale up when average QPS per pod exceeds 10
       - type: External
         external:
           metric:
             name: sls_ingress_latency_p9999
             selector:
               matchLabels:
                 sls.project: "<your-sls-project>"
                 sls.logstore: "nginx-ingress"
                 sls.ingress.route: "default-nginx-80"
                 # sls.internal.endpoint: "true"         # true = internal network (default); false = public network
           target:
             type: Value
             value: 10   # Scale up when 99.99th-percentile latency exceeds 10 ms

   Le tableau suivant décrit les paramètres utilisés dans la configuration du HPA.

2. Appliquez la configuration :

   kubectl apply -f ingress-hpa.yaml

Vérifier la mise à l'échelle

Exécutez un test de charge de 5 minutes sur le domaine de votre Ingress pour déclencher la mise à l'échelle ascendante :

# Send 10 concurrent requests for 300 seconds
ab -t 300 -c 10 <domain-name-configured-for-the-ingress>

Surveillez l'état du HPA en temps réel :

kubectl get hpa ingress-hpa --watch

Sortie attendue lorsque la mise à l'échelle ascendante réussit (REPLICAS atteint MAXPODS) :

NAME            REFERENCE                              TARGETS           MINPODS   MAXPODS   REPLICAS   AGE
ingress-hpa     Deployment/nginx-deployment-basic      21/10 (avg)       2         10        10         7m49s

Lorsque le trafic retombe sous le seuil, la valeur de REPLICAS revient au minimum.

Dépannage

Commencez le dépannage en exécutant la commande kubectl describe hpa ingress-hpa et en vérifiant le champ Conditions . Utilisez les colonnes Type et Status pour identifier le problème, puis suivez les étapes ci-dessous.

La colonne target affiche unknown

1. Exécutez la commande kubectl describe hpa <hpa-name> et vérifiez le champ Conditions :

   • Si AbleToScale est défini sur False : vérifiez que le Deployment est sain.

   • Si ScalingActive est défini sur False : passez à l'étape suivante.

2. Exécutez la commande suivante pour vérifier si l'API External Metrics est disponible :

   kubectl get --raw "/apis/external.metrics.k8s.io/v1beta1/"

   Si la réponse est Error from server (NotFound), vérifiez l'état de démarrage de alibaba-cloud-metrics-adapter. Si l'adaptateur fonctionne normalement et que les métriques HPA sont liées à Ingress, déployez d'abord le composant SLS. Pour plus de détails, consultez la rubrique Collecter et analyser les journaux d'accès Nginx Ingress.

3. Vérifiez le format de sls.ingress.route. La valeur doit être <namespace>-<svc>-<port>, où :

   • namespace : le namespace où réside l'Ingress

   • svc : le nom du Service associé à l'Ingress

   • port : le nom du port de ce Service

Échec du téléchargement de l'image ack-alibaba-cloud-metrics-adapter (version 1.3.7)

Lors de la mise à niveau vers la version 1.3.7, le message d'erreur suivant peut s'afficher :

Failed to pull image "registry-<region-id>-vpc.ack.aliyuncs.com/acs/alibaba-cloud-metrics-adapter-amd64:v0.2.9-ba634de-aliyun".

Ce problème survient car le composant ne prend pas en charge les mises à jour directes. Pour le résoudre :

1. Sauvegardez la configuration actuelle du composant.

2. Désinstallez l'ancienne version.

3. Installez la dernière version en utilisant la configuration sauvegardée.

FAQ

kubectl get --raw "/apis/external.metrics.k8s.io/v1beta1/namespaces/*/sls_ingress_qps?labelSelector=sls.project={{SLS_Project}},sls.logstore=nginx-ingress"

Étapes suivantes

• Mise à l'échelle horizontale des pods basée sur les métriques Alibaba Cloud Prometheus

• Mise à l'échelle horizontale des pods multi-applications basée sur les métriques de trafic Nginx Ingress