Create your own runtime¶

Request¶

Example request:

POST /execute

Parameters provided by Qinling:

1. The execution information.

   • execution_id: The Qinling execution UUID.

   • download_url: The URL sent to Qinling to download the function package. Here is an example for how to download function package in your runtime implementation using requests python library, the request is meant to send to the sidecar container, the final package should be put in /var/qinling/packages/<function_id>.zip if the request is successfully handled by the sidecar:

     resp = requests.post(
         'http://localhost:9091/download',
         json={
             'download_url': download_url,
             'function_id': function_id,
             'token': params.get('token')
         }
     )
     

   • function_id: The Qinling function UUID.

   • entry: The function entry that user defines when creating the function, e.g. “hello_world.main”

   • input: The dictionary of the function input that user defines when creating the function execution. e.g. {"key": "value"}. If the user specifies the positional params when creating the function execution, the input will be something like {"__function_input": ("arg1", "arg2"), "key": "value"}

   • timeout: The timeout in seconds user defines when creating the function, the default value is 5. Your runtime implementation should take this timeout value into account when executing the code. If the timeout is reached, you should terminate the function execution and return an appropriate error message.

   • cpu: The CPU limit user defines when creating the function. Your runtime is responsible for limiting the CPU resource usage when the function is running.

   • memory_size: The memory limit user defines when creating the function. Your runtime is responsible for limiting the memory resource usage when the function is running.

   • request_id: The request UUID for the function execution which can be used to track the execution for debugging purpose.

2. The Information of the user who triggers the function execution.

   Most of that information is used for creating a Keystone session that could be passed to the function, so it’s easy to interact with the OpenStack services in the function code.

   • trust_id: The trust UUID in Keystone. Please see for more information in Keystone official doc about Trust.
   • auth_url: Identity service endpoint for authorization.
   • username: Username for authentication.
   • password: Password for authentication.
   • token: Token for authentication.

Response¶

Content in the response dictionary:

• output: The return value of the function execution if it is successful, otherwise the error message.
• duration: The execution duration in seconds.
• logs: The stdout content during the function execution.
• success: True or False. It should be False if the execution reaches timeout, any exception raised inside user’s function or the execution is killed because of too much system resource consumed, etc.