@silvermine/serverless-plugin-apigateway-stage-tags
v1.0.0
Published
Plugin for the SLS 1.x branch to provide support for adding API Gateway stage tags (not currently supported by CloudFormation)
Downloads
714
Readme
Serverless Plugin: Support Tagging API Gateway Stages
What is it?
This is a plugin for the Serverless framework that adds support for setting tags on an API Gateway stage.
Normally CloudFormation supports tagging for resources created by a CloudFormation template. Unfortunately, API Gateway stages are not one of those resources. AWS does provided support for tagging via the AWS Console, aws-cli, and the API Gateway REST API. This plugin uses this support to automate the creation of the tags for the API Gateway stages in the service.
This plugin will mimic the stack tag propagation that CloudFormation automatically performs. There is not currently support for adding additional tags to a API Gateway stage. If this is a feature you need, feel free to submit a PR!
Once CloudFormation supports adding tags to an API Gateway stage and serverless/serverless#4644 is completed, this plugin will be obsolete.
How do I use it?
There are two steps:
Install the Plugin as a Development Dependency
npm install --save-dev --save-exact @silvermine/serverless-plugin-apigateway-stage-tags
Telling Serverless to Use the Plugin
Simply add this plugin to the list of plugins in your serverless.yml
file:
plugins:
- '@silvermine/serverless-plugin-apigateway-stage-tags'
How do I contribute?
We genuinely appreciate external contributions. See our extensive documentation on how to contribute.
License
This software is released under the MIT license. See the license file for more details.