Serverless Python Dependencies
Serverless Framework plugin to automatically add Python dependencies as layers to your functions.
Based on Lovage - a Python-only serverless library that's more RPC-like and less HTTP service oriented.
Install
sls plugin install -n serverless-pydeps
This will automatically add the plugin to your project's package.json
and the plugins section of its
serverless.yml
. That's all you need. There is no need to install or configure anything else, not even Python.
The plugin will automatically create a layer from the dependencies listed in Pipfile
or requirements.txt
and attach
it to all functions with Python runtime when you run sls deploy
.
How Does It Work?
Dependencies are collected and packaged in a special Lambda function. This means you won't have to wait on dependencies to download to your local computer, get zipped up, and uploaded back to S3. This makes deployment, and especially updates, really fast. Dependencies will only be built and uploaded when they change. Your code packages will contain your code and nothing else.
Dependencies will be installed by the same system that runs them, so you never have to worry about running the right Python version on the right OS.
Known Limitations
- Only AWS is supported since we use Lambda Layers
- serverless-prune-plugin will not clean-up old layers
Other Options
serverless-pydeps | serverless-python-requirements | |
---|---|---|
Setup | Install plugin | Install plugin, Python, and potentially Docker for consistent requirements |
Package speed | Fast as dependencies are not packaged locally | Slow as every code change repackages all dependencies |
Upload Speed | Never uploads anything locally | Uploads all dependencies on every code change |
Supported providers | AWS | All providers supported by Serverless (AWS, GCP, Azure, etc.) |
Private repositories | Not supported as dependencies are downloaded in a Lambda function | Supported |
Native code dependencies (*.so files) | Only supported if dependency has proper binary wheel | Supported with custom Dockerfile , dockerExtraFiles , etc. |
Local disk usage | Zero | All dependencies are cached and also stored in .serverless |