Skip to content
This repository has been archived by the owner on Jul 27, 2022. It is now read-only.

apigee-127/volos-swagger-apply

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Volos-Swagger-Apply

This module allows you add and configure Volos API policies without writing any code - just by declaring it in the Swagger in your Swagger-Node project. The following policies are currently supported by this module:

  • Analytics
  • Cache
  • Quota
  • Spike arrest

Analytics is Apigee-specific, but every other policy is available as an in-memory and Redis provider as well as through Apigee Edge.

More information on Volos here: https://github.com/apigee-127/volos

More information on applying policies here: https://github.com/apigee-127/a127-documentation/wiki/Policies

Example app here: https://github.com/apigee-127/swagger-node-examples/tree/master/volos-plugins

Installation

  1. Add the volos-swagger-apply module to your fittings directory. The easiest way to do this presently is to use npm install to install the module (to node_modules) and then move it to your fittings directory. For example, assuming you are in your main project directory, you can perform the following steps:
npm install volos-swagger-apply
mkdir api/fittings
mv node_modules/volos-swagger-apply api/fittings
  1. Add the volos modules you plan use to your application dependencies. We'll be setting an in-memory quota, so we'll add the volos-quota-memory module to our dependencies. Example:
npm install --save volos-quota-memory
  1. Add the volos_apply fitting to your pipe (config/default.yaml). I suggest placing it just before your controller router:
    swagger_controllers:
      - onError: json_error_handler
      - cors
      - swagger_security
      - _swagger_validate
      - express_compatibility
      - volos-swagger-apply               # <- RUN HERE
      - _router
  1. Add the x-volos-resources extension tag to your Swagger with your policy configuration:
x-volos-resources:
  MyQuota:
    provider: volos-quota-memory
    options:
      timeUnit: minute
      interval: 1
      allow: 1
  1. Add the "x-volos-apply" tag to any paths or operations on your Swagger you would like your policy to apply it to along with any configuration that is necessary:
paths:
  /hello:
    x-volos-apply:
        MyQuota: {}

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published