Skip to content

A Serverless plugin that allows use of serverless in a JS mono repo. from serverless-plugin-monorepo

License

Notifications You must be signed in to change notification settings

guhyeon/serverless-plugin-monorepo3

Repository files navigation

serverless-plugin-monorepo3

TypeScript code style: prettier NPM Package

From serverless-plugin-monorepo. Because it is not managed and does not support pnpm.

A Serverless plugin design to make it possible to use Serverless in a Javascript mono repo with hoisted dependencies,

e.g. when using Yarn Workspaces. or Pnpm workspace.

This plugin alleviates the need to use nohoist functionality by creating symlinks to all declared dependencies. Development dependencies are deliberately NOT linked so these will not be packaged into the resulting archive.

if you use pnpm workspace you need some additional settings, see below please.

Not using nohoist saves wasting disk space and also accidentally including development dependencies in our packaged functions.

Note, this package will only work on operating systems that support symbolic links!

Installation

yarn add --dev serverless-plugin-monorepo3
# or using NPM
npm install --dev serverless-plugin-monorepo3
# or using pnpm
pnpm install --save-dev serverless-plugin-monorepo3

Currently this plugin requires Node V10+. If there is interest in support older versions then trans-compilation with Babel could be added.

Usage

Add the plugin to your serverless.yml file:

plugins:
  - serverless-plugin-monorepo3

The plugin listens for package lifecycle events. Prior to Serverless packaging up the service, it will scan the package.json file for dependencies and ensure that all dependencies (including transitive dependencies) are symlinked in node_modules.

Hence when Serverless creates the archive, it will follow the symlinks and all dependencies will be added as expected. Development/peer dependencies are ignored.

The plugin will run when you do:

  • A full deployment (sls deploy)
  • Deployment of individual functions (sls deploy -f)
  • Spinning up a local sandbox with serverless-offline (sls offline [start])

pnpm

add .npmrc

node-linker=hoisted
hoist-pattern[]=!yourpackagename

Settings

On Windows platforms only, the package will create junction links by default as these do not require administrative privileges on older versions of Windows. You can set the linkType setting to dir to create symbolic links instead. This setting is directly passed to the fs.symlink function. It is ignored on non Windows platforms.

Contributing

We welcome issue reports and pull requests!

There is a small run script which will launch Node V14 in a Docker container which you may find useful for development purposes.

Note we are using Prettier with Typescript ESLint and you can run the lint tool via pnpm lint which will attempt to automatically issues like spacing etc.

Copyright

Copyright Blocksmith Limited 2023-2026

About

A Serverless plugin that allows use of serverless in a JS mono repo. from serverless-plugin-monorepo

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published