Knative Operator CLIプラグインを使用したインストール¶
Knativeは、コマンドラインからKnativeをインストール、設定、管理するためのCLIプラグインを提供します。このCLIプラグインは、カスタムリソースの複雑さに関与することなく、パラメーター駆動型でKnativeクラスタを設定する方法を提供します。
前提条件¶
Knativeをインストールする前に、以下の前提条件を満たす必要があります。
-
**プロトタイピング目的の場合**、KnativeはKubernetesのほとんどのローカル展開で動作します。たとえば、3つのCPUと4GBのメモリを持つローカルの1ノードクラスタを使用できます。
ヒント
Knativeクイックスタートプラグインを使用して、開発目的でKnativeのローカルディストリビューションをインストールできます。
-
**本番環境の場合**、以下をお勧めします。
- クラスタにノードが1つしかない場合、少なくとも6つのCPU、6GBのメモリ、30GBのディスクストレージが必要です。
- クラスタに複数のノードがある場合、各ノードに少なくとも2つのCPU、4GBのメモリ、20GBのディスクストレージが必要です。
- Kubernetes v1.28以降を使用するクラスタが必要です。
kubectl
CLIをインストールしている必要があります。- Kubernetesクラスタはインターネットにアクセスできる必要があります。Kubernetesはイメージを取得できる必要があります。プライベートレジストリからプルするには、プライベートコンテナレジストリからのイメージのデプロイを参照してください。
注意
提供されているシステム要件は推奨事項にすぎません。インストールに必要な要件は、ネットワークレイヤーなどのオプションコンポーネントを使用するかどうかによって異なる場合があります。
CLIバイナリの検証¶
1.9以降のKnative kn
CLIリリースはcosignで署名されています。以下の手順を使用して、CLIバイナリを検証できます。
-
検証するCLIのバージョンを指定して(例:
knative-v1.8.0
)、必要なファイルと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
コマンドを実行します。
-
次のコマンドを実行して署名を検証します。
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リリースの署名アイデンティティはsigner@knative-releases.iam.gserviceaccount.com
、発行者はhttps://#
です。
Knative Operator CLIプラグインのインストール¶
Knative Operator CLIプラグインをインストールする前に、まずKnative CLIをインストールしてください。
-
リリースページrelease pageから、お使いのシステム用のバイナリ
kn-operator-darwin-amd64
をダウンロードします。 -
バイナリ名を
kn-operator
に変更します。mv kn-operator-darwin-amd64 kn-operator
-
リリースページrelease pageから、お使いのシステム用のバイナリ
kn-operator-linux-amd64
をダウンロードします。 -
バイナリ名を
kn-operator
に変更します。mv kn-operator-linux-amd64 kn-operator
次のコマンドを実行して、プラグインを実行可能にします。
chmod +x kn-operator
kn
プラグインのディレクトリを作成します。
mkdir -p ~/.config/kn/plugins
ファイルをkn
のプラグインディレクトリに移動します。
cp kn-operator ~/.config/kn/plugins
Knative Operator CLIプラグインのインストールの検証¶
次のコマンドを実行して、インストールを検証できます。
kn operator -h
このCLIプラグインの使用方法に関する詳細が表示されます。
Knative Operatorのインストール¶
特定のバージョンのKnative Operatorを、特定の名前空間にインストールできます。デフォルトでは、名前空間はdefault
、バージョンは最新です。
最新バージョンのKnative Operatorをインストールするには、次のコマンドを実行します。
kn operator install
特定の名前空間(例:knative-operator)にKnative Operatorをインストールするには、次のコマンドを実行します。
kn operator install -n knative-operator
特定のバージョン(例:1.7.1)のKnative Operatorをインストールするには、次のコマンドを実行します。
kn operator install -v 1.7.1
Knative Servingコンポーネントのインストール¶
特定のバージョンのKnative Servingを、特定の名前空間にインストールできます。デフォルトでは、名前空間はknative-serving
、バージョンは最新です。
最新バージョンのKnative Servingをインストールするには、次のコマンドを実行します。
kn operator install --component serving
特定の名前空間(例:knative-serving)にKnative Servingをインストールするには、次のコマンドを実行します。
kn operator install --component serving -n knative-serving
特定のバージョン(例:1.7)のKnative Operatorをインストールするには、次のコマンドを実行します。
kn operator install --component serving -n knative-serving -v "1.7"
インストールコマンドと共に、Kourierなどのイングレスプラグインをインストールするには、次のコマンドを実行します。
kn operator install --component serving -n knative-serving -v "1.7" --kourier
イングレスプラグインを指定しない場合、デフォルトとしてistioが使用されます。ただし、まずIstioをインストールする必要があります。
ネットワーク層のインストール¶
Operator CLIプラグインを使用してネットワーク層オプションを設定できます。異なるイングレスを使用してKnative Servingを設定する方法については、以下の各タブをクリックしてください。
以下の手順では、Kourierをインストールし、そのKnative統合を有効にします。
-
Knative ServingでKourierを使用するように設定するには、次のコマンドを実行します。
kn operator enable ingress --kourier -n knative-serving
以下の手順では、Istioをインストールし、そのKnative統合を有効にします。
-
Knative ServingでIstioを使用するように設定するには、次のコマンドを実行します。
kn operator enable ingress --istio -n knative-serving
以下の手順では、Contourをインストールし、そのKnative統合を有効にします。
-
適切に設定されたContourをインストールします。
kubectl apply --filename https://github.com/knative/net-contour/releases/download/knative-v1.16.0/contour.yaml
-
Knative ServingでContourを使用するように設定するには、次のコマンドを実行します。
kn operator enable ingress --contour -n knative-serving
Knative Eventing コンポーネントのインストール¶
任意の特定のバージョンを任意の特定の名前空間下にインストールできます。デフォルトでは、名前空間はknative-eventing
、バージョンは最新版です。
最新バージョンのKnative Eventingをインストールするには、以下を実行します。
kn operator install --component eventing
特定の名前空間(例: knative-eventing)下にKnative Eventingをインストールするには、以下を実行します。
kn operator install --component eventing -n knative-eventing
特定のバージョン(例:1.7)のKnative Operatorをインストールするには、次のコマンドを実行します。
kn operator install --component eventing -n knative-eventing -v "1.7"
イベントソースを使用したKnative Eventingのインストール¶
Knative Operatorは、さまざまなイベントソースを使用してKnative Eventingコンポーネントを構成できます。以下の各タブをクリックして、さまざまなイベントソースを使用してKnative Eventingを構成する方法を確認してください。
-
イベントソースCephをインストールするには、以下のコマンドを実行します。
kn operator enable eventing-source --ceph --namespace knative-eventing
-
イベントソースGithubをインストールするには、以下のコマンドを実行します。
kn operator enable eventing-source --github --namespace knative-eventing
-
イベントソースGitLabをインストールするには、以下のコマンドを実行します。
kn operator enable eventing-source --gitlab --namespace knative-eventing
-
イベントソースKafkaをインストールするには、以下のコマンドを実行します。
kn operator enable eventing-source --kafka --namespace knative-eventing
-
イベントソースRabbitMQをインストールするには、以下のコマンドを実行します。
kn operator enable eventing-source --rabbitmq --namespace knative-eventing
-
イベントソースRedisをインストールするには、以下のコマンドを実行します。
kn operator enable eventing-source --redis --namespace knative-eventing