From 1e3596f7bcdd88924173d4cd485f393b78ed12ec Mon Sep 17 00:00:00 2001 From: Philippe MARTIN Date: Fri, 27 Sep 2019 12:11:36 +0200 Subject: [PATCH] Update translation (#16585) --- content/fr/docs/reference/kubectl/overview.md | 132 ++++++++++-------- 1 file changed, 72 insertions(+), 60 deletions(-) diff --git a/content/fr/docs/reference/kubectl/overview.md b/content/fr/docs/reference/kubectl/overview.md index 92b4a278da..7521de2f1f 100644 --- a/content/fr/docs/reference/kubectl/overview.md +++ b/content/fr/docs/reference/kubectl/overview.md @@ -9,7 +9,9 @@ card: --- {{% capture overview %}} -Kubectl est une interface en ligne de commande qui permet d'exécuter des commandes sur des clusters Kubernetes. +Kubectl est une interface en ligne de commande qui permet d'exécuter des commandes sur des clusters Kubernetes. `kubectl` recherche un fichier appelé config dans le répertoire $HOME/.kube. Vous pouvez spécifier d'autres fichiers [kubeconfig](https://kube +rnetes.io/docs/concepts/configuration/organize-cluster-access-kubeconfig/) en définissant la variable d'environnement KUBECONFIG ou en utilisant le paramètre [`--kubeconfig`](https://kubernetes.io/docs/concepts/configuration/organize-cluster-access-kubeconfig/). + Cet aperçu couvre la syntaxe `kubectl`, décrit les opérations et fournit des exemples classiques. Pour des détails sur chaque commande, incluant toutes les options et sous-commandes autorisées, voir la documentation de référence de [kubectl](/docs/reference/generated/kubectl/kubectl-commands/). Pour des instructions d'installation, voir [installer kubectl](/docs/tasks/kubectl/install/). {{% /capture %}} @@ -80,7 +82,7 @@ Opération | Syntaxe | Description `diff` | `kubectl diff -f FICHIER [flags]` | Diff un fichier ou stdin par rapport à la configuration en cours (**BETA**) `edit` | `kubectl edit (-f FICHIER \| TYPE NOM \| TYPE/NOM) [flags]` | Édite et met à jour la définition d'une ou plusieurs ressources sur le serveur en utilisant l'éditeur par défaut. `exec` | `kubectl exec POD [-c CONTENEUR] [-i] [-t] [flags] [-- COMMANDE [args...]]` | Exécute une commande à l'intérieur d'un conteneur dans un pod. -`explain` | `kubectl explain [--include-extended-apis=true] [--recursive=false] [flags]` | Obtient des informations sur différentes ressources. Par exemple pods, nœuds, services, etc. +`explain` | `kubectl explain [--recursive=false] [flags]` | Obtient des informations sur différentes ressources. Par exemple pods, nœuds, services, etc. `expose` | `kubectl expose (-f FICHIER \| TYPE NOM \| TYPE/NOM) [--port=port] [--protocol=TCP\|UDP] [--target-port=nombre-ou-nom] [--name=nom] [--external-ip=ip-externe-ou-service] [--type=type] [flags]` | Expose un replication controller, service ou pod comme un nouveau service Kubernetes. `get` | `kubectl get (-f FICHIER \| TYPE [NOM \| /NOM \| -l label]) [--watch] [--sort-by=CHAMP] [[-o \| --output]=FORMAT_AFFICHAGE] [flags]` | Liste une ou plusieurs ressources. `label` | `kubectl label (-f FICHIER \| TYPE NOM \| TYPE/NOM) CLE_1=VAL_1 ... CLE_N=VAL_N [--overwrite] [--all] [--resource-version=version] [flags]` | Ajoute ou met à jour les labels d'une ou plusieurs ressources. @@ -99,48 +101,58 @@ Rappelez-vous : Pour tout savoir sur les opérations, voir la documentation de r ## Types de ressources -Le tableau suivant inclut la liste de tous les types de ressources pris en charge et leurs alias abrégés : +Le tableau suivant inclut la liste de tous les types de ressources pris en charge et leurs alias abrégés. -Type de ressource | Alias abrégé ----------------------------- | -------------------- -`apiservices` | -`certificatesigningrequests` |`csr` -`clusters` | -`clusterrolebindings` | -`clusterroles` | -`componentstatuses` |`cs` -`configmaps` |`cm` -`controllerrevisions` | -`cronjobs` | -`customresourcedefinition` |`crd` -`daemonsets` |`ds` -`deployments` |`deploy` -`endpoints` |`ep` -`events` |`ev` -`horizontalpodautoscalers` |`hpa` -`ingresses` |`ing` -`jobs` | -`limitranges` |`limits` -`namespaces` |`ns` -`networkpolicies` |`netpol` -`nodes` |`no` -`persistentvolumeclaims` |`pvc` -`persistentvolumes` |`pv` -`poddisruptionbudget` |`pdb` -`podpreset` | -`pods` |`po` -`podsecuritypolicies` |`psp` -`podtemplates` | -`replicasets` |`rs` -`replicationcontrollers` |`rc` -`resourcequotas` |`quota` -`rolebindings` | -`roles` | -`secrets` | -`serviceaccounts` |`sa` -`services` |`svc` -`statefulsets` | -`storageclasses` | +(cette sortie peut être obtenue depuis `kubectl api-resources`, et correspond à Kubernetes 1.13.3.) + +| Nom de la ressource | Noms abrégés | Groupe API | Par namespace | Genre de la ressource | +|---|---|---|---|---| +| `componentstatuses` | `cs` | | false | ComponentStatus | +| `configmaps` | `cm` | | true | ConfigMap | +| `endpoints` | `ep` | | true | Endpoints | +| `limitranges` | `limits` | | true | LimitRange | +| `namespaces` | `ns` | | false | Namespace | +| `nodes` | `no` | | false | Node | +| `persistentvolumeclaims` | `pvc` | | true | PersistentVolumeClaim | +| `persistentvolumes` | `pv` | | false | PersistentVolume | +| `pods` | `po` | | true | Pod | +| `podtemplates` | | | true | PodTemplate | +| `replicationcontrollers` | `rc` | | true| ReplicationController | +| `resourcequotas` | `quota` | | true | ResourceQuota | +| `secrets` | | | true | Secret | +| `serviceaccounts` | `sa` | | true | ServiceAccount | +| `services` | `svc` | | true | Service | +| `mutatingwebhookconfigurations` | | admissionregistration.k8s.io | false | MutatingWebhookConfiguration | +| `validatingwebhookconfigurations` | | admissionregistration.k8s.io | false | ValidatingWebhookConfiguration | +| `customresourcedefinitions` | `crd`, `crds` | apiextensions.k8s.io | false | CustomResourceDefinition | +| `apiservices` | | apiregistration.k8s.io | false | APIService | +| `controllerrevisions` | | apps | true | ControllerRevision | +| `daemonsets` | `ds` | apps | true | DaemonSet | +| `deployments` | `deploy` | apps | true | Deployment | +| `replicasets` | `rs` | apps | true | ReplicaSet | +| `statefulsets` | `sts` | apps | true | StatefulSet | +| `tokenreviews` | | authentication.k8s.io | false | TokenReview | +| `localsubjectaccessreviews` | | authorization.k8s.io | true | LocalSubjectAccessReview | +| `selfsubjectaccessreviews` | | authorization.k8s.io | false | SelfSubjectAccessReview | +| `selfsubjectrulesreviews` | | authorization.k8s.io | false | SelfSubjectRulesReview | +| `subjectaccessreviews` | | authorization.k8s.io | false | SubjectAccessReview | +| `horizontalpodautoscalers` | `hpa` | autoscaling | true | HorizontalPodAutoscaler | +| `cronjobs` | `cj` | batch | true | CronJob | +| `jobs` | | batch | true | Job | +| `certificatesigningrequests` | `csr` | certificates.k8s.io | false | CertificateSigningRequest | +| `leases` | | coordination.k8s.io | true | Lease | +| `events` | `ev` | events.k8s.io | true | Event | +| `ingresses` | `ing` | extensions | true | Ingress | +| `networkpolicies` | `netpol` | networking.k8s.io | true | NetworkPolicy | +| `poddisruptionbudgets` | `pdb` | policy | true | PodDisruptionBudget | +| `podsecuritypolicies` | `psp` | policy | false | PodSecurityPolicy | +| `clusterrolebindings` | | rbac.authorization.k8s.io | false | ClusterRoleBinding | +| `clusterroles` | | rbac.authorization.k8s.io | false | ClusterRole | +| `rolebindings` | | rbac.authorization.k8s.io | true | RoleBinding | +| `roles` | | rbac.authorization.k8s.io | true | Role | +| `priorityclasses` | `pc` | scheduling.k8s.io | false | PriorityClass | +| `storageclasses` | `sc` | storage.k8s.io | false | StorageClass | +| `volumeattachments` | | storage.k8s.io | false | VolumeAttachment | ## Options de sortie @@ -154,48 +166,48 @@ Le format de sortie par défaut pour toutes les commandes `kubectl` est le forma #### Syntaxe ```shell -kubectl [commande] [TYPE] [NOM] -o= +kubectl [commande] [TYPE] [NOM] -o ``` Selon l'opération `kubectl`, les formats de sortie suivants sont pris en charge : Format de sortie | Description -----------------------------------| ----------- -`-o=custom-columns=` | Affiche un tableau en utilisant une liste de [colonnes personnalisées](#custom-columns) séparées par des virgules. -`-o=custom-columns-file=` | Affiche un tableau en utilisant un modèle de [colonnes personnalisées](#custom-columns) dans le fichier ``. -`-o=json` | Affiche un objet de l'API formaté en JSON. -`-o=jsonpath=` | Affiche les champs définis par une expression [jsonpath](/docs/reference/kubectl/jsonpath/). -`-o=jsonpath-file=` | Affiche les champs définis par une expression [jsonpath](/docs/reference/kubectl/jsonpath/) dans le fichier ``. -`-o=name` | Affiche uniquement le nom de la ressource et rien de plus. -`-o=wide` | Affiche dans le format texte avec toute information supplémentaire. Pour les pods, le nom du nœud est inclus. -`-o=yaml` | Affiche un objet de l'API formaté en YAML. +`-o custom-columns=` | Affiche un tableau en utilisant une liste de [colonnes personnalisées](#custom-columns) séparées par des virgules. +`-o custom-columns-file=` | Affiche un tableau en utilisant un modèle de [colonnes personnalisées](#custom-columns) dans le fichier ``. +`-o json` | Affiche un objet de l'API formaté en JSON. +`-o jsonpath=` | Affiche les champs définis par une expression [jsonpath](/docs/reference/kubectl/jsonpath/). +`-o jsonpath-file=` | Affiche les champs définis par une expression [jsonpath](/docs/reference/kubectl/jsonpath/) dans le fichier ``. +`-o name` | Affiche uniquement le nom de la ressource et rien de plus. +`-o wide` | Affiche dans le format texte avec toute information supplémentaire. Pour les pods, le nom du nœud est inclus. +`-o yaml` | Affiche un objet de l'API formaté en YAML. ##### Exemple Dans cet exemple, la commande suivante affiche les détails d'un unique pod sous forme d'un objet formaté en YAML : ```shell -$ kubectl get pod web-pod-13je7 -o=yaml +$ kubectl get pod web-pod-13je7 -o yaml ``` Souvenez-vous : Voir la documentation de référence de [kubectl](/docs/user-guide/kubectl/) pour voir quels formats de sortie sont pris en charge par chaque commande. #### Colonnes personnalisées -Pour définir des colonnes personnalisées et afficher uniquement les détails voulus dans un tableau, vous pouvez utiliser l'option `custom-columns`. Vous pouvez choisir de définir les colonnes personnalisées soit en ligne soit dans un fichier modèle : `-o=custom-columns=` ou `-o=custom-columns-file=`. +Pour définir des colonnes personnalisées et afficher uniquement les détails voulus dans un tableau, vous pouvez utiliser l'option `custom-columns`. Vous pouvez choisir de définir les colonnes personnalisées soit en ligne soit dans un fichier modèle : `-o custom-columns=` ou `-o custom-columns-file=`. ##### Exemples En ligne : ```shell -$ kubectl get pods -o=custom-columns=NOM:.metadata.name,RSRC:.metadata.resourceVersion +$ kubectl get pods -o custom-columns=NOM:.metadata.name,RSRC:.metadata.resourceVersion ``` Fichier modèle : ```shell -$ kubectl get pods -o=custom-columns-file=modele.txt +$ kubectl get pods -o custom-columns-file=modele.txt ``` où le fichier `modele.txt` contient : @@ -257,17 +269,17 @@ $ kubectl get pods --sort-by=.metadata.name Utilisez les exemples suivants pour vous familiariser avec les opérations de `kubectl` fréquemment utilisées : -`kubectl create` - Créer une ressource depuis un fichier ou stdin. +`kubectl apply` - Créer une ressource depuis un fichier ou stdin. ```shell # Crée un service en utilisant la définition dans exemple-service.yaml. -$ kubectl create -f exemple-service.yaml +$ kubectl apply -f exemple-service.yaml # Crée un replication controller en utilisant la définition dans exemple-controller.yaml. -$ kubectl create -f exemple-controller.yaml +$ kubectl apply -f exemple-controller.yaml # Crée les objets qui sont définis dans les fichiers .yaml, .yml ou .json du répertoire . -$ kubectl create -f +$ kubectl apply -f ``` `kubectl get` - Liste une ou plusieurs ressources.