weixu365 / Serverless Scriptable Plugin
Programming Languages
Labels
Projects that are alternatives of or similar to Serverless Scriptable Plugin
What's the plugins for?
This plugin allows you to write scripts to customize Serverless behavior for Serverless 1.x and upper
It also supports running node.js scripts in any build stage.
Quick Start
-
Install
npm install --save-dev serverless-scriptable-plugin
-
Add to Serverless config
plugins: - serverless-scriptable-plugin custom: scriptHooks: before📦createDeploymentArtifacts: npm run build
Example
-
Customize package behavior
The following config is using babel for transcompilation and packaging only the required folders: dist and node_modules without aws-sdk
plugins: - serverless-scriptable-plugin custom: scriptHooks: before📦createDeploymentArtifacts: npm run build package: exclude: - '**/**' - '!dist/**' - '!node_modules/**' - node_modules/aws-sdk/**
-
Run any command as a hook script
It's possible to run any command as the hook script, e.g. use the following command to zip the required folders
plugins: - serverless-scriptable-plugin custom: scriptHooks: after📦createDeploymentArtifacts: zip -q -r .serverless/package.zip src node_modules service: service-name package: artifact: .serverless/package.zip
-
Create CloudWatch Log subscription filter for all Lambda function Log groups, e.g. subscribe to a Kinesis stream
plugins: - serverless-scriptable-plugin custom: scriptHooks: after📦compileEvents: build/serverless/add-log-subscriptions.js provider: logSubscriptionDestinationArn: 'arn:aws:logs:ap-southeast-2:{account-id}:destination:'
and in build/serverless/add-log-subscriptions.js file:
const resources = serverless.service.provider.compiledCloudFormationTemplate.Resources; const logSubscriptionDestinationArn = serverless.service.provider.logSubscriptionDestinationArn; Object.keys(resources) .filter(name => resources[name].Type === 'AWS::Logs::LogGroup') .forEach(logGroupName => resources[`${logGroupName}Subscription`] = { Type: "AWS::Logs::SubscriptionFilter", Properties: { DestinationArn: logSubscriptionDestinationArn, FilterPattern: ".", LogGroupName: { "Ref": logGroupName } } } );
-
Run multiple commands for the serverless event
It's possible to run multiple commands for the same serverless event, e.g. Add CloudWatch log subscription and dynamodb auto scaling support
plugins: - serverless-scriptable-plugin custom: scriptHooks: after📦createDeploymentArtifacts: - build/serverless/add-log-subscriptions.js - build/serverless/add-dynamodb-auto-scaling.js service: service-name package: artifact: .serverless/package.zip
-
Suppress console output (Optional) You could control what to show during running commands, in case there are sensitive info in command or console output.
custom: scriptHooks: showStdoutOutput: false # Default true. true: output stderr to console, false: output nothing showStderrOutput: false # Default true. true: output stderr to console, false: output nothing showCommands: false # Default true. true: show the command before execute, false: do not show commands ...
Hooks
The serverless lifecycle hooks are different to providers, here's a reference of AWS hooks: https://gist.github.com/HyperBrain/50d38027a8f57778d5b0f135d80ea406#file-lifecycle-cheat-sheet-md
Change Log
-
Version 0.8.0 and above
- Check details at https://github.com/weixu365/serverless-scriptable-plugin/releases
-
Version 0.7.1
- [Feature] Fix vulnerability warning by remove unnecessary dev dependencies
-
Version 0.7.0
- [Feature] Return promise object to let serverless to wait until script is finished
-
Version 0.6.0
- [Feature] Supported execute multiple script/command for the same serverless event
-
Version 0.5.0
- [Feature] Supported serverless variables in script/command
- [Improvement] Integrated with codeclimate for code analysis and test coverage
-
Version 0.4.0
- [Feature] Supported colored output in script/command
- [Improvement] Integrated with travis for CI
-
Version 0.3.0
- [Feature] Supported to execute any command for serverless event
-
Version 0.2.0
- [Feature] Supported to execute javascript file for serverless event