serverless-custom-packaging-plugin

![Github All Releases]()
![license]()

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).

$3

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).

$3

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.

$3

1. Custom artifact path. You can define an artifact property. The zip-file will be placed there.
2. If you want to include only certain file-names or extensions you may define them using the include_globs property.
3. If you have additional libraries you need inside the lambda environment you may define a path in the libs property. 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.

Installation

``
npm install serverless-custom-packaging-plugin --save-dev
`
This installs the plugin into your node_modules and adds the dev-dependency to your package.json.

How to use it

`yaml
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 ...

| Serverless version | serverless deploy | serverless package -f | serverless deploy function -f | comment |
|:---:|:---:|:---:|:---:|---:|
| 1.10.0 | | | |
| 1.11.0 | | | | not tested |
| 1.12.0 | | | | not tested |
| 1.13.0 | | | |not tested |
| 1.14.0 | | | |
| 1.15.0 | | | |
| 1.16.0 | | | |
| 1.17.0 | | | / | everything works when patched |
| 1.18.0 | | | | package.individually = true` must be set

$3

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.