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.

Important

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.

    Important

    Si 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

  1. 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 le cercle d'interrogation dans le coin supérieur droit de la console web et en sélectionnant Command Line Tools dans la liste.
  2. Décompressez l'archive :

    tar -xf <fichier>
  3. Déplacez le fichier binaire kn dans un répertoire de votre site PATH.
  4. 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

  1. S'inscrire auprès du gestionnaire d'abonnements Red Hat :

    # subscription-manager register
  2. Extraire les données d'abonnement les plus récentes :

    # subscription-manager refresh
  3. 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
  4. 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"
  5. 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.

    Important

    Si 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

  1. Téléchargez l'archive Knative (kn) CLI 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.

  2. Décompressez l'archive :

    tar -xf <filename>
  3. Déplacez le fichier binaire kn dans un répertoire de votre site PATH.
  4. 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

  1. 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.

  2. Décompressez et extrayez l'archive.
  3. Déplacez le fichier binaire kn dans un répertoire de votre site PATH.
  4. 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

  1. 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.

  2. Extraire l'archive à l'aide d'un programme ZIP.
  3. Déplacez le fichier binaire kn dans un répertoire de votre site PATH.
  4. Pour vérifier votre PATH, ouvrez l'invite de commande et exécutez la commande suivante :

    C:\N> path
Red Hat logoGithubRedditYoutubeTwitter

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Nous aidons les utilisateurs de Red Hat à innover et à atteindre leurs objectifs grâce à nos produits et services avec un contenu auquel ils peuvent faire confiance.

Rendre l’open source plus inclusif

Red Hat s'engage à remplacer le langage problématique dans notre code, notre documentation et nos propriétés Web. Pour plus de détails, consultez leBlog Red Hat.

À propos de Red Hat

Nous proposons des solutions renforcées qui facilitent le travail des entreprises sur plusieurs plates-formes et environnements, du centre de données central à la périphérie du réseau.

© 2024 Red Hat, Inc.