Getting Started

Installing Kusk

Homebrew

brew install kubeshop/kusk/kusk-gen

Latest release on Github

go install github.com/kubeshop/kusk-gen@$VERSION

If you don't want to build it yourself, the Releases page contains already built binaries for all supported platforms.

Download it and unpack kusk to the directory of you choice.

From source

git clone git@github.com:kubeshop/kusk-gen.git && \
cd kusk-gen && \
go install

Usage

For a run-through of what kusk-gen can do with the tools already installed in your cluster run: kusk-gen wizard -i my-openapi-spec.yaml

Or use one of our examples kusk-gen wizard -i examples/booksapp/booksapp.yaml

Usage:
  kusk-gen [command]

Available Commands:
  ambassador    Generates Ambassador Mappings for your service
  completion    generate the autocompletion script for the specified shell
  help          Help about any command
  linkerd       Generates Linkerd Service Profiles for your service
  ingress-nginx Generates ingress-nginx resources
  traefik       Generates Traefik resources
  wizard        Connects to current Kubernetes cluster and lists available generators

Flags:
  -h, --help   help for kusk

Use "kusk-gen [command] --help" for more information about a command.

For more comprehensive instructions on individual generators, please refer to the dedicated document in the docs folder for that generator.