What is this plugins purpose?
This plugin was originally built to allow deployment of arbitrarily nested python lambdas using serverless. The functionality is related to the one discussed in this serverless issue (#3366).
Vanilla serverless packages your source-code, but retains the folder structure inside the zip-file. However, AWS Lambda can only find the entry-point to your function if it is packaged in a zip-files at root level (see the AWS-Lambda docs).
How it was solved
You define a
path that you want to package inside of serverless's
package property. The plugin then packages your code, such that te defined path becomes the root-path (
.) of the package zip-file.
What else it can do
- Custom artifact path. You can define an
artifactproperty. The zip-file will be placed there.
- If you want to include only certain file-names or extensions you may define them using the
- If you have additional libraries you need inside the lambda environment you may define a path in the
libsproperty. The contents of this folder will be packaged alongside your functions code (in the root of the zip-file). This lets you include arbitrary python modules (i.e. built against the Lambda AMI inside of docker), but keep them away from your code during development.
npm install serverless-custom-packaging-plugin --save-dev
This installs the plugin into your
node_modules and adds the dev-dependency to your
How to use it
plugins: - serverless-custom-packaging-plugin ... functions: myFunction: ... package: path: path/to/my/code artifact: path/to/my/artifact.zip libs: path/to/libs include_globs: - "**/*.py" - "**/*.json"
Tested with ...
We have created a couple of patches (so far only for serverless version 1.17.0) to get all the functionality we needed working. You are free to use these patches, but be aware that this could potentially break (other) serverless functionality.
A word of caution
This is a work in progress. This means no guarantees that everything will work as promised. If you would like some more functionality you are welcome to contribute. We greatly appreciate any testing you do with different serverless versions and setups.