第4章 Knative CLI
4.1. Knative CLI のインストール
Knative (kn) CLI には、独自のログインメカニズムがありません。クラスターにログインするには、OpenShift (oc) CLI をインストールし、oc login コマンドを使用する必要があります。CLI のインストールオプションは、オペレーティングシステムによって異なる場合があります。
ご使用のオペレーティングシステム用に oc CLI をインストールする方法および 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 バージョンを使用していることを確認してください。
4.1.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
4.1.2. RPM パッケージマネージャーを使用した Linux 用の Knative CLI のインストール
Red Hat Enterprise Linux (RHEL) の場合、yum や dnf などのパッケージマネージャーを使用して、Knative (kn) CLI を RPM としてインストールできます。これにより、Knative CLI バージョンをシステムで自動的に管理できます。たとえば、dnf upgrade のようなコマンドを使用すると、新しいバージョンが利用可能な場合、kn を含むすべてのパッケージがアップグレードされます。
前提条件
- お使いの Red Hat アカウントに有効な OpenShift Container Platform サブスクリプションがある。
手順
Red Hat Subscription Manager に登録します。
# subscription-manager register
最新のサブスクリプションデータをプルします。
# subscription-manager refresh
登録済みのシステムにサブスクリプションを添付します。
# subscription-manager attach --pool=<pool_id> 1- 1
- 有効な OpenShift Container Platform サブスクリプションのプール ID
Knative (
kn) CLI に必要なリポジトリーを有効にします。Linux (x86_64, amd64)
# subscription-manager repos --enable="openshift-serverless-1-for-rhel-8-x86_64-rpms"
Linux on IBM Z and LinuxONE (s390x)
# subscription-manager repos --enable="openshift-serverless-1-for-rhel-8-s390x-rpms"
Linux on IBM Power (ppc64le)
# subscription-manager repos --enable="openshift-serverless-1-for-rhel-8-ppc64le-rpms"
パッケージマネージャーを使用して、Knative (
kn) CLI を RPM としてインストールします。yumコマンドの例# yum install openshift-serverless-clients
4.1.3. Linux の Knative CLI のインストール
RPM または別のパッケージマネージャーがインストールされていない Linux ディストリビューションを使用している場合は、Knative (kn) CLI をバイナリーファイルとしてインストールできます。これを行うには、tar.gz アーカイブをダウンロードして解凍し、バイナリーを PATH のディレクトリーに追加する必要があります。
前提条件
RHEL または Fedora を使用していない場合は、ライブラリーパスのディレクトリーに libc がインストールされていることを確認してください。
重要libc が利用できない場合は、CLI コマンドの実行時に以下のエラーが表示される場合があります。
$ kn: No such file or directory
手順
Knative (
kn) CLI のtar.gzアーカイブをダウンロードします。また、サーバーレスクライアントダウンロードミラー 内のそのバージョンに対応するディレクトリーに移動して、任意のバージョンの
knをダウンロードすることもできます。アーカイブを展開します。
$ tar -xf <filename>
-
knバイナリーをPATHにあるディレクトリーに移動します。 PATHを確認するには、以下を実行します。$ echo $PATH
4.1.4. macOS の Knative CLI のインストール
macOS を使用している場合は、Knative (kn) CLI をバイナリーファイルとしてインストールできます。これを行うには、tar.gz アーカイブをダウンロードして解凍し、バイナリーを PATH のディレクトリーに追加する必要があります。
手順
Knative (
kn)CLItar.gzアーカイブ をダウンロードします。また、サーバーレスクライアントダウンロードミラー 内のそのバージョンに対応するディレクトリーに移動して、任意のバージョンの
knをダウンロードすることもできます。- アーカイブを解凍して解凍します。
-
knバイナリーをPATHにあるディレクトリーに移動します。 PATHを確認するには、ターミナルウィンドウを開き、以下を実行します。$ echo $PATH
4.1.5. Windows の Knative CLI のインストール
Windows を使用している場合は、Knative (kn) CLI をバイナリーファイルとしてインストールできます。これを行うには、ZIP アーカイブをダウンロードして解凍し、バイナリーを PATH のディレクトリーに追加する必要があります。
手順
Knative (
kn) CLIZIP アーカイブ をダウンロードします。また、サーバーレスクライアントダウンロードミラー 内のそのバージョンに対応するディレクトリーに移動して、任意のバージョンの
knをダウンロードすることもできます。- ZIP プログラムでアーカイブを展開します。
-
knバイナリーをPATHにあるディレクトリーに移動します。 PATHを確認するには、コマンドプロンプトを開いて以下のコマンドを実行します。C:\> path
