You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Split out 6 .md files into a separate review path:
- docs/user/00-80-migrate-to-new-runtime-api.md
- docs/user/00-90-runtime-deprecation-schedule.md
- docs/user/technical-reference/05-20-env-variables.md
- docs/user/technical-reference/07-70-function-specification.md
- components/runtimes/{nodejs26,python314}/README_template.md
The eject endpoint will still pick up the updated README templates
once the docs branch is merged.
Copy file name to clipboardExpand all lines: components/runtimes/nodejs26/README_template.md
+15-18Lines changed: 15 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,48 +1,45 @@
1
1
# Ejected Functions Workspace
2
2
3
-
This folder contains the files you need to test, run, deploy, and productize your business application:
3
+
This folder contains the most important block to test, run, deploy, and productize your business application and consists of the following elements:
4
4
5
-
*`handler.js` — source code of your business application
6
-
*`server.mjs` — server that loads and runs `handler.js`
7
-
*`package.json` — dependencies for `handler.js` and `server.mjs`
8
-
*`lib/` — internal server modules (tracing, metrics, request timeout, and graceful shutdown)
9
-
*`sdk/` — user-facing SDK module (`require('sdk')`) exposing CloudEvent helpers, tracer, and function metadata getters
10
-
*`resources/` — basic Kubernetes resources for deploying the application on a cluster
11
-
*`Dockerfile` — application image definition
12
-
*`Makefile` — automation scripts
5
+
*`handler.js` - source code of the buisness application
6
+
*`server.mjs` - server source code required to run `handler.js`
7
+
*`package.json` - dependencies file required for the `handler.js` and the `server.mjs` files to run
8
+
*`lib/` - directory containing server SDK (like cloudevents or tracing functionality)
9
+
*`resources/` - directory with basic Kubernetes resources required to deploy the application on a cluster
10
+
*`Dockerfile` - application image definition
11
+
*`Makefile` - basic portion of automations and scripts
13
12
14
13
## Scripts and Automations
15
14
16
-
Use the `Makefile`targets to run the application locally or build and deploy it on a k3d cluster. To see all available targets, run:
15
+
The `Makefile`file is designed to speed up processes such as running an application locally or building or deploying it on a k3d cluster.
17
16
18
-
```bash
19
-
make help
20
-
```
17
+
Read more about possibilities and functionalites by running the `make help` target.
21
18
22
19
### Run Application Locally
23
20
24
-
> [!NOTE]
25
-
> When you run the application outside the cluster, it cannot reach in-cluster services or read container environment variables. Use this target to test without such dependencies, or mock them and export the environment variables manually.
21
+
> [!NOTE]
22
+
> Because the application is run outside the cluster, it cannot simply reach in-cluster services and use container envs. It is strongly recommended to use the following target to test the application without such dependencies or mock them and export container envs manually.
26
23
27
24
```bash
28
25
export FUNC_NAME=<name>
29
26
export FUNC_RUNTIME=<runtime>
30
-
export SERVICE_NAMESPACE=<namespace>
27
+
export SERVICE_NAMESPACE=<SERVICE_NAMESPACE>
31
28
32
29
make run
33
30
```
34
31
35
32
### Deploy Application on k3d
36
33
37
-
To build, import, and deploy the application on a k3d cluster:
34
+
The workspace is designed to easily start working on the productization of a business application extracted from Function. It allows testing it on a k3d cluster by building, importing, and deploying it:
38
35
39
36
```bash
40
37
make k3d-deploy
41
38
```
42
39
43
40
### Build and Push Application
44
41
45
-
To build and push your image to the location specified by `IMG`:
42
+
Build and push your image to the location specified by `IMG`:
Copy file name to clipboardExpand all lines: components/runtimes/python314/README_template.md
+17-19Lines changed: 17 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,47 +1,45 @@
1
1
# Ejected Functions Workspace
2
2
3
-
This folder contains the files you need to test, run, deploy, and productize your business application:
4
-
5
-
*`handler.py`— source code of your business application
6
-
*`server.py`— server that loads and runs`handler.py`
7
-
*`requirements.txt`— dependencies for `handler.py` and `server.py`
8
-
*`lib/`— server SDK modules (CloudEvents, tracing, and similar)
9
-
*`resources/`— basic Kubernetes resources for deploying the application on a cluster
10
-
*`Dockerfile`— application image definition
11
-
*`Makefile`— automation scripts
12
-
3
+
This folder contains the most important block to test, run, deploy, and productize your business application and consists of the following elements:
4
+
5
+
*`handler.py`- source code of the buisness application
6
+
*`server.py`- server source code required to run`handler.py`
7
+
*`requirements.txt`- dependencies file required for the `handler.py` and the `server.py` files to run
8
+
*`lib/`- directory containing server SDK (like cloudevents or tracing functionality)
9
+
*`resources/`- directory with basic Kubernetes resources required to deploy the application on a cluster
10
+
*`Dockerfile`- application image definition
11
+
*`Makefile`- basic portion of automations and scripts
12
+
13
13
## Scripts and Automations
14
14
15
-
Use the `Makefile`targets to run the application locally or build and deploy it on a k3d cluster. To see all available targets, run:
15
+
The `Makefile`file is designed to speed up processes such as running an application locally or building or deploying it on a k3d cluster.
16
16
17
-
```bash
18
-
make help
19
-
```
17
+
Read more about possibilities and functionalites by running the `make help` target.
20
18
21
19
### Run Application Locally
22
20
23
-
> [!NOTE]
24
-
> When you run the application outside the cluster, it cannot reach in-cluster services or read container environment variables. Use this target to test without such dependencies, or mock them and export the environment variables manually.
21
+
> [!NOTE]
22
+
> Because the application is run outside the cluster, it cannot simply reach in-cluster services and use container envs. It is strongly recommended to use the following target to test the application without such dependencies or mock them and export container envs manually.
25
23
26
24
```bash
27
25
export FUNC_NAME=<name>
28
26
export FUNC_RUNTIME=<runtime>
29
-
export SERVICE_NAMESPACE=<namespace>
27
+
export SERVICE_NAMESPACE=<SERVICE_NAMESPACE>
30
28
31
29
make run
32
30
```
33
31
34
32
### Deploy Application on k3d
35
33
36
-
To build, import, and deploy the application on a k3d cluster:
34
+
The workspace is designed to easily start working on the productization of a business application extracted from Function. It allows testing it on a k3d cluster by building, importing, and deploying it:
37
35
38
36
```bash
39
37
make k3d-deploy
40
38
```
41
39
42
40
### Build and Push Application
43
41
44
-
To build and push your image to the location specified by `IMG`:
42
+
Build and push your image to the location specified by `IMG`:
Copy file name to clipboardExpand all lines: docs/user/technical-reference/05-20-env-variables.md
+1Lines changed: 1 addition & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,6 +14,7 @@ Every runtime provides its own unique environment configuration which can be rea
14
14
|**HANDLER_FUNC_NAME**|`main`| The name of the exported Function inside the `HANDLER_MOD_NAME` file. |
15
15
|**MOD_NAME**|`handler`| Deprecated. Use `HANDLER_MOD_NAME` instead. Supported only in nodejs20, nodejs22, nodejs24, and python312. |
16
16
|**HANDLER_MOD_NAME**|`handler`| The name of the main exported file. It must have an extension of `.py` for the Python runtimes and `.js` for the Node.js ones. The extension must be added on the server side. |
17
+
|**KUBELESS_INSTALL_VOLUME**|`/kubeless`| Deprecated. Use `HANDLER_PATH` instead. Supported only in nodejs20, nodejs22, nodejs24, and python312. |
17
18
|**HANDLER_PATH**|`/`| Full path to volume mount with user's source code. |
18
19
|**FUNC_RUNTIME**| None | The name of the actual runtime. Possible values: `nodejs20` - deprecated, `nodejs22`, `nodejs24`, `nodejs26`, `python312`, and `python314`. |
19
20
|**TRACE_COLLECTOR_ENDPOINT**| None | Full address of OpenTelemetry Trace Collector is exported if the trace collector's endpoint is present. ||
Copy file name to clipboardExpand all lines: docs/user/technical-reference/07-70-function-specification.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -371,7 +371,7 @@ You can use a custom runtime image to override the existing one. Your image must
371
371
372
372
- Expose the workload endpoint on the right port
373
373
- Provide liveness and readiness check endpoints at `/healthz`
374
-
- Fetch sources from the path under the `HANDLER_PATH` environment
374
+
- Fetch sources from the path under the `KUBELESS_INSTALL_VOLUME` environment
375
375
- Security support. Kyma runtimes are secure by default. You only need to protect your images.
376
376
377
377
Every Function's Pods container has the same system environments, which helps you configure the Functions server. For more information, read the [Environment variables](05-20-env-variables.md) page.
This document outlines the planned deprecation and end-of-life (EOL) dates for supported Function runtimes in Kyma Serverless.
4
+
5
+
## Supported Runtimes and Deprecation Timeline
6
+
7
+
| Runtime | Planned Deprecation | Estimated EOL |
8
+
| --- | --- | --- |
9
+
| Node.js 20 | February 2026 | April 2026 |
10
+
| Node.js 22 | July 2026 | November 2026 |
11
+
| Node.js 24 | TBD | TBD |
12
+
| Python 3.12 | September 2026 | March 2027 |
13
+
| Python 3.14 | TBD | TBD |
14
+
15
+
## Deprecation History
16
+
17
+
### Node.js 20
18
+
-**Status**: Deprecated
19
+
-**Deprecation Version**: v1.10.0
20
+
-**Details**: Node.js 20 runtime was deprecated starting with version 1.10.0. For more information, see [this issue](https://github.com/kyma-project/serverless/issues/2231).
21
+
22
+
> [!NOTE]
23
+
> The deprecation and EOL dates listed in this document are **predictions based on current release cadence and Node.js/Python LTS schedules**. These dates are subject to change and may be adjusted based on the following:
24
+
> - Changes in the Kyma Serverless release schedule
25
+
> - Updates to upstream Node.js and Python LTS timelines
26
+
> - Community feedback and requirements
27
+
> - Security considerations
28
+
>
29
+
> Always check the [release notes](https://github.com/kyma-project/serverless/releases) for announcements regarding runtime deprecations and EOL timelines.
30
+
31
+
## Recommendations
32
+
33
+
- Plan upgrades to newer runtimes well in advance of deprecation dates
34
+
- Monitor release notes for any changes to this schedule
35
+
- For Functions using deprecated runtimes, migrate before the EOL date to avoid service disruption
0 commit comments