rgw-lua-scripting.md

Usecases

• general intro, and the "why"
• ransomware detection
• ad-hoc bucket notification target
• in tape storage solution
• dynamic storage class

Code

• user docs
• code walkthrough
• rgw_lua.cc/h lua management code for scripts and packages (which is not specific to backend)
• since the lua scripts and package list are stored in RADOS, some of the management script is also in: `driver/rados/rgw_sal_rados.cc/h'
• rgw_admin.cc for the script and package management commands
• rgw_lua_utils.cc/h infrastructure for linking between lua and RGW C++ code
• rgw_lua_background.cc/h the global background context
• rgw_lua_request.cc/h the per S3 request contexts (pre/post request)
• rgw_lua_data_filter.cc/h the get/put object data context

TODO

Productizing

• allow for multiple scripts in the same context
• lua debug hook to limit time/cycles per execution
• sandboxed lua with preinstalled packages

Performance

• locking scheme of background context
• compiled lua scripts
• yielding lua async operations

Functionality

• lazy attribute rerieval
• add new lua contexts (which?)
• lua support in rook

RADOS

• lua rados binding
• lua rgw rados binding
• lua cls binding