Poppy/Provider - Getting Started
< Poppy
Revision as of 20:33, 17 October 2014 by Amit Gandhi (talk | contribs) (→Building Your Provider Driver)
Contributing
Building Your Provider Driver
- Understand how the Poppy API is architected
- Understand the Mock CDN Provider for an basic example of what a provider implementation looks like.
- Understand the Provider Driver interface (abstract base classes) that must be conformed to, so that you know what features need to be implemented to interact with your own API's.
- Investigate some of the other provider implementations to get an idea of how to implement yours.
- Get familiar with the Service Object. This object is what is passed to the provider driver when creating/updating a configuration. The provider driver will need to parse through these properties and make the appropriate API calls to your API to create the configuration on your end.
- Get familiar with the Responder functions. These functions are called to create the response back into the Poppy system from your provider extension.
- Start building your provider driver.
- Make frequent and small commits and patches.
- Add unit tests and functional tests for your driver.
- For each provider function, map the appropriate calls to your API. For a matrix of terms, please read here.
- creating a new service (domains, origins, ttl's, restrictions)
- updating a service (domains, origins, ttl's, restrictions)
- deleting a service
- purging content for the whole site or a specific path
- Add an entry point in setup.cfg so that Poppy recognizes your wonderful new driver and operators can start to use it.
Participating in the API Design Process
- Join the #openstack-poppy channel where the team hangs out and participate in design discussions
- Join and participate in the weekly Poppy meeting every Thursday : Meetings/Poppy
- Contribute Blueprints for potential features that you think need to be incorporated into the Poppy API