Skip to content

Commit be01b72

Browse files
abrennan89abrennan89
authored
Merge pull request #40821 from rh-max/srvls-release-notes-1.20
SRVCOM-1575: Add Serverless 1.20.0 release notes
2 parents e05a4d6 + 6781a85 commit be01b72

File tree

4 files changed

+181
-1
lines changed

4 files changed

+181
-1
lines changed

‎modules/serverless-deprecated-removed-features.adoc‎

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
[id="serverless-deprecated-removed-features_{context}"]
2+
= Deprecated and removed features
3+
4+
Some features available in previous releases have been deprecated or removed.
5+
6+
Deprecated functionality is still included in {ServerlessProductName} and continues to be supported; however, it will be removed in a future release of this product and is not recommended for new deployments. For the most recent list of major functionality deprecated and removed within {ServerlessProductName}, refer to the table below.
7+
8+
In the table, features are marked with the following statuses:
9+
10+
* *-*: _Not yet available_
11+
* *TP*: _Technology Preview_
12+
* *GA*: _General Availability_
13+
* *DEP*: _Deprecated_
14+
* *REM*: _Removed_
15+
16+
.Deprecated and removed features tracker
17+
[cols="3,1,1,1",options="header"]
18+
|====
19+
|Feature |1.18|1.19|1.20
20+
21+
|`kn func emit` (`kn func invoke` in 1.21+)
22+
|TP
23+
|TP
24+
|TP
25+
26+
|mTLS
27+
|GA
28+
|GA
29+
|GA
30+
31+
|`kn func` TypeScript templates
32+
|TP
33+
|TP
34+
|TP
35+
36+
|`kn func` Rust templates
37+
|TP
38+
|TP
39+
|TP
40+
41+
|`emptyDir` volumes
42+
|GA
43+
|GA
44+
|GA
45+
46+
|`KafkaBinding` API
47+
|GA
48+
|DEP
49+
|DEP
50+
51+
|HTTPS redirection
52+
|-
53+
|GA
54+
|GA
55+
56+
|Kafka broker
57+
|-
58+
|-
59+
|TP
60+
61+
|====

‎modules/serverless-rn-1-20-0.adoc‎

Lines changed: 117 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,117 @@
1+
// Module included in the following assemblies
2+
//
3+
// * /serverless/serverless-release-notes.adoc
4+
5+
[id="serverless-rn-1-20-0_{context}"]
6+
= Release Notes for Red Hat {ServerlessProductName} 1.20.0
7+
8+
{ServerlessProductName} 1.20.0 is now available. New features, changes, and known issues that pertain to {ServerlessProductName} on {product-title} are included in this topic.
9+
10+
[id="new-features-1-20-0_{context}"]
11+
== New features
12+
13+
* {ServerlessProductName} now uses Knative Serving 0.26.
14+
* {ServerlessProductName} now uses Knative Eventing 0.26.
15+
* {ServerlessProductName} now uses Kourier 0.26.
16+
* {ServerlessProductName} now uses Knative `kn` CLI 0.26.
17+
* {ServerlessProductName} now uses Knative Kafka 0.26.
18+
* The `kn func` CLI plug-in now uses `func` 0.20.
19+
20+
* The Kafka broker is now available as a Technology Preview.
21+
* The `kn event` plug-in is now available as a Technology Preview.
22+
23+
[id="known-issues-1-20-0_{context}"]
24+
== Known issues
25+
26+
* {ServerlessProductName} deploys Knative services with a default address that uses HTTPS. When sending an event to a resource inside the cluster, the sender does not have the cluster certificate authority (CA) configured. This causes event delivery to fail, unless the cluster uses globally accepted certificates.
27+
+
28+
For example, an event delivery to a publicly accessible address works:
29+
+
30+
[source,terminal]
31+
----
32+
$ kn event send --to-url https://ce-api.foo.example.com/
33+
----
34+
+
35+
On the other hand, this delivery fails if the service uses a public address with an HTTPS certificate issued by a custom CA:
36+
+
37+
[source,terminal]
38+
----
39+
$ kn event send --to Service:serving.knative.dev/v1:event-display
40+
----
41+
+
42+
Sending an event to other addressable objects, such as brokers or channels, is not affected by this issue and works as expected.
43+
44+
* The Kafka broker currently does not work on a cluster with Federal Information Processing Standards (FIPS) mode enabled.
45+
46+
* If you create a Springboot function project directory with the `kn func create` command, subsequent running of the `kn func build` command fails with this error message:
47+
+
48+
[source,terminal]
49+
----
50+
[analyzer] no stack metadata found at path ''
51+
[analyzer] ERROR: failed to : set API for buildpack 'paketo-buildpacks/[email protected]': buildpack API version '0.7' is incompatible with the lifecycle
52+
----
53+
+
54+
As a workaround, you can change the `builder` property to `gcr.io/paketo-buildpacks/builder:base` in the function configuration file `func.yaml`.
55+
56+
* Deploying a function using the `gcr.io` registry fails with this error message:
57+
+
58+
[source,terminal]
59+
----
60+
Error: failed to get credentials: failed to verify credentials: status code: 404
61+
----
62+
+
63+
As a workaround, use a different registry than `gcr.io`, such as `quay.io` or `docker.io`.
64+
65+
* TypeScript functions created with the `http` template fail to deploy on the cluster.
66+
+
67+
As a workaround, in the `func.yaml` file, replace the following section:
68+
+
69+
[source,terminal]
70+
----
71+
buildEnvs: []
72+
----
73+
+
74+
with this:
75+
+
76+
[source,terminal]
77+
----
78+
buildEnvs:
79+
- name: BP_NODE_RUN_SCRIPTS
80+
value: build
81+
----
82+
83+
* In `func` version 0.20, some runtimes might be unable to build a function by using podman. You might see an error message similar to the following:
84+
+
85+
[source,terminal]
86+
----
87+
ERROR: failed to image: error during connect: Get "http://%2Fvar%2Frun%2Fdocker.sock/v1.40/info": EOF
88+
----
89+
+
90+
** The following workaround exists for this issue:
91+
92+
.. Update the podman service by adding `--time=0` to the service `ExecStart` definition:
93+
+
94+
.Example service configuration
95+
[source,terminal]
96+
----
97+
ExecStart=/usr/bin/podman $LOGGING system service --time=0
98+
----
99+
.. Restart the podman service by running the following commands:
100+
+
101+
[source,terminal]
102+
----
103+
$ systemctl --user daemon-reload
104+
----
105+
+
106+
[source,terminal]
107+
----
108+
$ systemctl restart --user podman.socket
109+
----
110+
111+
** Alternatively, you can expose the podman API by using TCP:
112+
+
113+
[source,terminal]
114+
----
115+
$ podman system service --time=0 tcp:127.0.0.1:5534 &
116+
export DOCKER_HOST=tcp://127.0.0.1:5534
117+
----

‎serverless/functions/serverless-functions-setup.adoc‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ To enable the use of {FunctionsProductName} on your cluster, you must complete t
2020
* {ServerlessProductName} is installed on your cluster.
2121
* The xref:../../cli_reference/openshift_cli/getting-started-cli.adoc#cli-getting-started[`oc` CLI] is installed on your cluster.
2222
* The xref:../../serverless/cli_tools/installing-kn.adoc#installing-kn[Knative (`kn`) CLI] is installed on your cluster. Installing the `kn` CLI enables the use of `kn func` commands which you can use to create and manage functions.
23-
* You have installed Docker Container Engine or podman, and have access to an available image registry.
23+
* You have installed Docker Container Engine or podman version 3.3 or higher, and have access to an available image registry.
2424
* If you are using link:https://quay.io/[Quay.io] as the image registry, you must ensure that either the repository is not private, or that you have followed the {product-title} documentation on xref:../../openshift_images/managing_images/using-image-pull-secrets.adoc#images-allow-pods-to-reference-images-from-secure-registries_using-image-pull-secrets[Allowing pods to reference images from other secured registries].
2525
* If you are using the OpenShift Container Registry, a cluster administrator must xref:../../registry/securing-exposing-registry.adoc#securing-exposing-registry[expose the registry].
2626

‎serverless/serverless-release-notes.adoc‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,10 @@ For details about the latest Knative component releases, see the link:https://kn
1919
====
2020

2121
include::modules/serverless-api-versions.adoc[leveloffset=+1]
22+
include::modules/serverless-deprecated-removed-features.adoc[leveloffset=+1]
2223

2324
// Modules included, most to least recent
25+
include::modules/serverless-rn-1-20-0.adoc[leveloffset=+1]
2426
include::modules/serverless-rn-1-19-0.adoc[leveloffset=+1]
2527
include::modules/serverless-rn-1-18-0.adoc[leveloffset=+1]
2628
include::modules/serverless-rn-1-17-0.adoc[leveloffset=+1]

0 commit comments

Comments
 (0)