kn-plugin-quickstart
is a plugin of the Knative Client, to enable users to quickly set up a local Knative environment from the command line.
Note: In order to use the quickstart
plugin, you must install the Kubernetes CLI kubectl
and either kind
or minikube
.
You can download the latest binaries from the Releases page.
There are two ways to run kn quickstart
:
- You can run it standalone, just put it on your system path and make sure it is executable.
- You can install it as a plugin of the
kn
client to run:- Follow the documentation to install
kn client
if you don't have it - Copy the
kn-quickstart
binary to a directory on yourPATH
(for example,/usr/local/bin
) and make sure its filename iskn-quickstart
- Run
kn plugin list
to verify that thekn-quickstart
plugin is installed successfully
- Follow the documentation to install
After the plugin is installed, you can use kn quickstart
to run its related subcommands.
Get up and running with a local Knative environment
Usage:
kn-quickstart [command]
Available Commands:
completion generate the autocompletion script for the specified shell
help Help about any command
kind Quickstart with Kind
minikube Quickstart with Minikube
version Prints the plugin version
Flags:
-h, --help help for kn-quickstart
Use "kn-quickstart [command] --help" for more information about a command.
Set up a local Knative cluster using KinD:
kn quickstart kind
Kind can be configured with a local container image registry by passing the --registry
flag:
kn quickstart kind --registry
Note: we automatically configure tag resolution for the local registry when this flag is passed
Set up a local Knative cluster using Minikube:
kn quickstart minikube
Note: for Windows/Mac users, after the above command completes, you will need to run the following in a separate terminal window:
minikube tunnel --profile minikube-knative
You must set up your development environment before you build kn-plugin-quickstart
.
Once you've set up your development environment, you can build the plugin by running the following commands:
git clone git@github.com:knative-sandbox/kn-plugin-quickstart.git
cd kn-plugin-quickstart
./hack/build.sh
You can grab the latest nightly binary executable for:
Add the binary to the system PATH and ensure that it is executable.