第3章 Knative CLI のインストール
Knative (kn
) CLI には、独自のログインメカニズムがありません。クラスターにログインするには、OpenShift (oc
) CLI をインストールし、oc login
コマンドを使用する必要があります。CLI のインストールオプションは、オペレーティングシステムによって異なる場合があります。
ご使用のオペレーティングシステム用に OpenShift CLI (oc
) をインストールする方法および oc
でのログイン方法の詳細は、OpenShift CLI の使用開始 に関するドキュメントを参照してください。
Knative (kn
) CLI を使用して OpenShift Serverless をインストールすることはできません。クラスター管理者は、OpenShift Serverless Operator のインストール のドキュメントで説明されているように、OpenShift Serverless Operator をインストールし、Knative コンポーネントをセットアップする必要があります。
新しい OpenShift Serverless リリースで古いバージョンの Knative (kn
) CLI の使用を試行する場合は、API が見つからないとエラーが発生します。
たとえば、バージョン 1.2 を使用する Knative (kn
) CLI の 1.23.0 リリースと、Knative Serving および Knative Eventing API の 1.3 バージョンを使用する 1.24.0 OpenShift Serverless リリースを使用する場合、CLI は古い 1.2 API バージョンを探し続けるため、機能しません。
問題を回避するために、OpenShift Serverless リリースの最新の Knative (kn
) CLI バージョンを使用していることを確認してください。
3.1. OpenShift Container Platform Web コンソールを使用した Knative CLI のインストール
OpenShift Container Platform Web コンソールを使用すると、Knative (kn
) CLI をインストールするための合理化された直感的なユーザーインターフェイスが提供されます。OpenShift Serverless Operator をインストールすると、OpenShift Container PlatformWeb コンソールの コマンドラインツール ページから Linux (amd64、s390x、ppc64le)、macOS、または Windows 用の Knative (kn
) CLI をダウンロードするためのリンクが表示されます。
前提条件
- OpenShift Container Platform Web コンソールにログインしている。
OpenShift Serverless Operator および Knative Serving が OpenShift Container Platform クラスターにインストールされている。
重要libc が利用できない場合は、CLI コマンドの実行時に以下のエラーが表示される場合があります。
$ kn: No such file or directory
-
この手順の検証手順を使用する場合は、OpenShift (
oc
) CLI をインストールする必要がある。
手順
-
Command Line Tools ページから Knative (
kn
) CLI をダウンロードします。Command Line Tools ページには、Web コンソールの右上の アイコンをクリックして、リストの Command Line Tools を選択します。 アーカイブを展開します。
$ tar -xf <file>
-
kn
バイナリーをPATH
にあるディレクトリーに移動します。 PATH
を確認するには、以下を実行します。$ echo $PATH
検証
以下のコマンドを実行して、正しい Knative CLI リソースおよびルートが作成されていることを確認します。
$ oc get ConsoleCLIDownload
出力例
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
出力例
NAME HOST/PORT PATH SERVICES PORT TERMINATION WILDCARD kn kn-openshift-serverless.apps.example.com knative-openshift-metrics-3 http-cli edge/Redirect None