Adding script support to Serverless 1.x which enables you to customize Serverless behavior without writing a plugin.
JavaScript
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
test
.codeclimate.yml increase duplication threshold Dec 11, 2016
.editorconfig integrate with code climate to show test coverage and eslint issues Dec 11, 2016
.eslintignore
.eslintrc
.gitignore integrate with code climate to show test coverage and eslint issues Dec 11, 2016
.istanbul.yml upload test coverage to code climate Dec 11, 2016
.travis.yml
README.md
index.js feat(jsscript): Using custom module and require to import modules ins… Jun 27, 2018
package-lock.json
package.json

README.md

npm version Build Status Test Coverage Code Climate Issue Count

What's the plugins for?

This plugin add script support to Serverless 1.0 which enables you to customize Serverless behavior without writing a plugin.

It allows you to run nodejs script in any build stage.

Quick Start

  1. Install

     npm install --save-dev serverless-scriptable-plugin
    
  2. Add to Serverless config

     plugins:
       - serverless-scriptable-plugin
    
     custom:
       scriptHooks:
         before:deploy:createDeploymentArtifacts: npm run build
    

Example

  1. 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:deploy:createDeploymentArtifacts: npm run build
    
    package:
      exclude:
        - '**/**'
        - '!dist/**'
        - '!node_modules/**'
        - node_modules/aws-sdk/**
  2. 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:package:createDeploymentArtifacts: zip -q -r .serverless/package.zip src node_modules
    
    service: service-name
    package:
      artifact: .serverless/package.zip
  3. 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:deploy: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 }
          }
        }
      );
  4. 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:package:createDeploymentArtifacts: 
          - build/serverless/add-log-subscriptions.js
          - build/serverless/add-dynamodb-auto-scaling.js
    
    service: service-name
    package:
      artifact: .serverless/package.zip

Change Log

  • 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