Knative developer experience, docs, reference Knative CLI implementation
Go to file
Knative Automation 8216e64a8b
upgrade to latest dependencies (#2003)
bumping knative.dev/pkg fd105c6...19d3cc2:
  > 19d3cc2 upgrade to latest dependencies (# 3218)
  > a4cc1bd drop dependency on metrics package (# 3215)
  > d3550d4 Update community files (# 3214)
  > ab9aaa0 also add json keys to the top level config (# 3213)
  > 264afa3 add json struct tags to the observability configs (# 3212)
  > 3eb1089 [webhook] enrich webhook traces (# 3209)
  > 16de760 split off pprof server that accepts a configmap (# 3210)
  > ff153ad [controller/observability] adjust metrics reporting for the two lane queue (# 3206)
  > fdc3131 pass options to the TracerProvider constructor (# 3208)
  > d601f66 allow for stdout exporter for tracing - to allow for debugging (# 3207)
  > e959f44 [controller] OTel instrumentation (# 3201)
  > f478764 [webhook] OTel changes (# 3189)
  > 7a5377f Drop OpenCensus use in various test packages (# 3202)
  > 9f3f014 wire zap into the client-go logger (# 3205)
  > 9435aa6 [observability/resource] fix service name calculation (# 3204)
  > 68cdb02 shutdown must be called explicitly since pprof listen is part of the errgroup (# 3203)
  > 13b2dc9 [observability] Default missing endpoint scheme to HTTPS (# 3200)
  > 434d221 When shutting down the OTel providers have a ten second timeout. (# 3199)
  > 8481e7e parse the endpoint as a URL to allow paths (# 3197)
  > 7681e80 handle no views in the context (# 3196)
  > 5abfb10 [injection/sharedmain] OTel Support (# 3190)
  > 5e2512c New observability package (# 3188)
  > 4ec554b Bump sigs.k8s.io/yaml from 1.4.0 to 1.5.0 (# 3194)
  > 0285e29 group otel updates (# 3193)
  > fe85a65 drop unused functions in webhook testing (# 3191)
bumping golang.org/x/oauth2 0042180...cf14319:
  > cf14319 oauth2: fix expiration time window check
  > 32d34ef internal: include clientID in auth style cache key
  > 2d34e30 oauth2: replace a magic number with AuthStyleUnknown
  > 696f7b3 all: modernize with doc links and any
  > 471209b oauth2: drop dependency on go-cmp
  > 6968da2 oauth2: sync Token.ExpiresIn from internal Token
  > d2c4e0a oauth2: context instead of golang.org/x/net/context in doc
  > 883dc3c endpoints: add various endpoints from stale CLs
  > 1c06e87 all: make use of oauth.Token.ExpiresIn
  > 65c15a3 oauth2: remove extra period
  > ce56909 jws: improve fix for CVE-2025-22868
bumping knative.dev/networking f950c0c...edb1a4a:
  > edb1a4a upgrade to latest dependencies (# 1072)
  > f8c9238 Update community files (# 1071)
  > 14e7b48 upgrade to latest dependencies (# 1070)
  > efc53e4 upgrade to latest dependencies (# 1069)
bumping google.golang.org/genproto/googleapis/rpc b45e905...513f239:
  > 513f239 chore(all): update all (# 1221)
  > 200df99 chore(all): update all (# 1220)
  > 55703ea chore(all): update all (# 1219)
  > 5a2f75b chore(all): auto-regenerate .pb.go files (# 1217)
  > fcd927c chore(all): update all (# 1218)
  > f936aa4 chore(all): auto-regenerate .pb.go files (# 1214)
  > 80320d0 chore(all): update all (# 1215)
  > c3e32d0 feat(googleapis/devtools/clouddebugger/v2): remove googleapis/devtools/clouddebugger (# 1216)
  > 10db94c chore(all): update all (# 1213)
  > 7b38467 chore(all): auto-regenerate .pb.go files (# 1212)
  > 2d3770c chore(all): auto-regenerate .pb.go files (# 1208)
  > 61c742a chore(all): update all (# 1211)
  > 207652e chore(all): update all (# 1209)
  > de1ac95 chore(all): auto-regenerate .pb.go files (# 1207)
  > ac9807e chore(all): update all to ee84b53 (# 1206)
  > ee84b53 chore(all): update all (# 1205)
bumping knative.dev/serving 7f0a07a...bf962e6:
  > bf962e6 [otel] instrument the autoscaler (# 15963)
  > 471aa0d Update net-gateway-api nightly (# 15968)
  > 7144b0d Update net-kourier nightly (# 15954)
  > c65e780 upgrade to latest dependencies (# 15967)
  > 20fc217 Update net-istio nightly (# 15965)
  > ac5c50c drop use of heavy profiling package (# 15964)
  > 6dff362 [otel] instrumentation of the queue-proxy (# 15961)
  > c4b7c40 [otel] Switch Activator over to OTel instrumentation (# 15960)
  > dc00349 Update net-gateway-api nightly (# 15952)
  > 3424b8c use new observability config instead of knative.dev/pkg/metrics (# 15959)
  > e0bedf1 [otel] Reconcile new observability config onto the queue-proxy container (# 15958)
  > f6e667d remove unused imports (# 15957)
  > aad48fe Introduce new Serving OTel config (# 15956)
  > d73a1c0 Update net-contour nightly (# 15953)
  > 080f4b3 Update net-istio nightly (# 15955)
  > 21432a4 Update community files (# 15951)
  > 2c9bd10 upgrade to latest dependencies (# 15950)
  > a304c2f [main] Upgrade to latest dependencies (# 15948)
  > a329e36 Bump chainguard-dev/actions in the github-actions group (# 15947)
  > d71567d upgrade to latest dependencies (# 15941)
  > 667a470 Update net-contour nightly (# 15945)
  > aa58baf Update net-gateway-api nightly (# 15943)
  > a56b816 Update net-istio nightly (# 15944)
  > 663bb6a upgrade to latest dependencies (# 15939)
  > ec61251 Fix roundToNDigits to use Round instead of Floor (# 15940)
  > 1e8a4b7 upgrade to latest dependencies (# 15938)
  > cada0f4 Update net-kourier nightly (# 15933)
  > 29e580b bump cert-manager, istio, contour (# 15928)
  > 9d3fe30 Update net-contour nightly (# 15932)
bumping knative.dev/eventing 9d89558...c9821a9:
  > c9821a9 feat: instrument auth verifier with OTel (# 8641)
  > fd509a9 feat: instrument jobsink with otel (# 8639)
  > bedd48f feat: migrate kncloudevents, broker filter, broker ingress, inmemorychannel dispatcher to otel (# 8635)
  > c2e78b4 [Automated] Update eventing-eventing-integrations nightly (# 8636)
  > 6e5cb3a feat: add new otel config (# 8624)
  > 351613b [main] Upgrade to latest dependencies (# 8625)
  > 50d5a26 Fix deps upgrade (# 8620)
  > 1840f7a [Automated] Update eventing-eventing-integrations nightly (# 8623)
  > 75874ab [main] Update community files (# 8621)
  > 1a736e1 Update deps for K8s 1.33 (# 8602)
  > 5bcf801  test: multiple nested filters of the same type should work (# 8610)
  > 7f047f9 feat: add request reply cesql function (# 8608)
  > 5de389b feat: support for additional pod scheduling definition on IntegrationSource (# 8601)
  > a582a88 Bump github.com/go-jose/go-jose/v3 from 3.0.3 to 3.0.4 (# 8605)
  > e25bccd feat: add package to set and verify correlation/reply ids for RequestReply (# 8606)
  > d56ee68 Adding addressable duck on crd (# 8603)
bumping knative.dev/hack f525e18...70d4b00:
  > 70d4b00 Update community files (# 425)
bumping github.com/go-logr/logr 1205f42...38a1c47:
  > 38a1c47 build(deps): bump github/codeql-action from 3.28.17 to 3.28.18
  > f08bedd build(deps): bump actions/setup-go from 5.4.0 to 5.5.0
  > 6295e99 build(deps): bump golangci/golangci-lint-action from 7.0.0 to 8.0.0
  > 028840d build(deps): bump github/codeql-action from 3.28.15 to 3.28.17
  > 511e5fa Merge pull request # 367 from go-logr/dependabot/github_actions/github/codeql-action-3.28.15
  > 158c311 Merge pull request # 366 from thockin/master
  > d806463 build(deps): bump github/codeql-action from 3.28.13 to 3.28.15
  > 20a64ba build(deps): bump github/codeql-action from 3.28.12 to 3.28.13
  > c79ddb3 Update to support golangci-lint v2
  > 0385e14 Add comments around slog exceptions
  > 8fd86d2 Revert "Remove one exception from Slog testing"
  > 22d21f0 Update github actions
  > 1e06d3d Remove one exception from Slog testing
  > c439f61 Fix slog tests for 1.25
  > fd59c10 Merge pull request # 359 from go-logr/dependabot/github_actions/actions/upload-artifact-4.6.2
  > 50c533c Merge pull request # 358 from go-logr/dependabot/github_actions/github/codeql-action-3.28.12
  > 2b467c4 build(deps): bump actions/upload-artifact from 4.6.1 to 4.6.2
  > 8476b37 Merge pull request # 357 from go-logr/dependabot/github_actions/golangci/golangci-lint-action-6.5.2
  > 9a1211d build(deps): bump github/codeql-action from 3.28.11 to 3.28.12
  > eec33c4 build(deps): bump golangci/golangci-lint-action from 6.5.0 to 6.5.1
  > 8de8c51 Merge pull request # 356 from go-logr/dependabot/github_actions/actions/setup-go-5.4.0
  > 140789c build(deps): bump golangci/golangci-lint-action from 6.5.1 to 6.5.2
  > 525d37c Merge pull request # 354 from go-logr/dependabot/github_actions/github/codeql-action-3.28.11
  > 207008c build(deps): bump actions/setup-go from 5.3.0 to 5.4.0
  > 95b588a Merge pull request # 352 from go-logr/dependabot/github_actions/github/codeql-action-3.28.10
  > f597e8b build(deps): bump github/codeql-action from 3.28.10 to 3.28.11
  > 1c2d47a Merge pull request # 351 from go-logr/dependabot/github_actions/ossf/scorecard-action-2.4.1
  > 18c61bc build(deps): bump github/codeql-action from 3.28.9 to 3.28.10
  > 7805e15 Merge pull request # 353 from go-logr/dependabot/github_actions/actions/upload-artifact-4.6.1
  > e374c47 build(deps): bump ossf/scorecard-action from 2.4.0 to 2.4.1
  > 4af26d9 build(deps): bump golangci/golangci-lint-action from 6.3.1 to 6.5.0
  > 80045e5 build(deps): bump actions/upload-artifact from 4.6.0 to 4.6.1
  > 1a48fc0 build(deps): bump golangci/golangci-lint-action from 6.2.0 to 6.3.1
  > 743e080 build(deps): bump github/codeql-action from 3.28.8 to 3.28.9
  > cfd110a build(deps): bump github/codeql-action from 3.28.5 to 3.28.8
  > 6a2281a Merge pull request # 346 from go-logr/dependabot/github_actions/actions/setup-go-5.3.0
  > ccd6555 Merge pull request # 345 from go-logr/dependabot/github_actions/github/codeql-action-3.28.5
  > e2e4b0e build(deps): bump actions/setup-go from 5.2.0 to 5.3.0
  > c233155 Merge pull request # 344 from go-logr/dependabot/github_actions/golangci/golangci-lint-action-6.2.0
  > 677a7c2 build(deps): bump github/codeql-action from 3.28.1 to 3.28.5
  > b8ba189 Merge pull request # 343 from go-logr/dependabot/github_actions/actions/upload-artifact-4.6.0
  > 96397cb build(deps): bump golangci/golangci-lint-action from 6.1.1 to 6.2.0
  > 7fb2590 Merge pull request # 342 from go-logr/dependabot/github_actions/github/codeql-action-3.28.1
  > 0a1e3b8 build(deps): bump actions/upload-artifact from 4.4.3 to 4.6.0
  > 1cb5846 build(deps): bump github/codeql-action from 3.27.9 to 3.28.0
  > 08afa36 build(deps): bump github/codeql-action from 3.28.0 to 3.28.1
  > 28c3e59 Merge pull request # 339 from go-logr/dependabot/github_actions/github/codeql-action-3.27.9
  > e0b26f2 Merge pull request # 338 from go-logr/dependabot/github_actions/actions/setup-go-5.2.0
  > d860f7f build(deps): bump github/codeql-action from 3.27.6 to 3.27.9
  > 8849d8d build(deps): bump github/codeql-action from 3.27.5 to 3.27.6
  > 1210f7d build(deps): bump actions/setup-go from 5.1.0 to 5.2.0
  > a64db0b Merge pull request # 334 from go-logr/dependabot/github_actions/github/codeql-action-3.27.5
  > 5342602 build(deps): bump github/codeql-action from 3.27.0 to 3.27.4
  > cf0063c build(deps): bump github/codeql-action from 3.27.4 to 3.27.5
  > f151316 Merge pull request # 330 from go-logr/dependabot/github_actions/actions/checkout-4.2.2
  > e072c1a Merge pull request # 331 from go-logr/dependabot/github_actions/github/codeql-action-3.27.0
  > 35ea6fd build(deps): bump actions/checkout from 4.2.1 to 4.2.2
  > ddf199b Merge pull request # 329 from go-logr/dependabot/github_actions/actions/setup-go-5.1.0
  > afe9b4a build(deps): bump github/codeql-action from 3.26.13 to 3.27.0
  > 1ce1e2e build(deps): bump github/codeql-action from 3.26.12 to 3.26.13
  > c5df16e build(deps): bump actions/setup-go from 5.0.2 to 5.1.0
  > 8d6912c build(deps): bump actions/upload-artifact from 4.4.0 to 4.4.3
  > 8d9adce build(deps): bump github/codeql-action from 3.26.11 to 3.26.12
  > 6f2dcb8 build(deps): bump actions/checkout from 4.2.0 to 4.2.1
  > 5d59669 GitHub: bump Go version used for apidiff
  > 685f8d1 Merge pull request # 323 from go-logr/dependabot/github_actions/github/codeql-action-3.26.11
  > 1108ded Merge pull request # 322 from go-logr/dependabot/github_actions/golangci/golangci-lint-action-6.1.1
  > 85e5c25 build(deps): bump github/codeql-action from 3.26.9 to 3.26.11
  > a3fdc92 build(deps): bump actions/checkout from 4.1.7 to 4.2.0
  > 5014e65 build(deps): bump golangci/golangci-lint-action from 6.1.0 to 6.1.1
  > 8c14043 build(deps): bump github/codeql-action from 3.26.8 to 3.26.9
  > bb9f20d Merge pull request # 319 from go-logr/dependabot/github_actions/github/codeql-action-3.26.8
  > e2720e1 build(deps): bump github/codeql-action from 3.26.6 to 3.26.7
  > 98f267c build(deps): bump github/codeql-action from 3.26.7 to 3.26.8
  > 275154a Merge pull request # 317 from go-logr/dependabot/github_actions/github/codeql-action-3.26.6
  > abec0d5 Merge pull request # 316 from go-logr/dependabot/github_actions/actions/upload-artifact-4.4.0
  > 3bf2a10 build(deps): bump github/codeql-action from 3.26.5 to 3.26.6
  > 14f036d Merge pull request # 315 from go-logr/dependabot/github_actions/github/codeql-action-3.26.5
  > 35ef369 build(deps): bump actions/upload-artifact from 4.3.6 to 4.4.0
  > 4743538 Merge pull request # 314 from go-logr/dependabot/github_actions/github/codeql-action-3.26.2
  > dd81768 build(deps): bump github/codeql-action from 3.26.2 to 3.26.5
  > 1033a72 build(deps): bump golangci/golangci-lint-action from 6.0.1 to 6.1.0
  > edcd2be build(deps): bump github/codeql-action from 3.26.0 to 3.26.2
  > 79c4c21 build(deps): bump github/codeql-action from 3.25.15 to 3.26.0
  > d95a0df build(deps): bump actions/upload-artifact from 4.3.4 to 4.3.6
  > a340533 Merge pull request # 309 from thockin/master
  > 90d9f9d build(deps): bump github/codeql-action from 3.25.13 to 3.25.15
  > 0103ab5 Silence spurious lint warnings
  > 6386269 build(deps): bump ossf/scorecard-action from 2.3.3 to 2.4.0
  > 26eb1a2 build(deps): bump github/codeql-action from 3.25.12 to 3.25.13
  > 781996a build(deps): bump actions/setup-go from 5.0.1 to 5.0.2
  > 76dab72 build(deps): bump github/codeql-action from 3.25.11 to 3.25.12
  > 2110dbe Merge pull request # 302 from go-logr/dependabot/github_actions/actions/upload-artifact-4.3.4
  > c65c5f6 Merge pull request # 301 from go-logr/dependabot/github_actions/github/codeql-action-3.25.11
  > e04bf87 build(deps): bump actions/upload-artifact from 4.3.3 to 4.3.4
  > eb84a8c Merge pull request # 300 from go-logr/dependabot/github_actions/actions/checkout-4.1.7
  > cd5acd5 build(deps): bump github/codeql-action from 3.25.10 to 3.25.11
  > d69364f Merge pull request # 299 from go-logr/dependabot/github_actions/github/codeql-action-3.25.10
  > cdbf6fb build(deps): bump actions/checkout from 4.1.6 to 4.1.7
  > 8ce0cab Merge pull request # 298 from go-logr/dependabot/github_actions/github/codeql-action-3.25.8
  > 6b90080 build(deps): bump github/codeql-action from 3.25.8 to 3.25.10
  > 375c22d Merge pull request # 297 from go-logr/dependabot/github_actions/github/codeql-action-3.25.7
  > a9e97bc build(deps): bump github/codeql-action from 3.25.7 to 3.25.8
  > 976cd73 Merge pull request # 296 from go-logr/dependabot/github_actions/github/codeql-action-3.25.6
  > 2bb10dc build(deps): bump github/codeql-action from 3.25.6 to 3.25.7
  > e99951c build(deps): bump github/codeql-action from 3.25.5 to 3.25.6
bumping sigs.k8s.io/yaml c3772b5...0f318dc:
  > 0f318dc Merge pull request # 134 from kubernetes-sigs/forgot-to-add-redirects-for-constants
  > 8eaa802 Merge pull request # 133 from kubernetes-sigs/deprecate-code-in-goyaml.v3-goyaml.v2-and-redirect
  > b8fc0c0 Forgot to add redirects for v3 constants
  > 0fe7da3 Merge pull request # 125 from kragniz/go-1.24
  > 69e45c1 Deprecate code in goyaml.v2/goyaml.v3 directories and redirect
  > c6ac2c9 Merge pull request # 126 from kragniz/remove-travis
  > 14cbb88 Test against go 1.24.x
  > b9a9b1c Merge pull request # 106 from ThatsMrTalbot/patch-1
  > 203ded9 Remove old travisci config file
  > 56d6720 Merge pull request # 122 from liggitt/unhashable-key
  > 4c6913f fix: wrap errors returned by JSON unmarshal
  > 119290a Merge pull request # 118 from skitt/drop-go1.10-build
  > 63d028e Handle unhashable keys during merge
  > 50e7f43 Merge pull request # 119 from skitt/test-go-1.21
  > ea138a0 Merge Go 1.10+ files
  > 9934139 Test with Go 1.21 and later

Signed-off-by: Knative Automation <automation@knative.team>
2025-07-17 15:49:02 +00:00
.github Remove release notes template in favor of global one (#1957) 2024-07-18 09:36:13 +00:00
cmd/kn Fold in knative.dev/client-pkg as a submodule (#1953) 2024-09-03 13:49:11 +00:00
config
conventions
docs 💝 Extract reusable part of sink flag (#1968) 2024-09-25 10:46:31 +00:00
hack Add target platform flag to build script (#1981) 2024-11-28 15:51:43 +00:00
pkg upgrade to latest dependencies (#2003) 2025-07-17 15:49:02 +00:00
test Fold in knative.dev/client-pkg as a submodule (#1953) 2024-09-03 13:49:11 +00:00
tools/knb Fold in knative.dev/client-pkg as a submodule (#1953) 2024-09-03 13:49:11 +00:00
.codecov.yaml Remove vendor dir (#1962) 2024-08-29 13:57:18 +00:00
.gitignore
.golangci.yaml [main] Upgrade to latest dependencies (#1997) 2025-04-23 18:43:23 +00:00
.ko.yaml
CHANGELOG.adoc
CODE-OF-CONDUCT.md
CONTRIBUTING.md
DEVELOPMENT.md Update broken links on `client/DEVELOPMENT.md` (#2005) 2025-07-02 18:45:54 +00:00
LICENSE
OWNERS
OWNERS_ALIASES Update community files (#2006) 2025-07-08 01:46:51 +00:00
README.md add clotributor to readme (#1899) 2023-11-28 10:03:23 +00:00
SECURITY.md Add consistent SECURITY.md (#1897) 2023-11-20 18:02:58 +00:00
go.mod upgrade to latest dependencies (#2003) 2025-07-17 15:49:02 +00:00
go.sum upgrade to latest dependencies (#2003) 2025-07-17 15:49:02 +00:00
go.work [main] Upgrade to latest dependencies (#1997) 2025-04-23 18:43:23 +00:00
go.work.sum upgrade to latest dependencies (#2003) 2025-07-17 15:49:02 +00:00

README.md

Kn

go.dev reference Go Report Card Releases LICENSE Slack Status codecov

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

Refer to 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.

Following are some useful resources for getting-started using kn CLI:

Additionally you can visit knative.dev for more examples.

Developers

If you are interested in contributing, see CONTRIBUTING.md and DEVELOPMENT.md. For a list of help wanted issues in Knative, check out CLOTRIBUTOR