Installer la CLI Kf

Ce document explique comment installer la CLI Kf. Vous installez généralement la CLI Kf lorsque vous avez déjà accès à un cluster GKE exécutant Kf. Vous pouvez donc commencer à utiliser les commandes Kf sans avoir à créer votre propre cluster GKE.

Après avoir installé la CLI Kf et vous être connecté au cluster Kf, vous pouvez exécuter l'une des commandes Kf. Pour obtenir la liste complète des commandes Kf disponibles, consultez la documentation de référence des commandes Kf.

Avant de commencer

Pour utiliser la CLI Kf, vous devez avoir accès à un cluster GKE exécutant une installation Kf complète. Cela signifie que vous avez exécuté la commande suivante pour vous connecter au cluster :

gcloud container clusters get-credentials CLUSTER_NAME \
    --project=CLUSTER_PROJECT_ID \
    --zone=CLUSTER_LOCATION

Installer la CLI

Installez la CLI Kf :
Linux
Cette commande installe la CLI Kf pour tous les utilisateurs du système. Suivez les instructions de l'onglet Cloud Shell pour l'installer juste pour vous.
```
gcloud storage cp gs://kf-releases/v2.6.1/kf-linux /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf
```
Mac
Cette commande installe kf pour tous les utilisateurs du système.
```
gcloud storage cp gs://kf-releases/v2.6.1/kf-darwin /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf
```
Cloud Shell
kf sera installé sur votre instance Cloud Shell si vous utilisez bash, et vous devrez peut-être modifier les instructions pour les autres interfaces système.
```
mkdir -p ~/bin
gcloud storage cp gs://kf-releases/v2.6.1/kf-linux ~/bin/kf
chmod a+x ~/bin/kf
echo "export PATH=$HOME/bin:$PATH" >> ~/.bashrc
source ~/.bashrc
```
Windows
Cette commande télécharge kf dans le répertoire actuel. Si vous souhaitez l'appeler depuis un emplacement autre que le répertoire actuel, ajoutez-le au chemin d'accès.
```
gcloud storage cp gs://kf-releases/v2.6.1/kf-windows.exe kf.exe
```

Mettre à niveau la CLI

Si vous disposez déjà d'une installation de la CLI Kf, vous pouvez utiliser la procédure suivante pour la mettre à niveau vers la version actuelle.

Installez la CLI :
Linux
Cette commande installe la CLI Kf pour tous les utilisateurs du système. Suivez les instructions de l'onglet Cloud Shell pour l'installer juste pour vous.
```
gcloud storage cp gs://kf-releases/v2.6.1/kf-linux /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf
```
Mac
Cette commande installe kf pour tous les utilisateurs du système.
```
gcloud storage cp gs://kf-releases/v2.6.1/kf-darwin /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf
```
Cloud Shell
kf sera installé sur votre instance Cloud Shell si vous utilisez bash, et vous devrez peut-être modifier les instructions pour les autres interfaces système.
```
mkdir -p ~/bin
gcloud storage cp gs://kf-releases/v2.6.1/kf-linux ~/bin/kf
chmod a+x ~/bin/kf
echo "export PATH=$HOME/bin:$PATH" >> ~/.bashrc
source ~/.bashrc
```
Windows
kf sera téléchargé dans le répertoire actuel. Si vous souhaitez l'appeler depuis un emplacement autre que le répertoire actuel, ajoutez-le au chemin d'accès.
```
gcloud storage cp gs://kf-releases/v2.6.1/kf-windows.exe kf.exe
```
Validez la correspondance des versions de la CLI Kf et du serveur Kf :
- La version de la CLI apparaît sous Kf Client.
- La version du serveur Kf apparaît sous kf["app.kubernetes.io/version"].
```
$ kf debug
...
Version:
  Kf Client:                        v2.6.1
  Server version:                   v1.21.3-gke.2001
  kf["app.kubernetes.io/version"]:  v2.6.1
...
```