Environment Variables

You can use environment variables to configure an existing runtime, to read existing configuration or to build your own runtime based on them.

Environments Passed to Runtimes

Every runtime provides its own unique environment configuration which can be read by a server and the handler.js file during the container run:

Common Environments

Environment	Default	Description
FUNC_HANDLER	main	The name of the exported Function inside the MOD_NAME file.
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.
FUNC_PORT	8080	The right port a server listens to.
SERVICE_NAMESPACE	None	The namespace where the right Function exists in a cluster.
KUBELESS_INSTALL_VOLUME	/kubeless	Full path to volume mount with users source code.
FUNC_RUNTIME	None	The name of the actual runtime. Possible values: nodejs20 and python312.
TRACE_COLLECTOR_ENDPOINT	None	Full address of OpenTelemetry Trace Collector is exported if the trace collector's endpoint is present.
PUBLISHER_PROXY_ADDRESS	http://eventing-publisher-proxy.kyma-system.svc .cluster.local/publish	Full address of the Publisher Proxy service.

Specific Environments

There are a few environments that occur only for a specific runtimes. The following list includes all of them:

Python Runtime-Specific Environment Variables

Environment	Default	Description
PYTHONPATH	$(KUBELESS_INSTALL_VOLUME)/lib.python3.9/site-packages :$(KUBELESS_INSTALL_VOLUME)	List of directories that Python must add to the sys.path directory list.
PYTHONUNBUFFERED	TRUE	Defines if Python's logs must be buffered before printing them out.

Configure Runtime

You can configure environment variables either separately for a given runtime or make them runtime-agnostic using a ConfigMap.

Define Environment Variables in a Config Map

ConfigMaps allow you to define Function's environment variables for any runtime through key-value pairs. After you define the values in a ConfigMap, simply reference it in the Function custom resource (CR) through the valueFrom parameter. See an example of such a Function CR that specifies the my-var value as a reference to the key stored in the my-vars-cm ConfigMap as the MY_VAR environment variable.

apiVersion: serverless.kyma-project.io/v1alpha2
kind: Function
metadata:
  name: sample-cm-env-values
  namespace: default
spec:
  env:
    - name: MY_VAR
      valueFrom:
        configMapKeyRef:
          key: my-var
          name: my-vars-cm
  runtime: nodejs20
  source:
    inline:
      source: |
        module.exports = {
          main: function (event, context) {
            return process.env["MY_VAR"];
          }
        }

Node.js Runtime-Specific Environment Variables

To configure the Function with the Node.js runtime, override the default values of these environment variables:

Environment variable	Description	Type	Default value
FUNC_TIMEOUT	Specifies the number of seconds in which a runtime must execute the code.	Number	180
REQ_MB_LIMIT	Specifies the payload body size limit in megabytes.	Number	1
KYMA_INTERNAL_LOGGER_ENABLED	Enables the default HTTP request logger which uses the standard Apache combined log output. To enable it, set its value to true.	Boolean	false

See the example of a Function with these environment variables set:

apiVersion: serverless.kyma-project.io/v1alpha2
kind: Function
metadata:
  name: sample-fn-with-envs
  namespace: default
spec:
  env:
    - name: FUNC_TIMEOUT
      value: '2'
    - name: REQ_MB_LIMIT
      value: '10'
  runtime: nodejs20
  source:
    inline:
      source: |
        module.exports = {
          main: function (event, context) {
            return "Hello World!";
          }
        }

Python Runtime-Specific Environment Variables

To configure a Function with the Python runtime, override the default values of these environment variables:

Environment variable	Description	Unit	Default value
FUNC_MEMFILE_MAX	for the HTTP request body in bytes.	Number	100*1024*1024
CHERRYPY_NUMTHREADS	Specifies the number of requests that can be handled in parallel	Number	50
KYMA_INTERNAL_LOGGER_ENABLED	Enables the default HTTP request logger which uses the standard Apache combined log output. To enable it, set its value to true.	Boolean	false

See kubeless.py to get a deeper understanding of how the Bottle server, which acts as a runtime, uses these values internally to run Python Functions.

apiVersion: serverless.kyma-project.io/v1alpha2
kind: Function
metadata:
  name: sample-fn-with-envs
  namespace: default
spec:
  env:
    - name: FUNC_MEMFILE_MAX
      value: '1048576' #1MiB
  runtime: nodejs20
  source:
    inline:
      source: |
        def main(event. context):
          return "Hello World!"