Name: serverless-plugin-boilerplate
Owner: Serverless
Description: A Starter Project to help you build Plugins for the Serverless Framework -
Created: 2015-12-11 03:36:31.0
Updated: 2018-02-13 04:07:32.0
Pushed: 2017-06-09 17:27:39.0
Homepage: http://www.serverless.com
Size: 15
Language: JavaScript
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
This is a starter project to help you build plugins for the Serverless Framework. You can install this boilerplate Plugin in its current form into your Serverless Projects and it will run. All that's left for you to do is write your custom logic. We've filled this with useful comments to help you along your way. Also, the entire Serverless Framework is comprised of Plugins. When you write your own Plugin, it's no hack, you're simply extending and customizing the Serverless Framework to suite your needs and build processes :)
Note: Serverless v0.1.0 or higher is required.
A Serverless Plugin can do the following:
One plugin can do all of the above, and include several Hooks and Actions at once.
Plugins must be written in a Serverless Project, so create one specifically for authoring/testing plugins, or write your plugin in a Project you are working on, and make sure you are using Serverless v0.1.0
or greater.
cd into your Serverless Project, create a “plugins” folder and download this boilerplate project into it. The “plugins” folder is specifically for developing plugins. Give this boilerplate's folder a custom title.
Update the boilerplate's package.json
“name” property with your plugin's name.
cd into your new plugin and run:
link
cd into your Serverless Project's root folder and run:
link <yourpluginname>
Lastly, open the 's-project.json' in your Project's root folder and add the plugin to the plugins
property, like this:
gins": [
"my-custom-plugin"
Use the Serverless CLI within your project and run serverless
to see the help screen. You should now see an option entitled custom
with a run
Action. This was added by the boilerplate plugin.
Now, your custom plugin is installed and ready to be worked on! Read the comments in the index.js
for further instructions.
If you would like to learn more about plugins, please check out our Documentation.
Good luck! - Serverless