Skip to content

Commit fbc6f51

Browse files
author
k0rventen
committed
few more typos & fixes
1 parent e2a75f4 commit fbc6f51

File tree

1 file changed

+60
-70
lines changed

1 file changed

+60
-70
lines changed

content/fr/docs/tasks/run-application/horizontal-pod-autoscale-walkthrough.md

Lines changed: 60 additions & 70 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,13 @@
11
---
2-
3-
title: Découverte de l'HorizontalPodAutoscaler
2+
title: "Découverte de l'HorizontalPodAutoscaler"
43
content_type: task
54
weight: 100
65
min-kubernetes-server-version: 1.23
76
---
87

98
<!-- overview -->
109

11-
Un [HorizontalPodAutoscaler](/docs/tasks/run-application/horizontal-pod-autoscale/) (HPA pour faire court)
10+
Un [HorizontalPodAutoscaler](/docs/tasks/run-application/horizontal-pod-autoscale/) (raccourci en HPA)
1211
met à jour automatiquement une ressource de charge de travail
1312
(comme un {{< glossary_tooltip text=Deployment term_id=deployment >}}
1413
ou un {{< glossary_tooltip text=StatefulSet term_id=statefulset >}}),
@@ -23,17 +22,16 @@ aux Pods qui sont déjà en cours d'exécution pour la charge de travail.
2322

2423
Si la charge diminue et que le nombre de Pods est supérieur au minimum configuré,
2524
le HorizontalPodAutoscaler indique à la ressource de charge de travail
26-
(le Deployment, le StatefulSet ou une autre ressource similaire)
27-
de réduire son échelle.
25+
(le Deployment, le StatefulSet ou une autre ressource similaire)
26+
de réduire son échelle (nombre de réplicas).
2827

29-
Ce document vous guide à travers un exemple d'activation de HorizontalPodAutoscaler pour gérer
30-
automatiquement l'échelle d'une application web d'exemple.
28+
Ce document vous guide à travers un exemple d'activation de HorizontalPodAutoscaler pour gérer
29+
automatiquement l'échelle d'une application web.
3130
Cette charge de travail d'exemple est Apache httpd exécutant du code PHP.
3231

3332
## {{% heading prerequisites %}}
3433
{{< include task-tutorial-prereqs.md >}} {{< version-check >}} Si vous utilisez
35-
une version plus ancienne de Kubernetes,
36-
consultez la version de la documentation correspondante
34+
une version plus ancienne de Kubernetes, consultez la version de la documentation correspondante
3735
(voir [versions de documentation disponibles](/docs/home/supported-doc-versions/)).
3836

3937
Pour suivre ce guide, vous devez également utiliser un cluster qui dispose d'un
@@ -43,18 +41,18 @@ Le Metrics Server Kubernetes collecte les métriques des ressources des
4341
{{<glossary_tooltip term_id=kubelet text=kubelets>}} de votre cluster et expose
4442
ces métriques via l'[API Kubernetes](/docs/concepts/overview/kubernetes-api/),
4543
en utilisant un [APIService](/docs/concepts/extend-kubernetes/api-extension/apiserver-aggregation/)
46-
pour ajouter de nouveaux types de ressources représentant
47-
les lectures de métriques.
44+
pour ajouter de nouveaux types de ressources représentant les lectures de métriques.
4845

49-
Pour apprendre comment déployer le Metrics Server, consultez la [documentation du metrics-server](https://github.com/kubernetes-sigs/metrics-server#deployment).
46+
Pour apprendre comment déployer le Metrics Server, consultez la [documentation de metrics-server](https://github.com/kubernetes-sigs/metrics-server#deployment).
5047

5148
<!-- steps -->
5249

5350
## Exécutez et exposez le serveur php-apache
51+
5452
Pour démontrer un HorizontalPodAutoscaler, vous commencerez par démarrer un
55-
déploiement qui exécute un conteneur utilisant l'image `hpa-example`
53+
Deployment qui exécute un conteneur utilisant l'image `hpa-example`
5654
et l'expose en tant que {{< glossary_tooltip term_id=service>}} en utilisant le
57-
manifeste suivant: {{< codenew file=application/php-apache.yaml >}}
55+
manifeste suivant: {{< codenew file=application/php-apache.yaml >}}
5856

5957
Pour créer les ressources, exécutez la commande suivante:
6058
```shell
@@ -68,25 +66,25 @@ service/php-apache created
6866

6967
## Créer le HorizontalPodAutoscaler {#create-horizontal-pod-autoscaler}
7068

71-
Maintenant que le serveur est en cours d'exécution, créez l'autoscaler
72-
à l'aide de `kubectl`. Il existe une sous-commande
73-
[`kubectl autoscale`](/docs/reference/generated/kubectl/kubectl-commands#autoscale), faisant partie de `kubectl`, qui vous aide à le faire.
69+
Maintenant que le serveur est en cours d'exécution, créez l'autoscaler à l'aide de `kubectl`.
70+
Il existe une sous-commande [`kubectl autoscale`](/docs/reference/generated/kubectl/kubectl-commands#autoscale),
71+
faisant partie de `kubectl`, qui vous aide à le faire.
7472

7573
Vous allez bientôt exécuter une commande qui crée un HorizontalPodAutoscaler
76-
qui maintient entre 1 et 10 répliques des Pods contrôlés par le déploiement
77-
php-apache que vous avez créé à la première étape de ces instructions.
74+
qui maintient entre 1 et 10 réplicas des Pods contrôlés par le déploiement
75+
php-apache que vous avez créé lors de la première étape.
7876

79-
En gros, le HPA ({{<glossary_tooltip text="contrôleur" term_id="controller">}})
80-
augmentera ou diminuera le nombre de répliques (en mettant à jour le déploiement)
81-
pour maintenir une utilisation moyenne de l'UC de 50% sur l'ensemble des Pods.
77+
Généralement, le HPA ({{<glossary_tooltip text="contrôleur" term_id="controller">}})
78+
augmentera ou diminuera le nombre de réplicas (en mettant à jour le déploiement)
79+
pour maintenir une utilisation CPU moyenne de 50% sur l'ensemble des Pods.
8280

8381
Ensuite, le déploiement met à jour le ReplicaSet - cela fait partie du
8482
fonctionnement de tous les déploiements dans Kubernetes - puis le ReplicaSet
8583
ajoute ou supprime des Pods en fonction des modifications apportées à son champ `.spec`.
8684

8785
Étant donné que chaque pod demande 200 milli-cores via `kubectl run`,
88-
cela signifie une utilisation moyenne de l'UC de 100 milli-cores.
89-
Consultez les détails de l'algorithme pour plus d'informations sur l'algorithme.
86+
cela signifie une utilisation CPU moyenne de 100 milli-cores.
87+
Consultez les [détails de l'algorithme](/docs/tasks/run-application/horizontal-pod-autoscale/#algorithm-details) pour plus d'informations sur l'algorithme.
9088

9189
Créez le HorizontalPodAutoscaler :
9290

@@ -98,7 +96,7 @@ kubectl autoscale deployment php-apache --cpu-percent=50 --min=1 --max=10
9896
horizontalpodautoscaler.autoscaling/php-apache autoscaled
9997
```
10098

101-
Vous pouvez visualiser le statut actuel du HPA avec la commande:
99+
Vous pouvez visualiser le statut actuel du nouvel HorizontalPodAutoscaler avec la commande:
102100

103101
```shell
104102
# Vous pouvez utiliser "hpa" ou "horizontalpodautoscaler"; les deux appelations fonctionnent.
@@ -116,7 +114,7 @@ cela signifie qu'ils existaient déjà et ce n'est généralement pas un problè
116114

117115
Veuillez noter que la consommation actuelle de CPU est de 0 %
118116
car il n'y a pas de clients envoyant des requêtes au serveur
119-
(la colonne "TARGET" montre la moyenne de tous les Pods
117+
(la colonne ``TARGET`` montre la moyenne de tous les Pods
120118
contrôlés par le déploiement correspondant).
121119

122120
## Augmenter la charge {#increase-load}
@@ -191,7 +189,7 @@ NAME REFERENCE TARGET MINPODS MAXPODS REPL
191189
php-apache Deployment/php-apache/scale 0% / 50% 1 10 1 11m
192190
```
193191

194-
et le nombre de réplicas du Deployment aura descendu:
192+
et le nombre de réplicas du Deployment sera descendu:
195193

196194
```shell
197195
kubectl get deployment php-apache
@@ -202,7 +200,7 @@ NAME READY UP-TO-DATE AVAILABLE AGE
202200
php-apache 1/1 1 1 27m
203201
```
204202

205-
Une fois que la consommation CPU atteindra 0, le HPA ajustera automatiquement le nombre de réplicas à 0.
203+
Une fois que la consommation CPU atteindra 0, le HPA ajustera automatiquement le nombre de réplicas à 1.
206204

207205
Cette étape peut prendre quelques minutes.
208206

@@ -254,30 +252,27 @@ status:
254252
```
255253
256254
Veuillez noter que le champ `targetCPUUtilizationPercentage` a été remplacé par un tableau appelé `metrics`.
257-
La métrique d'utilisation du processeur (CPU) est une *métrique de ressource*, car elle est représentée en pourcentage
258-
d'une ressource spécifiée sur les conteneurs de pod.
255+
La métrique d'utilisation du CPU est une *métrique de ressource*, car elle est représentée en pourcentage d'une ressource spécifiée sur les conteneurs de pod.
259256
Notez que vous pouvez spécifier d'autres métriques de ressource en plus du CPU.
260257
Par défaut, la seule autre métrique de ressource prise en charge est la mémoire.
261258
Ces ressources ne changent pas de nom d'un cluster à l'autre et devraient
262259
toujours être disponibles tant que l'API `metrics.k8s.io` est disponible.
263260

264-
Vous pouvez également spécifier des métriques de ressource en termes de valeurs directes,
265-
au lieu de pourcentages de la valeur demandée,
261+
Vous pouvez également spécifier des métriques de ressource en termes de valeurs directes, au lieu de pourcentages de la valeur demandée,
266262
en utilisant un `target.type` de `AverageValue` au lieu de `Utilization`,
267263
et en définissant le champ correspondant `target.averageValue` au lieu de `target.averageUtilization`.
268264

269-
Il existe deux autres types de métriques, tous deux considérés comme des *métriques personnalisées* :
270-
les métriques de pod et les métriques d'objet.
265+
Il existe deux autres types de métriques, tous deux considérés comme des *métriques personnalisées*: les métriques de pod et les métriques d'objet.
271266
Ces métriques peuvent avoir des noms spécifiques au cluster et
272-
nécessitent une configuration de surveillance de cluster plus avancée.
267+
nécessitent une configuration de la surveillance du cluster plus avancée.
273268

274-
Le premier de ces types de métriques alternatifs est les *métriques de pod*.
269+
Le premier de ces types de métriques alternatives est les *métriques de pod*.
275270
Ces métriques décrivent les pods et sont regroupées en moyenne sur l'ensemble des pods,
276271
puis comparées à une valeur cible pour déterminer le nombre de réplicas.
277272
Elles fonctionnent de manière similaire aux métriques de ressource,
278-
à la différence qu'elles ne prennent en charge *seulement* le type de `target` `AverageValue`.
273+
à la différence qu'elles prennent en charge *seulement* le type de `target` `AverageValue`.
279274

280-
Les métriques de pod sont spécifiées à l'aide d'un bloc métrique comme suit :
275+
Les métriques de pod sont spécifiées à l'aide d'une définition `metric` comme ceci:
281276

282277
```yaml
283278
type: Pods
@@ -290,16 +285,13 @@ pods:
290285
```
291286

292287
Le deuxième type de métrique alternative est *les métriques d'objet*.
293-
Ces métriques décrivent un objet différent dans le même espace de noms,
288+
Ces métriques décrivent un objet différent dans le même namespace,
294289
au lieu de décrire des Pods.
295-
Les métriques ne sont pas nécessairement récupérées à partir de l'objet ;
296-
elles le décrivent simplement.
297-
Les métriques d'objet prennent en charge
298-
les types de `cible` `Value` et `AverageValue`.
290+
Les métriques ne sont pas nécessairement récupérées à partir de l'objet mais le décrivent.
291+
Les métriques d'objet prennent en charge les types de `target` suivants: `Value` et `AverageValue`.
299292
Avec `Value`, la cible est comparée directement à la métrique renvoyée par l'API.
300293
Avec `AverageValue`, la valeur renvoyée par l'API de métriques
301-
personnalisées est divisée par le nombre de Pods avant
302-
d'être comparée à la cible.
294+
personnalisées est divisée par le nombre de Pods avant d'être comparée à la cible.
303295
L'exemple suivant est la représentation YAML de la métrique `requests-per-second`.
304296

305297
```yaml
@@ -316,10 +308,10 @@ object:
316308
value: 2k
317309
```
318310

319-
Si vous fournissez plusieurs blocs de métriques similaires,
311+
Si vous fournissez plusieurs définitions de métriques similaires,
320312
le HorizontalPodAutoscaler examinera chaque métrique à tour de rôle.
321-
Le HorizontalPodAutoscaler calculera les nombres de répliques proposés pour chaque métrique,
322-
puis choisira celle avec le nombre de répliques le plus élevé.
313+
Il calculera les nombres de réplicas proposés pour chaque métrique,
314+
puis choisira celle avec le nombre de réplicas le plus élevé.
323315
Par exemple, si votre système de surveillance collecte des métriques sur le trafic réseau,
324316
vous pouvez mettre à jour la définition ci-dessus en utilisant `kubectl edit` pour qu'elle ressemble à ceci :
325317

@@ -384,20 +376,20 @@ status:
384376
value: 10k
385377
```
386378

387-
Ensuite, votre HorizontalPodAutoscaler tenterait de s'assurer
379+
Ensuite, votre HorizontalPodAutoscaler tentera de s'assurer
388380
que chaque pod consomme environ 50% de sa CPU demandée,
389381
en traitant 1000 paquets par seconde,
390382
et que tous les pods derrière l'Ingress `main-route`
391383
servent un total de 10000 requêtes par seconde.
392384

393-
### Autoscaling sur des métriques plus spécifiques
385+
### Auto-ajustement sur des métriques plus spécifiques
394386

395-
De nombreux pipelines de métriques vous permettent de décrire les métriques soit par leur nom,
387+
De nombreuses chaines de métriques vous permettent de décrire les métriques soit par leur nom,
396388
soit par un ensemble de descripteurs supplémentaires appelés _labels_.
397389
Pour tous les types de métriques autres que les ressources (pod, objet et externe, décrits ci-dessous),
398-
vous pouvez spécifier un sélecteur de label supplémentaire qui est transmis à votre pipeline de métriques.
390+
vous pouvez spécifier un sélecteur de label supplémentaire qui est transmis à votre chaine de métriques.
399391
Par exemple, si vous collectez une métrique `http_requests` avec le label `verb`,
400-
vous pouvez spécifier le bloc de métrique suivant pour ne faire varier l'échelle que sur les requêtes de type GET:
392+
vous pouvez spécifier la définition de métrique suivante pour ne faire varier l'échelle que sur les requêtes de type GET:
401393

402394
```yaml
403395
type: Object
@@ -408,28 +400,27 @@ object:
408400
```
409401

410402
Ce sélecteur utilise la même syntaxe que les sélecteurs d'étiquettes complets de Kubernetes.
411-
La chaine de surveillance détermine comment regrouper plusieurs séries en une seule valeur,
412-
si le nom et le sélecteur correspondent à plusieurs séries.
403+
La chaine de surveillance détermine comment regrouper plusieurs séries en une seule valeur, si le nom et le sélecteur correspondent à plusieurs séries.
413404
Le sélecteur est additif et ne peut pas sélectionner des métriques qui décrivent des objets qui ne sont **pas** l'objet cible
414405
(les pods cibles dans le cas du type `Pods`, et l'objet décrit dans le cas du type `Object`).
415406

416-
### Autoscaling sur des métriques non liées aux objets Kubernetes
407+
### Auto-ajustement sur des métriques non liées aux objets Kubernetes
417408

418409
Les applications s'exécutant sur Kubernetes peuvent avoir besoin de
419410
s'auto-adapter en fonction de métriques qui n'ont pas de relation évidente
420411
avec un objet dans le cluster Kubernetes,
421-
telles que des métriques décrivant un service hébergé sans corrélation directe avec les espaces de noms Kubernetes.
412+
telles que des métriques décrivant un service hébergé sans corrélation directe avec les namespace Kubernetes.
422413
À partir de Kubernetes 1.10, vous pouvez répondre à ce cas d'utilisation avec des *métriques externes*.
423414

424415
L'utilisation de métriques externes nécessite une connaissance de votre système de surveillance ;
425416
la configuration est similaire à celle requise lors de l'utilisation de métriques personnalisées.
426417
Les métriques externes vous permettent de mettre à l'échelle automatiquement
427418
votre cluster en fonction de n'importe quelle métrique disponible dans votre
428419
système de surveillance.
429-
Fournissez un bloc `metric` avec un `name` et un `selector`, comme ci-dessus,
420+
Créez un bloc `metric` avec un `name` et un `selector`, comme ci-dessus,
430421
et utilisez le type de métrique `External` au lieu de `Object`.
431422
Si plusieurs séries temporelles correspondent au `metricSelector`,
432-
la somme de leurs valeurs est utilisée par le HorizontalPodAutoscaler.
423+
la somme de leurs valeurs sera utilisée par le HorizontalPodAutoscaler.
433424
Les métriques externes prennent en charge les types de cible `Value` et `AverageValue`, qui fonctionnent exactement de la même manière que lorsque vous utilisez le type `Object`.
434425

435426
Par exemple, si votre application traite des tâches à partir d'un service de file de messages hébergé,
@@ -455,16 +446,15 @@ car cela facilite la sécurisation de l'API des métriques personnalisées pour
455446
L'API des métriques externes permet potentiellement l'accès à n'importe quelle métrique,
456447
il est donc nécessaire que les administrateurs de cluster fassent attention lors de son exposition.
457448

458-
## Annexe : Conditions d'état du Pod Autoscaler horizontal
449+
## Annexe : Conditions d'état du Horizontal Pod Autoscaler
459450

460-
Lorsque vous utilisez la forme `autoscaling/v2` du Pod Autoscaler horizontal,
461-
vous pourrez voir les *conditions d'état* définies par Kubernetes sur le Pod
462-
Autoscaler horizontal. Ces conditions d'état indiquent si le Pod Autoscaler
463-
horizontal est capable de se mettre à l'échelle et s'il est actuellement
451+
Lorsque vous utilisez la forme `autoscaling/v2` du HorizontalPodAutoscaler,
452+
vous pourrez voir les *conditions d'état* définies par Kubernetes sur celui-ci.
453+
Ces conditions d'état indiquent s'il est capable de se mettre à l'échelle et s'il est actuellement
464454
restreint de quelque manière que ce soit. Les conditions apparaissent dans le
465455
champ `status.conditions`.
466456

467-
Pour voir les conditions affectant un Pod Autoscaler horizontal, nous pouvons utiliser la commande `kubectl describe hpa`.
457+
Pour voir les conditions affectant un HorizontalPodAutoscaler, nous pouvons utiliser la commande `kubectl describe hpa`.
468458

469459
```shell
470460
kubectl describe hpa cm-test
@@ -493,23 +483,23 @@ Events:
493483
494484
Pour ce HorizontalPodAutoscaler, vous pouvez voir plusieurs conditions dans un état sain.
495485
La première, `AbleToScale`, indique si le HPA est capable de récupérer et de mettre à jour les échelles,
496-
ainsi que si des conditions liées à la limitation sont susceptibles d'empêcher le redimensionnement.
497-
La deuxième, `ScalingActive`, indique si le HPA est activé (c'est-à-dire que le nombre de répliques de la cible n'est pas nul) et est capable de calculer les échelles souhaitées.
486+
ainsi que si des conditions liées aux limitations sont susceptibles d'empêcher le redimensionnement.
487+
La deuxième, `ScalingActive`, indique si le HPA est activé (c'est-à-dire que le nombre de réplicas de la cible n'est pas nul) et est capable de calculer les échelles souhaitées.
498488
Lorsqu'il est `False`, cela indique généralement des problèmes de récupération des métriques.
499489
Enfin, la dernière condition, `ScalingLimited`, indique que l'échelle souhaitée a été limitée par le maximum ou le minimum du HorizontalPodAutoscaler.
500-
Cela indique que vous souhaiterez peut-être augmenter ou diminuer les contraintes de nombre de répliques minimum ou maximum de votre HorizontalPodAutoscaler.
490+
Cela indique que vous souhaiteriez peut-être augmenter ou diminuer les contraintes de nombre de réplicas minimum ou maximum de votre HorizontalPodAutoscaler.
501491
502492
## Quantités
503493
504494
Toutes les métriques dans le HorizontalPodAutoscaler et les API de métriques
505495
sont spécifiées à l'aide d'une notation spéciale en nombres entiers connue dans Kubernetes sous le nom de {{< glossary_tooltip term_id=quantity text=quantité >}}.
506496
Par exemple, la quantité `10500m` serait écrite comme `10.5` en notation décimale.
507-
Les API de métriques renverront des nombres entiers sans suffixe lorsque cela est possible, et renverront généralement des quantités en milli-unités sinon.
497+
Les API de métriques renvoient des nombres entiers sans suffixe lorsque cela est possible, et renvoient généralement des quantités en milli-unités sinon.
508498
Cela signifie que vous pouvez voir la valeur de votre métrique fluctuer entre `1` et `1500m`, ou `1` et `1.5` lorsqu'elle est écrite en notation décimale.
509499
510500
## Autres scénarios possibles
511501
512-
### Création du autoscaler de manière déclarative
502+
### Création de l'autoscaler de manière déclarative
513503
514504
Au lieu d'utiliser la commande `kubectl autoscale` pour créer un HorizontalPodAutoscaler de manière impérative,
515505
nous pouvons utiliser le manifeste suivant pour le créer de manière déclarative :

0 commit comments

Comments
 (0)