From b44217c0d0a81fe36f14a77c1bd96d3ee937cf86 Mon Sep 17 00:00:00 2001 From: Philippe MARTIN Date: Wed, 13 Mar 2019 09:55:34 +0100 Subject: [PATCH] docs-fr | Reference | kubectl misc (#13142) --- content/fr/docs/reference/kubectl/_index.md | 5 ++ .../fr/docs/reference/kubectl/conventions.md | 75 +++++++++++++++++++ .../fr/docs/reference/kubectl/kubectl-cmds.md | 5 ++ 3 files changed, 85 insertions(+) create mode 100755 content/fr/docs/reference/kubectl/_index.md create mode 100644 content/fr/docs/reference/kubectl/conventions.md create mode 100644 content/fr/docs/reference/kubectl/kubectl-cmds.md diff --git a/content/fr/docs/reference/kubectl/_index.md b/content/fr/docs/reference/kubectl/_index.md new file mode 100755 index 0000000000..0c3d7882f6 --- /dev/null +++ b/content/fr/docs/reference/kubectl/_index.md @@ -0,0 +1,5 @@ +--- +title: "CLI kubectl" +weight: 60 +--- + diff --git a/content/fr/docs/reference/kubectl/conventions.md b/content/fr/docs/reference/kubectl/conventions.md new file mode 100644 index 0000000000..0637fad844 --- /dev/null +++ b/content/fr/docs/reference/kubectl/conventions.md @@ -0,0 +1,75 @@ +--- +title: Conventions d'utilisation de kubectl +content_template: templates/concept +--- + +{{% capture overview %}} +Conventions d'utilisation recommandées pour `kubectl`. +{{% /capture %}} + +{{% capture body %}} + +## Utiliser `kubectl` dans des scripts réutilisables + +Pour une sortie stable dans un script : + +* Demandez un des formats de sortie orienté machine, comme `-o name`, `-o json`, `-o yaml`, `-o go-template` ou `-o jsonpath`. +* 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. +* 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`. +* Ne vous basez pas sur un contexte, des préférences ou tout autre état implicite. + +## Bonnes pratiques + +### `kubectl run` + +Pour que `kubectl run` satisfasse l'infrastructure as code : + +* 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)). +* 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. +* Capturez le script pour une image fortement paramétrée. +* 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`. +* Collez à une version spécifique de [générateur](#generators), comme `kubectl run --generator=deployment/v1beta1`. + +#### Générateurs + +Vous pouvez créer les ressources suivantes en utilisant `kubectl run` avec le flag `--generator` : + +| Resource | commande kubectl | +|---------------------------------|---------------------------------------------------| +| Pod | `kubectl run --generator=run-pod/v1` | +| Replication controller | `kubectl run --generator=run/v1` | +| Deployment | `kubectl run --generator=extensions/v1beta1` | +| -pour un endpoint (défaut) | `kubectl run --generator=deployment/v1beta1` | +| Deployment | `kubectl run --generator=apps/v1beta1` | +| -pour un endpoint (recommandé) | `kubectl run --generator=deployment/apps.v1beta1` | +| Job | `kubectl run --generator=job/v1` | +| CronJob | `kubectl run --generator=batch/v1beta1` | +| -pour un endpoint (défaut) | `kubectl run --generator=cronjob/v1beta1` | +| CronJob | `kubectl run --generator=batch/v2alpha1` | +| -pour un endpoint (déprécié) | `kubectl run --generator=cronjob/v2alpha1` | + +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 : + +| Ressource générée | Cluster v1.4 et suivants | Cluster v1.3 | Cluster v1.2 | Cluster v1.1 et précédents | +|:----------------------:|--------------------------|-----------------------|--------------------------------------------|--------------------------------------------| +| Pod | `--restart=Never` | `--restart=Never` | `--generator=run-pod/v1` | `--restart=OnFailure` OU `--restart=Never` | +| Replication Controller | `--generator=run/v1` | `--generator=run/v1` | `--generator=run/v1` | `--restart=Always` | +| Deployment | `--restart=Always` | `--restart=Always` | `--restart=Always` | N/A | +| Job | `--restart=OnFailure` | `--restart=OnFailure` | `--restart=OnFailure` OU `--restart=Never` | N/A | +| Cron Job | `--schedule=` | N/A | N/A | N/A | + +{{< note >}} +Ces flags utilisent un générateur par défaut uniquement lorsque vous n'avez utilisé aucun flag. +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éé. +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. +{{< /note >}} + +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`. + +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. + +### `kubectl apply` + +* Vous pouvez utiliser `kubectl apply` pour créer ou mettre à jour des ressources. Cependant, pour mettre à jour une ressource, vous devez avoir créé la ressource en utilisant `kubectl apply` ou `kubectl create --save-config`. Pour plus d'informations sur l'utilisation de `kubectl apply` pour la mise à jour de ressources, voir [Gérer les ressources](/docs/concepts/cluster-administration/manage-deployment/#kubectl-apply). + +{{% /capture %}} \ No newline at end of file diff --git a/content/fr/docs/reference/kubectl/kubectl-cmds.md b/content/fr/docs/reference/kubectl/kubectl-cmds.md new file mode 100644 index 0000000000..e9f5071ea0 --- /dev/null +++ b/content/fr/docs/reference/kubectl/kubectl-cmds.md @@ -0,0 +1,5 @@ +--- +title: Commandes kubectl +--- + +[Référence des commandes kubectl](/docs/reference/generated/kubectl/kubectl-commands/)