@silvermine/serverless-plugin-apigateway-stage-tags

    1.0.0 • Public • Published

    Serverless Plugin: Support Tagging API Gateway Stages

    Build Status Coverage Status Dependency Status Dev Dependency Status

    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.

    Install

    npm i @silvermine/serverless-plugin-apigateway-stage-tags

    DownloadsWeekly Downloads

    21

    Version

    1.0.0

    License

    MIT

    Unpacked Size

    9.38 kB

    Total Files

    9

    Last publish

    Collaborators

    • jthomerson
    • onebytegone
    • webpub