An extension of the serverless-webpack plugin. This plugin bundles your Node.js Lambda functions with sensible defaults so you don't have to maintain your own Webpack configs.
- Linting via ESLint
- Caching for faster builds
- Use ES6
import/export
- Supports transpiling unit tests with babel-jest
- Source map support for proper error messages
And all this works without having to install Webpack, Babel, ESLint, etc. or manage any of their configs. Simply add serverless-bundle to your app and you are done!
- "eslint"
- "webpack"
- "@babel/core"
- "babel-eslint"
- "babel-loader"
- "eslint-loader"
- "@babel/runtime"
- "@babel/preset-env"
- "serverless-webpack"
- "source-map-support"
- "webpack-node-externals"
- "eslint-config-strongloop"
- "@babel/plugin-transform-runtime"
- "babel-plugin-source-map-support"
+ "serverless-bundle"
You can read more about this over on Serverless Stack.
Install the serverless-bundle
plugin using:
$ npm install --save-dev serverless-bundle
Then add it to your serverless.yml
.
plugins:
- serverless-bundle
To run your tests using the same Babel config used in the plugin add the following to your package.json
:
"scripts": {
"test": "serverless-bundle test"
}
Once installed and added to your serverless.yml
, serverless-bundle will automatically package your functions using Webpack when you run the various serverless commands.
You can configure the following through your serverless.yml
.
custom:
bundle:
sourcemaps: true # Enable source maps
caching: true # Enable Webpack caching
stats: false # Don't print out any Webpack output
linting: true # Enable linting as a part of the build process
forceInclude: # Optional list of NPM packages that need to be included
- mysql # Only necessary if packages are included dynamically
ignorePackages: # Ignore building any of the following packages
- hiredis # For ex, hiredis needs to be ignored if using redis
copyFiles: # Copy any additional files to the generated package
- from: 'public/*' # Where the files are currently
to: './' # Where in the package should they go
packager: npm # Specify a packager, 'npm' or 'yarn'. Defaults to 'npm'.
packagerOptions: # Run a custom script in the package process
scripts: # https://github.com/serverless-heaven/serverless-webpack#custom-scripts
- echo hello > test
-
ESLint
This plugin uses eslint-config-strongloop. You can override this by placing your own
.eslintrc.json
with the rules you'd like to use. If you'd like to ignore specific files, you can use a.eslintignore
file. -
Customizing Babel and Webpack configs
This plugin does not support customizing the Babel and Webpack configs, since serverless-webpack does a pretty good job with that. However, if you think the default config is missing some key features, feel free to open an issue about it.
-
Packager scripts
The
packagerOptions.scripts
option allows serverless-webpack to run a custom script in the packaging process. This is useful for installing any platform specific binaries. See below for thesharp
package. -
Usage with WebStorm
Here is some info on how to get this plugin to support running tests in WebStorm — AnomalyInnovations#5 (comment)
The packages below need some additional config to make them work.
The knex.js module is automatically excluded from the bundle since it's not compatible with Webpack. However, you need to force include the specific database provider package since these are dynamically included. Use the forceInclude
option to pass in a list of packages that you want included. For example, to include mysql
use the following:
custom:
bundle:
forceInclude
- mysql
The sharp package needs to include a specific binary before package. Use the packagerOptions.scripts
for this.
custom:
bundle:
packagerOptions:
scripts:
- rm -rf node_modules/sharp && npm install --arch=x64 --platform=linux --target=10.15.0 sharp
The pg package optionally includes pg-native
that needs to be ignored from Webpack. Use the ignorePackages
option to do this.
custom:
bundle:
ignorePackages:
- pg-native
The redis package optionally includes hiredis
that needs to be ignored from Webpack. Use the ignorePackages
option to do this.
custom:
bundle:
ignorePackages:
- hiredis
- Open a new issue if you've found a bug or have some suggestions.
- Or submit a pull request!
To run this project locally, clone the repo and initialize the project.
$ git clone https://github.com/AnomalyInnovations/serverless-bundle
$ cd serverless-bundle
$ npm install
Run the tests using.
$ npm test
To test the serverless-bundle test
command.
$ npm run test-scripts
To install locally in another project.
$ npm install /path/to/serverless-bundle
This plugin would not be possible without the amazing serverless-webpack plugin and the ideas and code from Create React App.
This plugin is maintained by Anomaly Innovations; makers of Seed and Serverless Stack.