Update from EN docs for install-kubectl task (#19616)

* Update from EN docs for install-kubectl task

* add missing option "--client"

* typo alternatif=> alternatifs

* Update content/fr/docs/tasks/tools/install-kubectl.md

Co-Authored-By: Tim Bannister <tim@scalefactory.com>

* Update content/fr/docs/tasks/tools/install-kubectl.md

Co-Authored-By: Rémy Léone <remy.leone@gmail.com>

* Update content/fr/docs/tasks/tools/install-kubectl.md

Co-Authored-By: Rémy Léone <remy.leone@gmail.com>

Co-authored-by: Tim Bannister <tim@scalefactory.com>
Co-authored-by: Rémy Léone <remy.leone@gmail.com>
This commit is contained in:
Gasmi Christophe 2020-03-13 17:06:41 +01:00 committed by GitHub
parent 6cf5ce0f35
commit 3e117cd6b7
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 81 additions and 34 deletions

View File

@ -54,7 +54,7 @@ Vous devez utiliser une version de kubectl qui différe seulement d'une version
4. Testez pour vous assurer que la version que vous avez installée est à jour: 4. Testez pour vous assurer que la version que vous avez installée est à jour:
``` ```
kubectl version kubectl version --client
``` ```
### Installation à l'aide des gestionnaires des paquets natifs ### Installation à l'aide des gestionnaires des paquets natifs
@ -80,28 +80,33 @@ yum install -y kubectl
{{< /tab >}} {{< /tab >}}
{{< /tabs >}} {{< /tabs >}}
### Installation avec des gestionnaires de paquets alternatifs
### Installer avec snap {{< tabs name="other_kubectl_install" >}}
{{% tab name="Snap" %}}
Si vous êtes sur Ubuntu ou une autre distribution Linux qui supporte le gestionnaire de paquets [snap](https://snapcraft.io/docs/core/install), kubectl est disponible comme application [snap](https://snapcraft.io/). Si vous êtes sur Ubuntu ou une autre distribution Linux qui supporte le gestionnaire de paquets [snap](https://snapcraft.io/docs/core/install), kubectl est disponible comme application [snap](https://snapcraft.io/).
1. Passez à l'utilisateur snap et exécutez la commande d'installation : ```shell
snap install kubectl --classic
kubectl version --client
``` ```
sudo snap install kubectl --classic {{% /tab %}}
``` {{% tab name="Homebrew" %}}
Si vous êtes sur Linux et que vous utiliser [Homebrew](https://docs.brew.sh/Homebrew-on-Linux) comme gestionnaire de paquets, kubectl est disponible. [installation](https://docs.brew.sh/Homebrew-on-Linux#install)
2. Testez pour vous assurer que la version que vous avez installée est à jour : ```shell
brew install kubectl
kubectl version --client
``` ```
kubectl version {{% /tab %}}
``` {{< /tabs >}}
## Installer kubectl sur macOS ## Installer kubectl sur macOS
### Installer le binaire kubectl avec curl sur macOS ### Installer le binaire kubectl avec curl sur macOS
1. Téléchargez la dernière release: 1. Téléchargez la dernière version:
``` ```
curl -LO https://storage.googleapis.com/kubernetes-release/release/$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)/bin/darwin/amd64/kubectl curl -LO https://storage.googleapis.com/kubernetes-release/release/$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)/bin/darwin/amd64/kubectl
@ -129,7 +134,7 @@ Si vous êtes sur Ubuntu ou une autre distribution Linux qui supporte le gestion
4. Testez pour vous assurer que la version que vous avez installée est à jour: 4. Testez pour vous assurer que la version que vous avez installée est à jour:
``` ```
kubectl version kubectl version --client
``` ```
### Installer avec Homebrew sur macOS ### Installer avec Homebrew sur macOS
@ -138,6 +143,11 @@ Si vous êtes sur MacOS et que vous utilisez le gestionnaire de paquets [Homebre
1. Exécutez la commande d'installation: 1. Exécutez la commande d'installation:
```
brew install kubectl
```
ou
``` ```
brew install kubernetes-cli brew install kubernetes-cli
``` ```
@ -145,7 +155,7 @@ Si vous êtes sur MacOS et que vous utilisez le gestionnaire de paquets [Homebre
2. Testez pour vous assurer que la version que vous avez installée est à jour: 2. Testez pour vous assurer que la version que vous avez installée est à jour:
``` ```
kubectl version kubectl version --client
``` ```
### Installer avec Macports sur macOS ### Installer avec Macports sur macOS
@ -162,14 +172,14 @@ Si vous êtes sur MacOS et que vous utilisez le gestionnaire de paquets [Macport
2. Testez pour vous assurer que la version que vous avez installée est à jour: 2. Testez pour vous assurer que la version que vous avez installée est à jour:
``` ```
kubectl version kubectl version --client
``` ```
## Installer kubectl sur Windows ## Installer kubectl sur Windows
### Installer le binaire kubectl avec curl sur Windows ### Installer le binaire kubectl avec curl sur Windows
1. Téléchargez la dernière release {{< param "fullversion" >}} depuis [ce lien](https://storage.googleapis.com/kubernetes-release/release/{{< param "fullversion" >}}/bin/windows/amd64/kubectl.exe). 1. Téléchargez la dernière version {{< param "fullversion" >}} depuis [ce lien](https://storage.googleapis.com/kubernetes-release/release/{{< param "fullversion" >}}/bin/windows/amd64/kubectl.exe).
Ou si vous avez `curl` installé, utilisez cette commande: Ou si vous avez `curl` installé, utilisez cette commande:
@ -183,8 +193,12 @@ Si vous êtes sur MacOS et que vous utilisez le gestionnaire de paquets [Macport
3. Testez pour vous assurer que la version que vous avez installée est à jour: 3. Testez pour vous assurer que la version que vous avez installée est à jour:
``` ```
kubectl version kubectl version --client
``` ```
{{< note >}}
[Docker Desktop pour Windows](https://docs.docker.com/docker-for-windows/#kubernetes) ajoute sa propre version de `kubectl` au $PATH.
Si vous avez déjà installé Docker Desktop, vous devrez peut-être placer votre entrée PATH avant celle ajoutée par le programme d'installation de Docker Desktop ou supprimer le `kubectl` de Docker Desktop.
{{< /note >}}
### Installer avec Powershell de PSGallery ### Installer avec Powershell de PSGallery
@ -204,7 +218,7 @@ Si vous êtes sous Windows et que vous utilisez le gestionnaire de paquets [Powe
2. Testez pour vous assurer que la version que vous avez installée est à jour: 2. Testez pour vous assurer que la version que vous avez installée est à jour:
``` ```
kubectl version kubectl version --client
``` ```
{{< note >}}La mise à jour de l'installation s'effectue en réexécutant les deux commandes listées à l'étape 1.{{< /note >}} {{< note >}}La mise à jour de l'installation s'effectue en réexécutant les deux commandes listées à l'étape 1.{{< /note >}}
@ -227,7 +241,7 @@ Pour installer kubectl sur Windows, vous pouvez utiliser le gestionnaire de paqu
2. Testez pour vous assurer que la version que vous avez installée est à jour: 2. Testez pour vous assurer que la version que vous avez installée est à jour:
``` ```
kubectl version kubectl version --client
``` ```
3. Accédez à votre répertoire personnel: 3. Accédez à votre répertoire personnel:
@ -269,7 +283,7 @@ Vous pouvez installer kubectl en tant qu'élément du SDK Google Cloud.
3. Testez pour vous assurer que la version que vous avez installée est à jour: 3. Testez pour vous assurer que la version que vous avez installée est à jour:
``` ```
kubectl version kubectl version --client
``` ```
## Vérification de la configuration de kubectl ## Vérification de la configuration de kubectl
@ -307,7 +321,7 @@ Vous trouverez ci-dessous les étapes à suivre pour configurer l'auto-compléti
{{< tabs name="kubectl_autocompletion" >}} {{< tabs name="kubectl_autocompletion" >}}
{{% tab name="Bash on Linux" %}} {{% tab name="Bash sur Linux" %}}
### Introduction ### Introduction
@ -344,6 +358,12 @@ Vous devez maintenant vérifier que le script de completion de kubectl est bien
```shell ```shell
kubectl completion bash >/etc/bash_completion.d/kubectl kubectl completion bash >/etc/bash_completion.d/kubectl
``` ```
- Si vous avez un alias pour kubectl, vous pouvez étendre la completion de votre shell pour fonctionner avec cet alias:
```shell
echo 'alias k=kubectl' >>~/.bashrc
echo 'complete -F __start_kubectl k' >>~/.bashrc
```
{{< note >}} {{< note >}}
bash-completion source tous les scripts de completion dans `/etc/bash_completion.d`. bash-completion source tous les scripts de completion dans `/etc/bash_completion.d`.
@ -354,49 +374,69 @@ Les deux approches sont équivalentes. Après avoir rechargé votre shell, l'aut
{{% /tab %}} {{% /tab %}}
{{% tab name="Bash on macOS" %}} {{% tab name="Bash sur macOS" %}}
{{< warning>}}
macOS inclut Bash 3.2 par défaut. Le script de complétion kubectl nécessite Bash 4.1+ et ne fonctionne pas avec Bash 3.2. Une des solutions possibles est d'installer une version plus récente de Bash sous macOS (voir instructions [ici](https://itnext.io/upgrading-bash-on-macos-7138bd1066ba)). Les instructions ci-dessous ne fonctionnent que si vous utilisez Bash 4.1+.
{{< /warning >}}
### Introduction ### Introduction
Le script de complétion kubectl pour Bash peut être généré avec la commande `kubectl completion bash`. Sourcer le script de completion dans votre shell permet l'auto-complétion de kubectl. Le script de complétion kubectl pour Bash peut être généré avec la commande `kubectl completion bash`. Sourcer le script de completion dans votre shell permet l'auto-complétion de kubectl.
En revanche, le script de complétion dépend de [**bash-completion**](https://github.com/scop/bash-completion), ce qui implique que vous devez d'abord installer ce logiciel (vous pouvez tester si vous avez déjà installé bash-completion en utilisant `type _init_completion`). En revanche, le script de complétion dépend de [**bash-completion**](https://github.com/scop/bash-completion), ce qui implique que vous devez d'abord installer ce logiciel.
{{< warning>}}
macOS inclut Bash 3.2 par défaut. Le script de complétion kubectl nécessite Bash 4.1+ et ne fonctionne pas avec Bash 3.2. Une des solutions possibles est d'installer une version plus récente de Bash sous macOS (voir instructions [ici](https://itnext.io/upgrading-bash-on-macos-7138bd1066ba)). Les instructions ci-dessous ne fonctionnent que si vous utilisez Bash 4.1+.
{{< /warning >}}
### Installer bash-completion ### Installer bash-completion
Vous pouvez installer bash-completion avec Homebrew: {{< note >}}
Comme mentionné, ces instructions supposent que vous utilisez Bash 4.1+, ce qui signifie que vous installerez bash-completion v2 (contrairement à Bash 3.2 et bash-completion v1, auquel cas la complétion pour kubectl ne fonctionnera pas).
{{< /note >}}
Vous pouvez tester si vous avez déjà installé bash-completion en utilisant `type _init_completion`. Si il n'est pas installé, vous pouvez installer bash-completion avec Homebrew:
```shell ```shell
brew install bash-completion brew install bash-completion@2
``` ```
Comme indiqué dans la sortie de `brew install` (section "Caveats"), ajoutez les lignes suivantes à votre fichier `~/.bashrc` ou `~/.bash_profile` : Comme indiqué dans la sortie de `brew install` (section "Caveats"), ajoutez les lignes suivantes à votre fichier `~/.bashrc` ou `~/.bash_profile` :
```shell ```shell
[ -f /usr/local/etc/bash_completion ] && . /usr/local/etc/bash_completion export BASH_COMPLETION_COMPAT_DIR="/usr/local/etc/bash_completion.d"
[[ -r "/usr/local/etc/profile.d/bash_completion.sh" ]] && . "/usr/local/etc/profile.d/bash_completion.sh"
``` ```
Rechargez votre shell. Rechargez votre shell et vérifiez que bash-completion v2 est correctement installé avec `type _init_completion`.
### Activer l'auto-complétion de kubectl ### Activer l'auto-complétion de kubectl
Si vous avez installé kubectl avec Homebrew (comme expliqué [ici](#installer-avec-homebrew-sur-macos)), alors le script de complétion a été automatiquement installé dans `/usr/local/etc/bash_completion.d/kubectl`. Dans ce cas, vous n'avez rien à faire.
Si vous n'avez pas installé via Homebrew, vous devez maintenant vous assurer que le script de complétion kubectl est bien sourcé dans toutes vos sessions shell comme suit: Si vous n'avez pas installé via Homebrew, vous devez maintenant vous assurer que le script de complétion kubectl est bien sourcé dans toutes vos sessions shell comme suit:
- Sourcer le script de completion dans votre fichier `~/.bashrc`:
```shell
echo 'source <(kubectl completion bash)' >>~/.bashrc
```
- Ajoutez le script de complétion dans le répertoire `/usr/local/etc/bash_completion.d`: - Ajoutez le script de complétion dans le répertoire `/usr/local/etc/bash_completion.d`:
```shell ```shell
kubectl completion bash >/usr/local/etc/bash_completion.d/kubectl kubectl completion bash >/usr/local/etc/bash_completion.d/kubectl
``` ```
- Si vous avez un alias pour kubectl, vous pouvez étendre la completion de votre shell pour fonctionner avec cet alias:
```shell
echo 'alias k=kubectl' >>~/.bashrc
echo 'complete -F __start_kubectl k' >>~/.bashrc
```
Si vous avez installé kubectl avec Homebrew (comme expliqué [ici](#installer-avec-homebrew-sur-macos)), alors le script de complétion a été automatiquement installé dans `/usr/local/etc/bash_completion.d/kubectl`. Dans ce cas, vous n'avez rien à faire.
{{< note >}} {{< note >}}
bash-completion (en cas d'installation avec Homebrew) source tous les scripts de complétion dans le répertoire. L'installation Homebrew de bash-complétion v2 source tous les fichiers du répertoire `BASH_COMPLETION_COMPAT_DIR`, c'est pourquoi les deux dernières méthodes fonctionnent.
{{< /note >}} {{< /note >}}
Après avoir rechargé votre shell, l'auto-complétion de kubectl devrait fonctionner. Après avoir rechargé votre shell, l'auto-complétion de kubectl devrait fonctionner.
@ -412,6 +452,13 @@ Pour faire ainsi dans toutes vos sessions shell, ajoutez ce qui suit à votre fi
source <(kubectl completion zsh) source <(kubectl completion zsh)
``` ```
Si vous avez un alias pour kubectl, vous pouvez étendre la completion de votre shell pour fonctionner avec cet alias:
```shell
echo 'alias k=kubectl' >>~/.zshrc
echo 'complete -F __start_kubectl k' >>~/.zshrc
```
Après avoir rechargé votre shell, l'auto-complétion de kubectl devrait fonctionner. Après avoir rechargé votre shell, l'auto-complétion de kubectl devrait fonctionner.
Si vous rencontrez une erreur comme `complete:13: command not found: compdef`, alors ajoutez ce qui suit au début de votre fichier `~/.zshrc`: Si vous rencontrez une erreur comme `complete:13: command not found: compdef`, alors ajoutez ce qui suit au début de votre fichier `~/.zshrc`: