Difference between revisions of "Poppy/Provider - Getting Started"
< Poppy
Amit Gandhi (talk | contribs) (→Building Your Provider Driver) |
Amit Gandhi (talk | contribs) (→Building Your Provider Driver) |
||
Line 10: | Line 10: | ||
# Get familiar with the [https://github.com/stackforge/poppy/blob/master/poppy/model/service.py 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 [https://github.com/stackforge/poppy/blob/master/poppy/model/service.py 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 [https://github.com/stackforge/poppy/blob/master/poppy/provider/base/responder.py Responder functions]. These functions are called to create the response back into the Poppy system from your provider extension. | # Get familiar with the [https://github.com/stackforge/poppy/blob/master/poppy/provider/base/responder.py 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. Don't forget to add unit tests and functional tests for your driver. | ||
+ | # Add an entry point in [https://github.com/stackforge/poppy/blob/master/setup.cfg setup.cfg] so that Poppy recognizes your wonderful new driver and operators can start to use it. | ||
== Participating in the API Design Process == | == Participating in the API Design Process == |
Revision as of 19:51, 17 October 2014
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. Don't forget to add unit tests and functional tests for your driver.
- 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