Knative CLIのインストール¶
このガイドでは、Knativeのkn
CLIをインストールする方法について詳しく説明します。
CLIバイナリの検証¶
1.9以降のKnative kn
CLIリリースはcosignで署名されています。次の手順を使用して、CLIバイナリを検証できます。
-
コマンドを実行して、必要なファイルと
checksums.txt
、checksum.txt.pem
、checksums.txt.sig
ファイルをリリースページからダウンロードします。wget https://github.com/knative/client/releases/download/<kn-version>/checksums.txt wget https://github.com/knative/client/releases/download/<kn-version>/kn-darwin-amd64 wget https://github.com/knative/client/releases/download/<kn-version>/checksums.txt.sig wget https://github.com/knative/client/releases/download/<kn-version>/checksums.txt.pem
ここで
<kn-version>
は、検証するCLIのバージョンです。たとえば、knative-v1.8.0
です。 -
コマンドを実行して署名を検証します。
cosign verify-blob \ --cert checksums.txt.pem \ --signature checksums.txt.sig \ --certificate-identity=signer@knative-releases.iam.gserviceaccount.com \ --certificate-oidc-issuer=https://# \ checksums.txt
-
署名が有効な場合は、コマンドを実行して、
SHA256
合計がダウンロードされたバイナリと一致することを検証できます。sha256sum --ignore-missing -c checksums.txt
注記
KnativeイメージはKEYLESS
モードで署名されています。キーレス署名について詳しくは、キーレス署名を参照してください。Knativeリリースの署名IDはsigner@knative-releases.iam.gserviceaccount.com
、発行者はhttps://#
です。
Knative CLIのインストール¶
Knative CLI(kn
)は、YAMLファイルを直接作成または変更する必要なく、KnativeサービスやイベントソースなどのKnativeリソースを簡単に作成できるインターフェースを提供します。
kn
CLIは、自動スケーリングやトラフィック分割など、複雑な手順の完了も簡素化します。
次のいずれかを実行します。
-
Homebrewを使用して
kn
をインストールするには、コマンドを実行します(以前のバージョンからアップグレードする場合は、代わりにbrew upgrade
を使用します)。brew install knative/client/kn
Homebrewを使用した
kn
のアップグレードに問題がありますか?Homebrewを使用してアップグレードする際に問題が発生する場合は、
master
ブランチがmain
に名前変更されたCLIリポジトリの変更が原因である可能性があります。コマンドを実行して、この問題を解決します。brew uninstall kn brew untap knative/client --force brew install knative/client/kn
システムの実行可能バイナリをダウンロードしてシステムパスに配置することで、kn
をインストールできます。
-
kn
リリースページからシステムのバイナリをダウンロードします。 -
バイナリの名前を
kn
に変更し、次のコマンドを実行して実行可能にします。mv <path-to-binary-file> kn chmod +x kn
ここで
<path-to-binary-file>
は、前の手順でダウンロードしたバイナリファイルへのパスです(例:kn-darwin-amd64
またはkn-linux-amd64
)。 -
次のコマンドを実行して、実行可能バイナリファイルを
PATH
上のディレクトリに移動します。mv kn /usr/local/bin
-
kn
コマンドが正しく機能していることを確認します。例:kn version
-
kn
クライアントリポジトリをチェックアウトします。git clone https://github.com/knative/client.git cd client/
-
実行可能バイナリをビルドします。
hack/build.sh -f
-
次のコマンドを実行して、実行可能バイナリファイルを
PATH
上のディレクトリに移動します。mv kn /usr/local/bin
-
kn
コマンドが正しく機能していることを確認します。例:kn version
イメージへのリンクはここにあります。
コンテナイメージからkn
を実行できます。例:
docker run --rm -v "$HOME/.kube/config:/root/.kube/config" gcr.io/knative-releases/knative.dev/client/cmd/kn:latest service list
注記
コンテナイメージからkn
を実行しても、バイナリは永続的なパスに配置されません。kn
を使用するたびに、この手順を繰り返す必要があります。
ナイトリービルドバイナリを使用したknのインストール¶
警告
ナイトリーコンテナイメージには、最新のKnativeリリースに含まれていない可能性があり、安定しているとはみなされない機能が含まれています。
最新のkn
プレリリースビルドをインストールしたいユーザー向けに、ナイトリービルドの実行可能バイナリが提供されています。
最新のナイトリービルド実行可能バイナリへのリンクはここにあります。
Tektonでのknの使用¶
Tektonドキュメントを参照してください。