Skip to content

Commit 04476c8

Browse files
authored
Merge pull request #21106 from feloy/feloy-v1-19
Update kubectl translation for v1.19
2 parents 558ed98 + 588bfba commit 04476c8

File tree

5 files changed

+109
-77
lines changed

5 files changed

+109
-77
lines changed

content/fr/docs/reference/kubectl/cheatsheet.md

Lines changed: 29 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ complete -F __start_kubectl k
4343

4444
```bash
4545
source <(kubectl completion zsh) # active l'auto-complétion pour zsh dans le shell courant
46-
echo "if [ $commands[kubectl] ]; then source <(kubectl completion zsh); fi" >> ~/.zshrc # ajoute l'auto-complétion de manière permanente à votre shell zsh
46+
echo "[[ $commands[kubectl] ]] && source <(kubectl completion zsh)" >> ~/.zshrc # ajoute l'auto-complétion de manière permanente à votre shell zsh
4747
```
4848

4949
## Contexte et configuration de Kubectl
@@ -87,7 +87,7 @@ kubectl config unset users.foo # Supprime l'utilisateur fo
8787

8888
## Création d'objets
8989

90-
Les manifests Kubernetes peuvent être définis en json ou yaml. Les extensions de fichier `.yaml`,
90+
Les manifests Kubernetes peuvent être définis en YAML ou JSON. Les extensions de fichier `.yaml`,
9191
`.yml`, et `.json` peuvent être utilisés.
9292

9393
```bash
@@ -145,7 +145,7 @@ EOF
145145
# Commandes Get avec un affichage basique
146146
kubectl get services # Liste tous les services d'un namespace
147147
kubectl get pods --all-namespaces # Liste tous les Pods de tous les namespaces
148-
kubectl get pods -o wide # Liste tous les Pods du namespace, avec plus de détails
148+
kubectl get pods -o wide # Liste tous les Pods du namespace courant, avec plus de détails
149149
kubectl get deployment my-dep # Liste un déploiement particulier
150150
kubectl get pods # Liste tous les Pods dans un namespace
151151
kubectl get pod my-pod -o yaml # Affiche le YAML du Pod
@@ -154,20 +154,20 @@ kubectl get pod my-pod -o yaml # Affiche le YAML du Pod
154154
kubectl describe nodes my-node
155155
kubectl describe pods my-pod
156156

157-
# Liste des services triés par nom
158-
kubectl get services --sort-by=.metadata.name # Liste les services classés par nom
157+
# Liste les services triés par nom
158+
kubectl get services --sort-by=.metadata.name
159159

160160
# Liste les pods classés par nombre de redémarrages
161161
kubectl get pods --sort-by='.status.containerStatuses[0].restartCount'
162162

163-
# Affiche les pods du namespace test classés par capacité de stockage
164-
kubectl get pods -n test --sort-by=.spec.capacity.storage
163+
# Affiche les volumes persistants classés par capacité de stockage
164+
kubectl get pv --sort-by=.spec.capacity.storage
165165

166166
# Affiche la version des labels de tous les pods ayant un label app=cassandra
167167
kubectl get pods --selector=app=cassandra -o \
168168
jsonpath='{.items[*].metadata.labels.version}'
169169

170-
# Affiche tous les noeuds (en utilisant un sélecteur pour exclure ceux ayant un label
170+
# Affiche tous les noeuds (en utilisant un sélecteur pour exclure ceux ayant un label
171171
# nommé 'node-role.kubernetes.io/master')
172172
kubectl get node --selector='!node-role.kubernetes.io/master'
173173

@@ -252,7 +252,7 @@ kubectl patch sa default --type='json' -p='[{"op": "add", "path": "/secrets/1",
252252
```
253253

254254
## Édition de ressources
255-
Ceci édite n'importe quelle ressource de l'API dans un éditeur.
255+
Édite n'importe quelle ressource de l'API dans un éditeur.
256256

257257
```bash
258258
kubectl edit svc/docker-registry # Édite le service nommé docker-registry
@@ -274,7 +274,7 @@ kubectl scale --replicas=5 rc/foo rc/bar rc/baz # Scale plusie
274274
kubectl delete -f ./pod.json # Supprime un pod en utilisant le type et le nom spécifiés dans pod.json
275275
kubectl delete pod,service baz foo # Supprime les pods et services ayant les mêmes noms "baz" et "foo"
276276
kubectl delete pods,services -l name=myLabel # Supprime les pods et services ayant le label name=myLabel
277-
kubectl -n my-ns delete po,svc --all # Supprime tous les pods et services dans le namespace my-ns
277+
kubectl -n my-ns delete pod,svc --all # Supprime tous les pods et services dans le namespace my-ns
278278
# Supprime tous les pods correspondants à pattern1 ou pattern2 avec awk
279279
kubectl get pods -n mynamespace --no-headers=true | awk '/pattern1|pattern2/{print $1}' | xargs kubectl delete -n mynamespace pod
280280
```
@@ -292,9 +292,9 @@ kubectl logs -f my-pod # Fait défiler (stream) les
292292
kubectl logs -f my-pod -c my-container # Fait défiler (stream) les logs d'un conteneur particulier du pod (stdout, cas d'un pod multi-conteneurs)
293293
kubectl logs -f -l name=myLabel --all-containers # Fait défiler (stream) les logs de tous les pods ayant le label name=myLabel (stdout)
294294
kubectl run -i --tty busybox --image=busybox -- sh # Exécute un pod comme un shell interactif
295-
kubectl run nginx --image=nginx --restart=Never -n
296-
mynamespace # Run pod nginx in a specific namespace
297-
kubectl run nginx --image=nginx --restart=Never # Run pod nginx and write its spec into a file called pod.yaml
295+
kubectl run nginx --image=nginx --restart=Never -n
296+
mynamespace # Exécute le pod nginx dans un namespace spécifique
297+
kubectl run nginx --image=nginx --restart=Never # Simule l'exécution du pod nginx et écrit sa spécification dans un fichier pod.yaml
298298
--dry-run -o yaml > pod.yaml
299299

300300
kubectl attach my-pod -i # Attache à un conteneur en cours d'exécution
@@ -340,7 +340,7 @@ kubectl api-resources --api-group=extensions # Toutes les ressources dans le gro
340340

341341
### Formattage de l'affichage
342342

343-
Pour afficher les détails sur votre terminal dans un format spécifique, vous pouvez utiliser une des options `-o` ou `--output` avec les commandes `kubectl` qui les prennent en charge.
343+
Pour afficher les détails sur votre terminal dans un format spécifique, utilisez l'option `-o` (ou `--output`) avec les commandes `kubectl` qui la prend en charge.
344344

345345
Format d'affichage | Description
346346
--------------| -----------
@@ -353,6 +353,21 @@ Format d'affichage | Description
353353
`-o=wide` | Affiche dans le format texte avec toute information supplémentaire, et pour des pods, le nom du noeud est inclus
354354
`-o=yaml` | Affiche un objet de l'API formaté en YAML
355355

356+
Exemples utilisant `-o=custom-columns` :
357+
358+
```bash
359+
# Toutes les images s'exécutant dans un cluster
360+
kubectl get pods -A -o=custom-columns='DATA:spec.containers[*].image'
361+
362+
# Toutes les images excepté "k8s.gcr.io/coredns:1.6.2"
363+
kubectl get pods -A -o=custom-columns='DATA:spec.containers[?(@.image!="k8s.gcr.io/coredns:1.6.2")].image'
364+
365+
# Tous les champs dans metadata quel que soit leur nom
366+
kubectl get pods -A -o=custom-columns='DATA:metadata.*'
367+
```
368+
369+
Plus d'exemples dans la [documentation de référence](/fr/docs/reference/kubectl/overview/#colonnes-personnalisées) de kubectl.
370+
356371
### Verbosité de l'affichage de Kubectl et débogage
357372

358373
La verbosité de Kubectl est contrôlée par une des options `-v` ou `--v` suivie d'un entier représentant le niveau de log. Les conventions générales de logging de Kubernetes et les niveaux de log associés sont décrits [ici](https://github.com/kubernetes/community/blob/master/contributors/devel/sig-instrumentation/logging.md).

content/fr/docs/reference/kubectl/conventions.md

Lines changed: 21 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,6 @@ Pour une sortie stable dans un script :
1616

1717
* Demandez un des formats de sortie orienté machine, comme `-o name`, `-o json`, `-o yaml`, `-o go-template` ou `-o jsonpath`.
1818
* Spécifiez complètement la version. Par exemple, `jobs.v1.batch/monjob`. Cela va assurer que kubectl n'utilise pas sa version par défaut, qui risque d'évoluer avec le temps.
19-
* Utilisez le flag `--generator` pour coller à un comportement spécifique lorsque vous utilisez les commandes basées sur un générateur, comme `kubectl run` ou `kubectl expose`.
2019
* Ne vous basez pas sur un contexte, des préférences ou tout autre état implicite.
2120

2221
## Bonnes pratiques
@@ -26,48 +25,34 @@ Pour une sortie stable dans un script :
2625
Pour que `kubectl run` satisfasse l'infrastructure as code :
2726

2827
* Taggez les images avec un tag spécifique à une version et n'utilisez pas ce tag pour une nouvelle version. Par exemple, utilisez `:v1234`, `v1.2.3`, `r03062016-1-4`, plutôt que `:latest` (Pour plus d'informations, voir [Bonnes pratiques pour la configuration](/docs/concepts/configuration/overview/#container-images)).
29-
* Capturez les paramètres dans un script enregistré, ou tout au moins utilisez `--record` pour annoter les objets créés avec la ligne de commande correspondante pour une image peu paramétrée.
3028
* Capturez le script pour une image fortement paramétrée.
3129
* Passez à des fichiers de configuration enregistrés dans un système de contrôle de source pour des fonctionnalités désirées mais non exprimables avec des flags de `kubectl run`.
32-
* Collez à une version spécifique de [générateur](#generators), comme `kubectl run --generator=deployment/v1beta1`.
3330

34-
#### Générateurs
35-
36-
Vous pouvez créer les ressources suivantes en utilisant `kubectl run` avec le flag `--generator` :
37-
38-
| Ressource | groupe api | commande kubectl |
39-
|-----------------------------------|--------------------|---------------------------------------------------|
40-
| Pod | v1 | `kubectl run --generator=run-pod/v1` |
41-
| Replication controller (déprécié) | v1 | `kubectl run --generator=run/v1` |
42-
| Deployment (déprécié) | extensions/v1beta1 | `kubectl run --generator=deployment/v1beta1` |
43-
| Deployment (déprécié) | apps/v1beta1 | `kubectl run --generator=deployment/apps.v1beta1` |
44-
| Job (déprécié) | batch/v1 | `kubectl run --generator=job/v1` |
45-
| CronJob (déprécié) | batch/v1beta1 | `kubectl run --generator=cronjob/v1beta1` |
46-
| CronJob (déprécié) | batch/v2alpha1 | `kubectl run --generator=cronjob/v2alpha1` |
47-
48-
{{< note >}}
49-
`kubectl run --generator` sauf pour `run-pod/v1` est déprécié depuis v1.12.
50-
{{< /note >}}
51-
52-
Si vous n'indiquez pas de flag de générateur, d'autres flags vous demandent d'utiliser un générateur spécifique. La table suivante liste les flags qui vous forcent à préciser un générateur spécifique, selon la version du cluster :
53-
54-
| Ressource générée | Cluster v1.4 et suivants | Cluster v1.3 | Cluster v1.2 | Cluster v1.1 et précédents |
55-
|:----------------------:|--------------------------|-----------------------|--------------------------------------------|--------------------------------------------|
56-
| Pod | `--restart=Never` | `--restart=Never` | `--generator=run-pod/v1` | `--restart=OnFailure` OU `--restart=Never` |
57-
| Replication Controller | `--generator=run/v1` | `--generator=run/v1` | `--generator=run/v1` | `--restart=Always` |
58-
| Deployment | `--restart=Always` | `--restart=Always` | `--restart=Always` | N/A |
59-
| Job | `--restart=OnFailure` | `--restart=OnFailure` | `--restart=OnFailure` OU `--restart=Never` | N/A |
60-
| Cron Job | `--schedule=<cron>` | N/A | N/A | N/A |
31+
Vous pouvez utiliser l'option `--dry-run` pour prévisualiser l'objet qui serait envoyé à votre cluster, sans réellement l'envoyer.
6132

6233
{{< note >}}
63-
Ces flags utilisent un générateur par défaut uniquement lorsque vous n'avez utilisé aucun flag.
64-
Cela veut dire que lorsque vous combinez `--generator` avec d'autres flags, le générateur que vous avez spécifié plus tard ne change pas. Par exemple, dans cluster v1.4, si vous spécifiez d'abord `--restart=Always`, un Deployment est créé ; si vous spécifiez ensuite `--restart=Always` et `--generator=run/v1`, alors un Replication Controller sera créé.
65-
Ceci vous permet de coller à un comportement spécifique avec le générateur, même si le générateur par défaut est changé par la suite.
34+
Tous les générateurs `kubectl` sont dépréciés. Voir la documentation de Kubernetes v1.17 pour une [liste](https://v1-17.docs.kubernetes.io/fr/docs/reference/kubectl/conventions/#g%C3%A9n%C3%A9rateurs) de générateurs et comment ils étaient utilisés.
6635
{{< /note >}}
6736

68-
Les flags définissent le générateur dans l'ordre suivant : d'abord le flag `--schedule`, puis le flag `--restart`, et finalement le flag `--generator`.
69-
70-
Pour vérifier la ressource qui a été finalement créée, utilisez le flag `--dry-run`, qui fournit l'objet qui sera soumis au cluster.
37+
#### Générateurs
38+
Vous pouvez générer les ressources suivantes avec une commande kubectl, `kubectl create --dry-run -o yaml`:
39+
```
40+
clusterrole Crée un ClusterRole.
41+
clusterrolebinding Crée un ClusterRoleBinding pour un ClusterRole particulier.
42+
configmap Crée une configmap à partir d'un fichier local, un répertoire ou une valeur litérale.
43+
cronjob Crée un cronjob avec le nom spécifié.
44+
deployment Crée un deployment avec le nom spécifié.
45+
job Crée un job avec le nom spécifié.
46+
namespace Crée un namespace avec le nom spécifié.
47+
poddisruptionbudget Crée un pod disruption budget avec le nom spécifié.
48+
priorityclass Crée une priorityclass avec le nom spécifié.
49+
quota Crée un quota avec le nom spécifié.
50+
role Crée un role avec une unique règle.
51+
rolebinding Crée un RoleBinding pour un Role ou ClusterRole particulier.
52+
secret Crée un secret en utilisant la sous-commande spécifiée.
53+
service Crée un service en utilisant la sous-commande spécifiée.
54+
serviceaccount Crée un service account avec le nom spécifié.
55+
```
7156

7257
### `kubectl apply`
7358

content/fr/docs/reference/kubectl/jsonpath.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -71,10 +71,10 @@ Fonction | Description | Exemple
7171
--------------------|----------------------------|-----------------------------------------------------------------|------------------
7272
`text` | le texte en clair | `le type est {.kind}` | `le type est List`
7373
`@` | l'objet courant | `{@}` | identique à l'entrée
74-
`.` ou `[]` | opérateur fils | `{.kind}` ou `{['kind']}` | `List`
74+
`.` ou `[]` | opérateur fils | `{.kind}`, `{['kind']}` ou `{['name\.type']}` | `List`
7575
`..` | descente récursive | `{..name}` | `127.0.0.1 127.0.0.2 myself e2e`
7676
`*` | joker. Tous les objets | `{.items[*].metadata.name}` | `[127.0.0.1 127.0.0.2]`
77-
`[start:end :step]` | opérateur d'indice | `{.users[0].name}` | `myself`
77+
`[start:end:step]` | opérateur d'indice | `{.users[0].name}` | `myself`
7878
`[,]` | opérateur d'union | `{.items[*]['metadata.name', 'status.capacity']}` | `127.0.0.1 127.0.0.2 map[cpu:4] map[cpu:8]`
7979
`?()` | filtre | `{.users[?(@.name=="e2e")].user.password}` | `secret`
8080
`range`, `end` | itération de liste | `{range .items[*]}[{.metadata.name}, {.status.capacity}] {end}` | `[127.0.0.1, map[cpu:4]] [127.0.0.2, map[cpu:8]]`
@@ -87,14 +87,18 @@ kubectl get pods -o json
8787
kubectl get pods -o=jsonpath='{@}'
8888
kubectl get pods -o=jsonpath='{.items[0]}'
8989
kubectl get pods -o=jsonpath='{.items[0].metadata.name}'
90+
kubectl get pods -o=jsonpath="{.items[*]['metadata.name', 'status.capacity']}"
9091
kubectl get pods -o=jsonpath='{range .items[*]}{.metadata.name}{"\t"}{.status.startTime}{"\n"}{end}'
9192
```
9293

94+
{{< note >}}
9395
Sous Windows, vous devez utiliser des guillemets _doubles_ autour des modèles JSONPath qui contiennent des espaces (et non des guillemets simples comme ci-dessus pour bash). Ceci entraîne que vous devez utiliser un guillemet simple ou un double guillemet échappé autour des chaînes litérales dans le modèle. Par exemple :
9496

9597
```cmd
96-
C:\> kubectl get pods -o=jsonpath="{range .items[*]}{.metadata.name}{'\t'}{.status.startTime}{'\n'}{end}"
97-
C:\> kubectl get pods -o=jsonpath="{range .items[*]}{.metadata.name}{\"\t\"}{.status.startTime}{\"\n\"}{end}"
98+
kubectl get pods -o=jsonpath="{range .items[*]}{.metadata.name}{'\t'}{.status.startTime}{'\n'}{end}"
99+
kubectl get pods -o=jsonpath="{range .items[*]}{.metadata.name}{\"\t\"}{.status.startTime}{\"\n\"}{end}"
98100
```
99101

102+
{{< /note >}}
103+
100104
{{% /capture %}}

content/fr/docs/reference/kubectl/kubectl.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -510,6 +510,7 @@ kubectl [flags]
510510

511511
{{% capture seealso %}}
512512

513+
* [kubectl alpha](/docs/reference/generated/kubectl/kubectl-commands#alpha) - Commandes pour fonctionnalités alpha
513514
* [kubectl annotate](/docs/reference/generated/kubectl/kubectl-commands#annotate) - Met à jour les annotations d'une ressource
514515
* [kubectl api-resources](/docs/reference/generated/kubectl/kubectl-commands#api-resources) - Affiche les ressources de l'API prises en charge sur le serveur
515516
* [kubectl api-versions](/docs/reference/generated/kubectl/kubectl-commands#api-versions) - Affiche les versions de l'API prises en charge sur le serveur, sous la forme "groupe/version"
@@ -545,7 +546,7 @@ kubectl [flags]
545546
* [kubectl replace](/docs/reference/generated/kubectl/kubectl-commands#replace) - Remplace une ressource par fichier ou stdin
546547
* [kubectl rollout](/docs/reference/generated/kubectl/kubectl-commands#rollout) - Gère le rollout d'une ressource
547548
* [kubectl run](/docs/reference/generated/kubectl/kubectl-commands#run) - Exécute une image donnée dans le cluster
548-
* [kubectl scale](/docs/reference/generated/kubectl/kubectl-commands#scale) - Définit une nouvelle taille pour un Deployment, ReplicaSet, Replication Controller, ou Job
549+
* [kubectl scale](/docs/reference/generated/kubectl/kubectl-commands#scale) - Définit une nouvelle taille pour un Deployment, ReplicaSet ou Replication Controller
549550
* [kubectl set](/docs/reference/generated/kubectl/kubectl-commands#set) - Définit des fonctionnalités spécifiques sur des objets
550551
* [kubectl taint](/docs/reference/generated/kubectl/kubectl-commands#taint) - Met à jour les marques (taints) sur un ou plusieurs nœuds
551552
* [kubectl top](/docs/reference/generated/kubectl/kubectl-commands#top) - Affiche l'utilisation de ressources matérielles (CPU/Memory/Storage)

0 commit comments

Comments
 (0)