第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
アーカイブをダウンロードします。アーカイブを展開します。
$ 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
バイナリーをPATH
にあるディレクトリーに移動します。 PATH
を確認するには、ターミナルウィンドウを開き、以下を実行します。$ echo $PATH
4.1.5. Windows の Knative CLI のインストール
Windows を使用している場合は、Knative (kn
) CLI をバイナリーファイルとしてインストールできます。これを行うには、ZIP アーカイブをダウンロードして解凍し、バイナリーを PATH
のディレクトリーに追加する必要があります。
手順
-
Knative (
kn
) CLIZIP アーカイブ をダウンロードします。 - ZIP プログラムでアーカイブを展開します。
-
kn
バイナリーをPATH
にあるディレクトリーに移動します。 PATH
を確認するには、コマンドプロンプトを開いて以下のコマンドを実行します。C:\> path