Introduction
============


The `luna-lambda` is a service that allows to write and deploy python modules granted by user into kubernetes service.
The above-mentioned entities called `lambda` and `jobs`.

It is highly recommended to learn as more as possible about the product entities and mechanisms
(especially about `handlers` and `video analytics`) before start work with `lambdas`.

The `luna-lambda` will allow to write and use your own *handler* (*handler* lambda) for the product,
*task* (*tasks* lambda), *video-agent* (*agent* lambda) or write an external service (*standalone* lambda) which will
closely interact with the product and have several features
typical for `Luna`-services (such as logging, configurator reload, etc) out of the box.

There are two main entities which the service operates: `lambdas <./lambdas.html>`_ and `jobs <./workflows.html>`_.
`Jobs <./workflows.html>`_ can be created only within `workflows <./workflows.html>`_.
The main difference between lambdas and jobs is that lambdas `lifecycle <./lambdas.html#creation-and-lifecycle>`_
is primarily controlled by user and jobs lifecycle is primarily controlled by service.
Jobs are designed to handle a variety of tasks and work in turns and applicable in conditions of limited resources
(e.g. when only one `lambda` can be invoked at a time due to constraints, but solution required data processing
by multiple `lambdas`).

There are several basic requirements for the `luna-lambda` work
(`lambdas detailed description <./lambda_requirements.html>`_/
`jobs and workflows detailed description <./workflow_requirements.html>`_):

- kubernetes cluster with compatible version of the Product with availability for entities (deployment/services/etc) creation

- s3-like storage bucket with reading and writing permissions for `lambdas` storage

- docker registry for `lambdas` images storage

The detailed description of `luna-lambda` requirements, usage and support is available `here <./lambdas.html>`_.

There is also available `quick start guide <./quick_start_guide.html>`_ with minimalistic example of `lambda` creation and usage.