3.3. Installation du CLI Knative
Le CLI de Knative (kn
) n'a pas son propre mécanisme de connexion. Pour vous connecter au cluster, vous devez installer la CLI OpenShift (oc
) et utiliser la commande oc login
. Les options d'installation des CLI peuvent varier en fonction de votre système d'exploitation.
Pour plus d'informations sur l'installation de l'OpenShift CLI (oc
) pour votre système d'exploitation et la connexion avec oc
, consultez la documentation de démarrage de l'OpenShift CLI.
OpenShift Serverless ne peut pas être installé à l'aide de la CLI Knative (kn
). Un administrateur de cluster doit installer l'opérateur OpenShift Serverless et configurer les composants Knative, comme décrit dans la documentation Installation de l'opérateur OpenShift Serverless.
Si vous essayez d'utiliser une ancienne version du CLI Knative (kn
) avec une version plus récente d'OpenShift Serverless, l'API n'est pas trouvée et une erreur se produit.
Par exemple, si vous utilisez la version 1.23.0 du CLI Knative (kn
), qui utilise la version 1.2, avec la version 1.24.0 d'OpenShift Serverless, qui utilise les versions 1.3 des API Knative Serving et Knative Eventing, le CLI ne fonctionne pas parce qu'il continue à rechercher les versions dépassées de l'API 1.2.
Assurez-vous que vous utilisez la dernière version du CLI Knative (kn
) pour votre version OpenShift Serverless afin d'éviter les problèmes.
3.3.1. Installer le CLI Knative à l'aide de la console web de OpenShift Container Platform
L'utilisation de la console web d'OpenShift Container Platform fournit une interface utilisateur rationalisée et intuitive pour installer le CLI Knative (kn
). Après l'installation d'OpenShift Serverless Operator, vous verrez un lien pour télécharger la CLI Knative (kn
) pour Linux (amd64, s390x, ppc64le), macOS ou Windows à partir de la page Command Line Tools dans la console web d'OpenShift Container Platform.
Conditions préalables
- Vous vous êtes connecté à la console web de OpenShift Container Platform.
OpenShift Serverless Operator et Knative Serving sont installés sur votre cluster OpenShift Container Platform.
ImportantSi libc n'est pas disponible, vous risquez d'obtenir l'erreur suivante lorsque vous exécutez des commandes CLI :
$ kn: No such file or directory
-
Si vous souhaitez utiliser les étapes de vérification pour cette procédure, vous devez installer le CLI OpenShift (
oc
).
Procédure
-
Téléchargez le CLI Knative (
kn
) à partir de la page Command Line Tools. Vous pouvez accéder à la page Command Line Tools en cliquant sur ledans le coin supérieur droit de la console web et en sélectionnant Command Line Tools dans la liste.
Décompressez l'archive :
tar -xf <fichier>
-
Déplacez le fichier binaire
kn
dans un répertoire de votre sitePATH
. Pour vérifier votre
PATH
, exécutez :$ echo $PATH
Vérification
Exécutez les commandes suivantes pour vérifier que les ressources et la route Knative CLI correctes ont été créées :
$ oc get ConsoleCLIDownload
Exemple de sortie
NAME DISPLAY NAME AGE kn kn - OpenShift Serverless Command Line Interface (CLI) 2022-09-20T08:41:18Z oc-cli-downloads oc - OpenShift Command Line Interface (CLI) 2022-09-20T08:00:20Z
$ oc get route -n openshift-serverless
Exemple de sortie
NAME HOST/PORT PATH SERVICES PORT TERMINATION WILDCARD kn kn-openshift-serverless.apps.example.com knative-openshift-metrics-3 http-cli edge/Redirect None
3.3.2. Installer le CLI Knative pour Linux à l'aide d'un gestionnaire de paquets RPM
Pour Red Hat Enterprise Linux (RHEL), vous pouvez installer le CLI Knative (kn
) en tant que RPM à l'aide d'un gestionnaire de paquets, tel que yum
ou dnf
. Cela permet au système de gérer automatiquement la version du CLI Knative. Par exemple, l'utilisation d'une commande telle que dnf upgrade
met à jour tous les paquets, y compris kn
, si une nouvelle version est disponible.
Conditions préalables
- Vous disposez d'un abonnement OpenShift Container Platform actif sur votre compte Red Hat.
Procédure
S'inscrire auprès du gestionnaire d'abonnements Red Hat :
# subscription-manager register
Extraire les données d'abonnement les plus récentes :
# subscription-manager refresh
Attachez l'abonnement au système enregistré :
# subscription-manager attach --pool=<pool_id> 1
- 1
- ID du pool pour un abonnement actif à OpenShift Container Platform
Activer les dépôts requis par le CLI Knative (
kn
) :Linux (x86_64, amd64)
# subscription-manager repos --enable="openshift-serverless-1-for-rhel-8-x86_64-rpms"
Linux sur IBM zSystems et IBM® LinuxONE (s390x)
# subscription-manager repos --enable="openshift-serverless-1-for-rhel-8-s390x-rpms"
Linux sur IBM Power (ppc64le)
# subscription-manager repos --enable="openshift-serverless-1-for-rhel-8-ppc64le-rpms"
Installez le CLI Knative (
kn
) en tant que RPM à l'aide d'un gestionnaire de paquets :Exemple de commande
yum
# yum install openshift-serverless-clients
3.3.3. Installation du CLI Knative pour Linux
Si vous utilisez une distribution Linux qui ne dispose pas de RPM ou d'un autre gestionnaire de paquets, vous pouvez installer le CLI Knative (kn
) sous la forme d'un fichier binaire. Pour ce faire, vous devez télécharger et décompresser une archive tar.gz
et ajouter le fichier binaire à un répertoire de votre PATH
.
Conditions préalables
Si vous n'utilisez pas RHEL ou Fedora, assurez-vous que libc est installé dans un répertoire de votre chemin de bibliothèque.
ImportantSi libc n'est pas disponible, vous risquez d'obtenir l'erreur suivante lorsque vous exécutez des commandes CLI :
$ kn: No such file or directory
Procédure
Téléchargez l'archive Knative (
kn
) CLItar.gz
:Vous pouvez également télécharger n'importe quelle version de
kn
en naviguant vers le répertoire correspondant à cette version dans le miroir de téléchargement du client Serverless.Décompressez l'archive :
tar -xf <filename>
-
Déplacez le fichier binaire
kn
dans un répertoire de votre sitePATH
. Pour vérifier votre
PATH
, exécutez :$ echo $PATH
3.3.4. Installation de la CLI Knative pour macOS
Si vous utilisez macOS, vous pouvez installer le CLI Knative (kn
) sous forme de fichier binaire. Pour ce faire, vous devez télécharger et décompresser une archive tar.gz
et ajouter le fichier binaire à un répertoire de votre PATH
.
Procédure
Téléchargez l'archive du CLI Knative (
kn
)tar.gz
.Vous pouvez également télécharger n'importe quelle version de
kn
en naviguant vers le répertoire correspondant à cette version dans le miroir de téléchargement du client Serverless.- Décompressez et extrayez l'archive.
-
Déplacez le fichier binaire
kn
dans un répertoire de votre sitePATH
. Pour vérifier votre
PATH
, ouvrez une fenêtre de terminal et exécutez :$ echo $PATH
3.3.5. Installation du CLI Knative pour Windows
Si vous utilisez Windows, vous pouvez installer le CLI Knative (kn
) sous forme de fichier binaire. Pour ce faire, vous devez télécharger et décompresser une archive ZIP et ajouter le fichier binaire à un répertoire de votre site PATH
.
Procédure
Télécharger l'archive ZIP du CLI Knative (
kn
).Vous pouvez également télécharger n'importe quelle version de
kn
en naviguant vers le répertoire correspondant à cette version dans le miroir de téléchargement du client Serverless.- Extraire l'archive à l'aide d'un programme ZIP.
-
Déplacez le fichier binaire
kn
dans un répertoire de votre sitePATH
. Pour vérifier votre
PATH
, ouvrez l'invite de commande et exécutez la commande suivante :C:\N> path