Knative developer experience, docs, reference Knative CLI implementation
Go to file
knative-automation ccf721f8b0
upgrade to latest dependencies (#1302)
bumping knative.dev/serving 101c6f1...2d4e4a1:
  > 2d4e4a1 Make digest resolution idempotent (# 11293)
  > dd0e497 Update go-containerregistry to v0.5.0 (# 11292)
  > dd4e1cb Increase digest resolution rate limit (# 11279)
  > 91d511c Update net-kourier nightly (# 11301)
  > 28e53cb Update net-contour nightly (# 11302)
  > 69214d4 Update net-istio nightly (# 11300)
  > ad94366 Change magic DNS to sslip.io (# 11298)
  > c2f3fda Make sure the decider state is settled in test (# 11290)
  > 695b9e7 Update net-contour nightly (# 11288)
  > aa2ef62 Update net-istio nightly (# 11287)
  > f9abb7f Update net-certmanager nightly (# 11282)
  > e2a8237 e2e - drop imperative bash yaml for declarative ytt/kapp (# 11175)
  > e04223b remove duplicate additionalPrinterColumns (# 11285)
  > 08d17a2 Make KO_FLAG flexible for e2e-tests (# 11284)
  > 5ad9c8e Implement per-item rate limits for digest resolution (# 11278)
bumping knative.dev/eventing 8db3bcf...768b7d1:
  > 768b7d1 ApiServerSource smoke tests (# 5346)
  > 7ae9d3e Increase defaulting test coverage for apis/config and apis/messaging/config (# 5344)
  > 8a094e6 Check SCALE_CHAOSDUCK_TO_ZERO after the chaosduck is deployed (# 5330)
  > e7237ee Trigger defaulting webhook tests (# 5339)
  > 88fc2e2 More containersource e2es (# 5338)
  > 3888d16 [v1] Test to make sure webhook validates ApiServerSource (# 5329)
  > a5db0e1 Add containersource smoke test (# 5331)
  > 0278f6e Format markdown (# 5326)
  > 462f1f3 Pointing to the proper v1 api, as the copy (# 5328)

Signed-off-by: Knative Automation <automation@knative.team>
2021-05-05 14:21:09 -07:00
.github Update common github actions (#1268) 2021-03-31 00:43:22 -07:00
cmd/kn Enable errorlint and fix all issues (#1223) 2021-02-12 18:27:38 -08:00
config Use ko's strict mode for better errors messages (#706) 2020-03-07 12:11:27 -08:00
conventions Fix various misspellings and linter items (#1057) 2020-10-12 21:24:30 -07:00
docs chore: fixed documentation of configuration options in README (#1297) 2021-05-04 07:18:38 -07:00
hack Drop --strict flag on ko (#1295) 2021-04-26 17:46:39 -07:00
lib Upgrade Eventing API from v1beta1 to v1 (#1284) 2021-04-08 07:42:51 -07:00
pkg Update Eventing Sources API to v1 (#1299) 2021-05-03 03:12:58 -07:00
test Update Eventing Sources API to v1 (#1299) 2021-05-03 03:12:58 -07:00
third_party/VENDOR-LICENSE Upgrade Eventing API from v1beta1 to v1 (#1284) 2021-04-08 07:42:51 -07:00
tools/knb feat: Add knb plugin build tool (#1226) 2021-03-08 00:22:21 -08:00
vendor upgrade to latest dependencies (#1302) 2021-05-05 14:21:09 -07:00
.gitignore feat: Add knb plugin build tool (#1226) 2021-03-08 00:22:21 -08:00
.golangci.yaml Enable gosec linter and fix existing issues (#1228) 2021-02-16 02:17:26 -08:00
.ko.yaml build test images for e2e (#974) 2020-08-20 04:42:13 -07:00
CHANGELOG.adoc Fix service/revision list output with '-o' param (#1276) 2021-04-13 07:53:00 -07:00
LICENSE Initial commit 2018-12-12 16:45:51 -08:00
OWNERS Update OWNERS_ALIASES to match autogen in community (#1277) 2021-04-01 09:30:23 -07:00
OWNERS_ALIASES Update knative/community files (#1290) 2021-04-20 04:57:36 -07:00
README.md Drop master references to knative repos (#1254) 2021-03-09 03:42:25 -08:00
go.mod upgrade to latest dependencies (#1302) 2021-05-05 14:21:09 -07:00
go.sum upgrade to latest dependencies (#1302) 2021-05-05 14:21:09 -07:00

README.md

Kn

go.dev reference Go Report Card Releases LICENSE Slack Status

The Knative client kn is your door to the Knative world. It allows you to create Knative resources interactively from the command line or from within scripts.

kn offers you:

  • Full support for managing all features of Knative Serving (services, revisions, traffic splits)
  • Growing support for Knative eventing, closely following its development (managing of sources & triggers)
  • A plugin architecture similar to that of kubectl plugins
  • A thin client-specific API in golang which helps with tasks like synchronously waiting on Knative service write operations.
  • An easy integration of Knative into Tekton Pipelines by using kn in a Tekton Task.

This client uses the Knative Serving and Knative Eventing APIs exclusively so that it will work with any Knative installation, even those that are not Kubernetes based. It does not help with installing Knative itself though. Please refer to the various Knative installation options for how to install Knative with its prerequisites.

Documentation

Start with the user's guide to learn more. You can read about common use cases, get detailed documentation on each command, and learn how to extend the kn CLI. For more information, have a look at:

  • User guide
    • Installation - How to install kn and run on your machine
    • Examples - Use case based examples
    • FAQ (to come.)
  • Reference Manual - all possible commands and options with usage examples

Developers

We love contributions! Please refer to CONTRIBUTING for more information on how to best contributed to contribute to Knative.

For code contributions it as easy as picking an issue (look out for "kind/good-first-issue"), briefly comment that you would like to work on it, code, test, code and finally submit a PR which will trigger the review process.

More details on how to build and test can be found in the Developer guide.