Releases: knative/client
Knative Client release v1.5.0
Meta
The compile dependencies have been updated to Knative Serving v1.5.0, Knative Eventing v1.5.0 (Go module versions are v0.32.0).
Enhancements for broker management
New flag options has been added to broker create
and broker update
commands:
Options:
--backoff-delay string The delay before retrying.
--backoff-policy string The retry backoff policy (linear, exponential).
--class string Broker class like 'MTChannelBasedBroker' or 'Kafka' (if available).
--dl-sink string The sink receiving event that could not be sent to a destination.
-n, --namespace string Specify the namespace to operate in.
--retry int32 The minimum number of retries the sender should attempt when sending an event before moving it to the dead letter sink.
--retry-after-max string An optional upper bound on the duration specified in a "Retry-After" header when calculating backoff times for retrying 429 and 503 response codes. Setting the value to zero ("PT0S") can be used to opt-out of respecting "Retry-After" header values altogether. This value only takes effect if "Retry" is configured, and also depends on specific implementations (Channels, Sources, etc.)
choosing to provide this capability.
--timeout string The timeout of each single request. The value must be greater than 0.
Released plugins
The plugins that are released in parallel and aligned with Knative v1.5.0 are:
- kn-plugin-admin for managing Knative installations that are running on Kubernetes | download
- kn-plugin-quickstart to quickly set up a local Knative environment from the command line. | download
- kn-plugin-source-kafka for managing a Kafka Source that has been installed via eventing-kafka on the backend | download
- kn-plugin-source-kamelet for managing Kamelet Sources that has been installed via Camel-K on the backend | download
- kn-plugin-event for creating and sending CloudEvents from insider or outside the cluster | download
All those plugins are released separately and are technically not part of this knative/client
release, they are aligned however to share the same Knative dependencies and can be targeted for inlining.
You can find the complete list of changes in the CHANGELOG.
Knative Client release v1.4.1
Meta
The compile dependencies have been updated to Knative Serving v1.4.0, Knative Eventing v1.4.0 (Go module versions are v0.31.0).
Enhancements for service management
Some new flags have been added to kn service create
, kn service update
and kn service apply
:
--timeout
for specifying the amount of time (in seconds) to wait for the application to respond to a request before returning with a timeout error. The value of this option sets the.spec.template.spec.timeoutSecond
field on the service. The server-side default is used if not provided, which is 300s by default.--pull-policy
for setting the imagePullPolicy for the application's image. Like for a pod's container, this can one ofAlways
,Never
,IfNotPresent
. The pull policy will be applied against the digest of the resolved image (Knative always resolves an image tag to a digest) and not the image tag.--wait-window
for setting the error window which allows intermediate errors while waiting for the ready status of a service. If not given, a default of 2 seconds is used (i.e. if an error state occurs but gets back to a success state within two seconds, thenkn
won't return an error but considers to be an expected fluctuation during the reconciliation process)--scale-metric
for setting theautoscaling.knative.dev/metric
annotation on a service that specifies the metric the autoscaler should scale on. Possible value areconcurrency
,cpu
,memory
andrps
.- Added subpath functionality to the
--mount
flag so that subdirectories of a volume can be mounted. For example,--mount /mydir=cm:myconfigmap/cmkey
will mount the value of keycmkey
in ConfigMapmyconfigmap
to a directory/mydir
within the services' application container.
Released plugins
The kn-plugin-event
plugin is now included since this release.
The plugins that are released in parallel and aligned with Knative v1.4.0 are:
- kn-plugin-admin for managing Knative installations that are running on Kubernetes | download
- kn-plugin-quickstart to quickly set up a local Knative environment from the command line. | download
- kn-plugin-source-kafka for managing a Kafka Source that has been installed via eventing-kafka on the backend | download
- kn-plugin-source-kamelet for managing Kamelet Sources that has been installed via Camel-K on the backend | download
- kn-plugin-event for creating and sending CloudEvents from insider or outside the cluster | download
All those plugins are released separately and are technically not part of this knative/client
release, they are aligned however to share the same Knative dependencies and can be targeted for inlining.
You can find the complete list of changes in the CHANGELOG.
Knative Client release v1.4.0
Meta
The compile dependencies have been updated to Knative Serving v1.4.0, Knative Eventing v1.4.0 (Go module versions are v0.31.0).
Enhancements for service management
Some new flags have been added to kn service create
, kn service update
and kn service apply
:
--timeout
for specifying the amount of time (in seconds) to wait for the application to respond to a request before returning with a timeout error. The value of this option sets the.spec.template.spec.timeoutSecond
field on the service. The server-side default is used if not provided, which is 300s by default.--pull-policy
for setting the imagePullPolicy for the application's image. Like for a pod's container, this can one ofAlways
,Never
,IfNotPresent
. The pull policy will be applied against the digest of the resolved image (Knative always resolves an image tag to a digest) and not the image tag.--wait-window
for setting the error window which allows intermediate errors while waiting for the ready status of a service. If not given, a default of 2 seconds is used (i.e. if an error state occurs but gets back to a success state within two seconds, thenkn
won't return an error but considers to be an expected fluctuation during the reconciliation process)--scale-metric
for setting theautoscaling.knative.dev/metric
annotation on a service that specifies the metric the autoscaler should scale on. Possible value areconcurrency
,cpu
,memory
andrps
.- Added subpath functionality to the
--mount
flag so that subdirectories of a volume can be mounted. For example,--mount /mydir=cm:myconfigmap/cmkey
will mount the value of keycmkey
in ConfigMapmyconfigmap
to a directory/mydir
within the services' application container.
Released plugins
The kn-plugin-event
plugin is now included since this release.
The plugins that are released in parallel and aligned with Knative v1.4.0 are:
- kn-plugin-admin for managing Knative installations that are running on Kubernetes | download
- kn-plugin-quickstart to quickly set up a local Knative environment from the command line. | download
- kn-plugin-source-kafka for managing a Kafka Source that has been installed via eventing-kafka on the backend | download
- kn-plugin-source-kamelet for managing Kamelet Sources that has been installed via Camel-K on the backend | download
- kn-plugin-event for creating and sending CloudEvents from insider or outside the cluster | download
All those plugins are released separately and are technically not part of this knative/client
release, they are aligned however to share the same Knative dependencies and can be targeted for inlining.
You can find the complete list of changes in the CHANGELOG.
Knative Client release v1.3.1
Meta
The compile dependencies have been updated to Knative Serving v1.3.0, Knative Eventing v1.3.0 (Go module versions are v0.30.0).
Auth provider plugins
All commonly supported auth provider plugins from Kubernetes client-go
are enable in this release. For further details see auth plugins.
Eventtype support
There's a new set of commands to provided management support for Eventtype
resources. For usage details and examples can be found in the documentation.
Released plugins
The kn-plugin-event
plugin is now included since this release.
The plugins that are released in parallel and aligned with Knative v1.3.0 are:
- kn-plugin-admin for managing Knative installations that are running on Kubernetes | download
- kn-plugin-quickstart to quickly set up a local Knative environment from the command line. | download
- kn-plugin-source-kafka for managing a Kafka Source that has been installed via eventing-kafka on the backend | download
- kn-plugin-source-kamelet for managing Kamelet Sources that has been installed via Camel-K on the backend | download
- kn-plugin-event for creating and sending CloudEvents from insider or outside the cluster | download
All those plugins are released separately and are technically not part of this knative/client
release, they are aligned however to share the same Knative dependencies and can be targeted for inlining.
You can find the complete list of changes in the CHANGELOG.
Knative Client release v1.3.0
Meta
The compile dependencies have been updated to Knative Serving v1.3.0, Knative Eventing v1.3.0 (Go module versions are v0.30.0).
Auth provider plugins
All commonly supported auth provider plugins from Kubernetes client-go
are enable in this release. For further details see auth plugins.
Eventtype support
There's a new set of commands to provided management support for Eventtype
resources. For usage details and examples can be found in the documentation.
Released plugins
The kn-plugin-event
plugin is now included since this release.
The plugins that are released in parallel and aligned with Knative v1.3.0 are:
- kn-plugin-admin for managing Knative installations that are running on Kubernetes | download
- kn-plugin-quickstart to quickly set up a local Knative environment from the command line. | download
- kn-plugin-source-kafka for managing a Kafka Source that has been installed via eventing-kafka on the backend | download
- kn-plugin-source-kamelet for managing Kamelet Sources that has been installed via Camel-K on the backend | download
- kn-plugin-event for creating and sending CloudEvents from insider or outside the cluster | download
All those plugins are released separately and are technically not part of this knative/client
release, they are aligned however to share the same Knative dependencies and can be targeted for inlining.
You can find the complete list of changes in the CHANGELOG.
Knative Client release v1.2.0
Meta
The compile dependencies have been updated to Knative Serving v1.2.0, Knative Eventing v1.2.0 (Go module versions are v0.29.0).
Improved Bash and Zsh completion
The support for Bash and Zsh completion on kn
commands has been greatly improved. It now supports completion on options and on context dependant data like service names.
Just add source <$(kn completion bash)
or source <$(kn completion zsh)
to your bash or zsh init script, respectively (it does not work when called interactively from the shell).
You will then automatically benefit from TAB-completions like in:
Released plugins
The kn-plugin-event
plugin is now included since this release.
The plugins that are released in parallel and aligned with Knative v1.1.0 are:
- kn-plugin-admin for managing Knative installations that are running on Kubernetes | download
- kn-plugin-quickstart to quickly set up a local Knative environment from the command line. | download
- kn-plugin-source-kafka for managing a Kafka Source that has been installed via eventing-kafka on the backend | download
- kn-plugin-source-kamelet for managing Kamelet Sources that has been installed via Camel-K on the backend | download
- kn-plugin-event for creating and sending CloudEvents from insider or outside the cluster | download
All those plugins are released separately and are technically not part of this knative/client
release, they are aligned however to share the same Knative dependencies and can be targeted for inlining.
You can find the complete list of changes in the CHANGELOG.
Knative Client release v1.1.0
Meta
The compile dependencies have been updated to Knative Serving v1.1.0, Knative Eventing v1.1.0 (Go module versions are v0.28.0).
Improved traffic split UI
The following improvements have been added for handling traffic splits of Knative Services:
- You can now specify a tag to the latest revision already when creating a service with
kn service create
. - You can underspecify the traffic targets and leave out one for which the traffic portion will be automatically calculated so that all legs add up to 100%.
- You can ommit the tag name when using
--traffic
. In this case@latest
will be used for the update.
# Create service and tag the latest revsion with `head`
kn service create random --image rhuss/random:1.0 --tag head
# Update service to next version and create a 10:90 traffic split
kn service update random --image rhuss/random:2.0 --traffic 10
Released plugins
The kn-plugin-event
plugin is now included since this release.
The plugins that are released in parallel and aligned with Knative v1.1.0 are:
- kn-plugin-admin for managing Knative installations that are running on Kubernetes | download
- kn-plugin-quickstart to quickly set up a local Knative environment from the command line. | download
- kn-plugin-source-kafka for managing a Kafka Source that has been installed via eventing-kafka on the backend | download
- kn-plugin-source-kamelet for managing Kamelet Sources that has been installed via Camel-K on the backend | download
- kn-plugin-event for creating and sending CloudEvents from insider or outside the cluster | download
All those plugins are released separately and are technically not part of this knative/client
release, they are aligned however to share the same Knative dependencies and can be targeted for inlining.
You can find the complete list of changes in the CHANGELOG.
Knative Client release v1.0.0
Meta
The compile dependencies have been updated to Knative Serving v1.0.0, Knative Eventing v1.0.0 (Go module versions are v0.27.0).
Deprecated options cleanup
Approaching the Knative 1.0.0 milestone several deprecated options were removed.
--limits-cpu
--limits-cpu
--request-memory
--request-cpu
--min-scale
--max-scale
--lookup-path
Released plugins
The kn-plugin-quickstart
plugin is now included since this release.
The plugins that are released in parallel and aligned with Knative v1.0.0 are:
- kn-plugin-admin for managing Knative installations that are running on Kubernetes | download
- kn-plugin-quickstart to quickly set up a local Knative environment from the command line. | download
- kn-plugin-source-kafka for managing a Kafka Source that has been installed via eventing-kafka on the backend | download
- kn-plugin-source-kamelet for managing Kamelet Sources that has been installed via Camel-K on the backend | download
All those plugins are released separately and are technically not part of this knative/client
release, they are aligned however to share the same Knative dependencies and can be targeted for inlining.
You can find the complete list of changes in the CHANGELOG.
Knative Client release v0.26.0
Meta
The compile dependencies have been updated to Knative Serving 0.26.0, Knative Eventing 0.26.0.
Environment variables from file
There's a new flag --env-file
that accepts provided file to populate environment variables. It simplify and shorten the resulting command for multiple environment variables entries at once. Accepted format of the file is KEY=VALUE
pair per line.
Released plugins
The kn-plugin-source-kamelet
plugin is now included since this release.
The plugins that are released in parallel and aligned with Knative 0.26 are:
- kn-plugin-admin for managing Knative installations that are running on Kubernetes | download
- kn-plugin-source-kafka for managing a Kafka Source that has been installed via eventing-kafka on the backend | download
- kn-plugin-source-kamelet for managing Kamelet Sources that has been installed via Camel-K on the backend | download
All those plugins are released separately and are technically not part of this knative/client
release, they are aligned however to share the same Knative dependencies and can be targeted for inlining.
You can find the complete list of changes in the CHANGELOG.
Knative Client release v0.25.1
Meta
The compile dependencies have been updated to Knative Serving 0.25.0, Knative Eventing 0.25.0 and Go version to 1.16.
Default plugin lookup in $PATH
The plugin lookup in $PATH
has been enabled by default. This changes should improve local plugin development and testing. Furthermore the end user installation experience of plugins though package managers like Homebrew
.
As a follow-up configuration property plugin.path-lookup
has been deprecated.
Darwin/arm64 support
The native support for Apple's ARM64 chips has been added. All the future release will be published with the corresponding native binary.
Multicontainer support (experimental)
There's been added a new command kn container add
to create Container
snippets. The add
command reuses all existing options flags manipulating Container
know from kn service create
.
In addition there's a new flag --extra-containers
available for kn service create|update|apply
that accepts YAML or JSON Containers
to pass them to a Knative Service.
The command is marked as experimental and may change in the future releases.
Example
The 'container add' represents utility command that prints YAML container spec to standard output. It's useful for
multi-container use cases to create definition with help of standard 'kn' option flags. It accepts all container related
flag available for 'service create'. The command can be chained through Unix pipes to create multiple containers at once.
# Add a container 'sidecar' from image 'docker.io/example/sidecar' and print it to standard output
kn container add sidecar --image docker.io/example/sidecar
# Add command can be chained by standard Unix pipe symbol '|' and passed to 'service create|update|apply' commands
kn container add sidecar --image docker.io/example/sidecar:first | \
kn container add second --image docker.io/example/sidecar:second | \
kn service create myksvc --image docker.io/example/my-app:latest --extra-containers -
You can find the complete list of changes in the CHANGELOG.