クイックスタートを使用した Knative のインストール¶

このクイックスタートチュートリアルに従うと、Knative の `quickstart` プラグインを使用して、簡素化されたローカル Knative 環境をインストールできます。

始める前に¶

警告

Knative の `quickstart` 環境は、実験目的でのみ使用してください。本番環境へのインストールについては、YAML ベースのインストールまたはKnative Operator インストールを参照してください。

Knative の `quickstart` 展開を開始する前に、以下をインストールする必要があります。

kind (Kubernetes in Docker) または minikube。これにより、Docker コンテナノードを使用してローカル Kubernetes クラスタを実行できます。
Kubernetes CLI (`kubectl`)。Kubernetes クラスタに対してコマンドを実行します。`kubectl` を使用して、アプリケーションをデプロイし、クラスタリソースを検査および管理し、ログを表示できます。
Knative CLI (`kn`)。手順については、次のセクションを参照してください。
クラスタを作成するには、最低 3 つの CPU と 3 GB の RAM が必要です。

Knative CLI のインストール¶

Knative CLI (`kn`) は、YAML ファイルを直接作成または変更する必要なく、Knative サービスやイベントソースなどの Knative リソースを簡単に作成するためのインターフェースを提供します。

`kn` CLI は、オートスケーリングやトラフィック分割などの複雑な手順の完了も簡素化します。

Homebrew を使用バイナリを使用Go を使用コンテナイメージを使用

次のいずれかを実行します。

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
```
ここで、`` は、ダウンロードしたバイナリファイルへのパスです（例: `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` を使用するたびに、この手順を繰り返す必要があります。

Knative クイックスタートプラグインのインストール¶

開始するには、Knative の `quickstart` プラグインをインストールします。

Homebrew を使用バイナリを使用Go を使用

次のいずれかを実行します。

Homebrew を使用して `quickstart` プラグインをインストールするには、次のコマンドを実行します（以前のバージョンからアップグレードする場合は、代わりに `brew upgrade` を使用します）。
```
brew install knative-extensions/kn-plugins/quickstart
```

`quickstart` リリースページからシステムのバイナリをダウンロードします。
OS とアーキテクチャの情報を削除するためにファイル名を変更します。例: `kn-quickstart-amd64` を `kn-quickstart` に変更します。
プラグインを実行可能にします。例: `chmod +x kn-quickstart`。
`PATH` 上のディレクトリに実行可能バイナリファイルを移動するには、次のコマンドを実行します。
```
mv kn-quickstart /usr/local/bin
```
次のコマンドを実行して、プラグインが機能していることを確認します。
```
kn quickstart --help
```

`kn-plugin-quickstart` リポジトリをチェックアウトします。

git clone https://github.com/knative-extensions/kn-plugin-quickstart.git
cd kn-plugin-quickstart/

実行可能バイナリをビルドします。
```
hack/build.sh
```
`PATH` 上のディレクトリに実行可能バイナリファイルを移動するには、次のコマンドを実行します。
```
mv kn-quickstart /usr/local/bin
```
次のコマンドを実行して、プラグインが機能していることを確認します。
```
kn quickstart --help
```

Knative クイックスタートプラグインの実行¶

`quickstart` プラグインは、次の機能を実行します。

選択した Kubernetes インスタンスがインストールされているかどうかを確認します。
`knative` というクラスタを作成します。
**Knative Serving をインストールします。**Kourier をデフォルトのネットワーキングレイヤーとして、sslip.io を DNS として使用します。
**Knative Eventing をインストールし、**インメモリブローカーとチャネルの実装を作成します。

Knative のローカル展開を取得するには、`quickstart` プラグインを実行します。

kind を使用minikube を使用

kind を使用して Knative と Kubernetes をインストールするには、次のコマンドを実行します。
```
kn quickstart kind
```
注記

クイックスタートはポート 80 を使用し、他のサービスがそのポートにバインドされている場合、インストールに失敗します。ポート 80 を使用しているサービスがある場合は、クイックスタートを使用する前に停止する必要があります。ポート 80 を使用している他のサービスを確認するには
```
netstat -tnlp | grep 80
```
プラグインが完了したら、`knative` というクラスタがあることを確認します。
```
kind get clusters
```

minikube インスタンスに Knative と Kubernetes をインストールするには、次のコマンドを実行します。

注記

minikube クラスタは 3 GB の RAM で作成されます。minikube のメモリ設定を変更することで、3 GB 以上に変更できます。例: `minikube config set memory 4096` は 4 GB の RAM を使用します。
```
kn quickstart minikube
```
前のコマンドの出力で、minikube tunnel を実行するように求められました。セカンダリターミナルウィンドウで次のコマンドを実行してから、プライマリウィンドウに戻って Enter キーを押して続行します。
```
minikube tunnel --profile knative
```
Knative の `quickstart` 環境を使用している間は、常にターミナルウィンドウでトンネルを継続的に実行する必要があります。

トンネルコマンドは、ホストコンピューターからロードバランサーとして Knative イングレスサービスにクラスタがアクセスできるようにするため必要です。

注記

トンネルプロセスを終了し、ネットワークルートをクリーンアップするには、`Ctrl-C` を入力します。`minikube tunnel` コマンドの詳細については、minikube のドキュメントを参照してください。
プラグインが完了したら、`knative` というクラスタがあることを確認します。
```
minikube profile list
```

次の手順¶

Knative のインストールが完了したので、このチュートリアルの次のトピックで最初の Knative サービスのデプロイ方法を学ぶことができます。