serverless-seed-plugin

serverless-seed-plugin

This plugin is still in WIP and non-stable.

This plugin seeds the data for AWS resources.

Supported resources

• AWS::DynamoDB::Table
• AWS::Cognito::UserPool
• AWS::S3::Bucket

Install

$ npm install --save-dev serverless-seed-plugin

Add the plugin to your serverless.yml file.

plugins:
  - serverless-seed-plugin

Usage

Set up custom.seed.<resource>.<options> in your serverless.yml file. You can also follow the code in ./example/ dir.

Then run serverless seed.

DynamoDB

custom:
  seed:
    dynamodb:
      TableId:
        truncate: true # default false
        clone:
          table: source-table-name # Clone data from table
          recreate: true # default false
          config: # empty by default, for more options see https://github.com/enGMzizo/copy-dynamodb-table#aws-config-for-each-table--cross-region--
            accessKeyId: AKID
            secretAccessKey: SECRET
            region: eu-west-1
        data:
          - id: 'abc1'
            name: 'myRecordName1'
          - id: 'abc2'
            name: 'myRecordName2'

Cognito

• immutable attributes are set only first time, otherwise update of these attributes is skipped
• custom: prefix for custom attributes is required
• every created user has confirmed account status and no confirmation e-mail is sent
• only attributes and password is updated if user exists

custom:
  seed:
    cognito:
      TodosUserPool:
        - username: abc1
          password: passw1
          attributes:
            - Name: custom:mutableClientData
              Value: mutableClientData_val
            - Name: custom:immutableClientData
              Value: immutableClientData_val
        - username: abc2
          password: passw2
          attributes: []

S3

Do not forget to clear all objects from bucket, before serverless remove command called or use our plugin

• all nested dirs and files will be uploaded
• existing files will be overwritten

custom:
  seed:
    s3:
      TodosBucket:
        - ./somedir/

Changelog

0.3.2 (2022-01-12)

Bug Fixes

• cognito: fixed seed for accounts with lot of user pools (#73) (1f20c6f)
• dynamodb: use all primary keys (#74) (aa6df2e)