)]}'
{"doc/source/devref/contribute.rst":[{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"e8b9eb3e762bd0269a73065485f75ddb88fafd84","unresolved":false,"context_lines":[{"line_number":415,"context_line":"* PyPI: https://pypi.python.org/pypi/networking-cisco"},{"line_number":416,"context_line":""},{"line_number":417,"context_line":""},{"line_number":418,"context_line":"Decomposition Phase II"},{"line_number":419,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":420,"context_line":""},{"line_number":421,"context_line":"(This section currently describes the goals and progress of the second part of"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5afe65bd_a77790d3","line":418,"updated":"2015-06-02 15:39:04.000000000","message":"I agree that it makes sense to have this done in two phases. To this aim it may makes sense to move this section to the top, like in a form of disclaimer, that advertise how the work should be done.","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"c66948de003bc5a96b5bf906706c81322692d5bb","unresolved":false,"context_lines":[{"line_number":415,"context_line":"* PyPI: https://pypi.python.org/pypi/networking-cisco"},{"line_number":416,"context_line":""},{"line_number":417,"context_line":""},{"line_number":418,"context_line":"Decomposition Phase II"},{"line_number":419,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":420,"context_line":""},{"line_number":421,"context_line":"(This section currently describes the goals and progress of the second part of"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1af86dd1_8f54b854","line":418,"in_reply_to":"5afe65bd_a77790d3","updated":"2015-06-16 04:40:02.000000000","message":"Done","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"5a0093fb310997ef2b77484e146db4fe270fbf58","unresolved":false,"context_lines":[{"line_number":422,"context_line":"the decomposition work during the Liberty development cycle. The content here"},{"line_number":423,"context_line":"will be updated as the work progresses. In its final form this section will be"},{"line_number":424,"context_line":"merged with the previous section. When all existing plugins/drivers are fully"},{"line_number":425,"context_line":"decomposed, this document will be a recipe for how to add a new out-of-tree"},{"line_number":426,"context_line":"plugin or driver to Neutron.)"},{"line_number":427,"context_line":""},{"line_number":428,"context_line":"During the Kilo cycle, plugins and drivers were decomposed but they still have"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5afe65bd_c7149a45","line":425,"updated":"2015-06-03 01:33:14.000000000","message":"once that\u0027s done, they will no longer decomposed but simply out of tree :)","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"c66948de003bc5a96b5bf906706c81322692d5bb","unresolved":false,"context_lines":[{"line_number":422,"context_line":"the decomposition work during the Liberty development cycle. The content here"},{"line_number":423,"context_line":"will be updated as the work progresses. In its final form this section will be"},{"line_number":424,"context_line":"merged with the previous section. When all existing plugins/drivers are fully"},{"line_number":425,"context_line":"decomposed, this document will be a recipe for how to add a new out-of-tree"},{"line_number":426,"context_line":"plugin or driver to Neutron.)"},{"line_number":427,"context_line":""},{"line_number":428,"context_line":"During the Kilo cycle, plugins and drivers were decomposed but they still have"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1af86dd1_af5e5474","line":425,"in_reply_to":"5afe65bd_c7149a45","updated":"2015-06-16 04:40:02.000000000","message":"Done","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"5a0093fb310997ef2b77484e146db4fe270fbf58","unresolved":false,"context_lines":[{"line_number":428,"context_line":"During the Kilo cycle, plugins and drivers were decomposed but they still have"},{"line_number":429,"context_line":"their database models in the neutron tree. Many of them also still have their"},{"line_number":430,"context_line":"configuration example files still in-tree. For the Liberty cycle we aim to"},{"line_number":431,"context_line":"move the models and configurations out of tree."},{"line_number":432,"context_line":""},{"line_number":433,"context_line":"Configuration Files"},{"line_number":434,"context_line":"-------------------"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5afe65bd_873582db","line":431,"updated":"2015-06-03 01:33:14.000000000","message":"and API extensions.","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"c66948de003bc5a96b5bf906706c81322692d5bb","unresolved":false,"context_lines":[{"line_number":428,"context_line":"During the Kilo cycle, plugins and drivers were decomposed but they still have"},{"line_number":429,"context_line":"their database models in the neutron tree. Many of them also still have their"},{"line_number":430,"context_line":"configuration example files still in-tree. For the Liberty cycle we aim to"},{"line_number":431,"context_line":"move the models and configurations out of tree."},{"line_number":432,"context_line":""},{"line_number":433,"context_line":"Configuration Files"},{"line_number":434,"context_line":"-------------------"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa32b979_ce0ffd86","line":431,"in_reply_to":"5afe65bd_873582db","updated":"2015-06-16 04:40:02.000000000","message":"Created a section for API extensions.","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":10980,"name":"Doug Wiegley","email":"dougwig@parkside.io","username":"dougw"},"change_message_id":"8cb04b965b483372a7261ff9e561c798b77efec4","unresolved":false,"context_lines":[{"line_number":436,"context_line":"The configuration files have no dependencies and can simply be moved. The"},{"line_number":437,"context_line":"maintainers should add their configuration file(s) to their repo and then"},{"line_number":438,"context_line":"remove them from neutron. If the in-tree shim refers to configuration items"},{"line_number":439,"context_line":"then this code should be moved out of tree too."},{"line_number":440,"context_line":""},{"line_number":441,"context_line":"Database Models"},{"line_number":442,"context_line":"---------------"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5afe65bd_4158b1fa","line":439,"updated":"2015-06-02 15:03:51.000000000","message":"There is a namespace issue here, as well as in the database.  oslo.config will load sections from any file, so a section of [appliance] existing in multiple files will collide.  Perhaps a prefix in their sections?","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":6659,"name":"Paul Michali","email":"pc@michali.net","username":"pcm"},"change_message_id":"0cae88d5c4fad94021213d93434b714f8cc2b8b3","unresolved":false,"context_lines":[{"line_number":436,"context_line":"The configuration files have no dependencies and can simply be moved. The"},{"line_number":437,"context_line":"maintainers should add their configuration file(s) to their repo and then"},{"line_number":438,"context_line":"remove them from neutron. If the in-tree shim refers to configuration items"},{"line_number":439,"context_line":"then this code should be moved out of tree too."},{"line_number":440,"context_line":""},{"line_number":441,"context_line":"Database Models"},{"line_number":442,"context_line":"---------------"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5afe65bd_830fc3e0","line":439,"in_reply_to":"5afe65bd_4158b1fa","updated":"2015-06-02 19:00:18.000000000","message":"+1","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"5a0093fb310997ef2b77484e146db4fe270fbf58","unresolved":false,"context_lines":[{"line_number":436,"context_line":"The configuration files have no dependencies and can simply be moved. The"},{"line_number":437,"context_line":"maintainers should add their configuration file(s) to their repo and then"},{"line_number":438,"context_line":"remove them from neutron. If the in-tree shim refers to configuration items"},{"line_number":439,"context_line":"then this code should be moved out of tree too."},{"line_number":440,"context_line":""},{"line_number":441,"context_line":"Database Models"},{"line_number":442,"context_line":"---------------"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5afe65bd_6747264c","line":439,"in_reply_to":"5afe65bd_4158b1fa","updated":"2015-06-03 01:33:14.000000000","message":"this problem can exist today, especially in ML2. The action of taking them out is not exposing this issue, or am I missing something?","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"c66948de003bc5a96b5bf906706c81322692d5bb","unresolved":false,"context_lines":[{"line_number":436,"context_line":"The configuration files have no dependencies and can simply be moved. The"},{"line_number":437,"context_line":"maintainers should add their configuration file(s) to their repo and then"},{"line_number":438,"context_line":"remove them from neutron. If the in-tree shim refers to configuration items"},{"line_number":439,"context_line":"then this code should be moved out of tree too."},{"line_number":440,"context_line":""},{"line_number":441,"context_line":"Database Models"},{"line_number":442,"context_line":"---------------"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1af86dd1_cf599090","line":439,"in_reply_to":"5afe65bd_6747264c","updated":"2015-06-16 04:40:02.000000000","message":"Added words of warning.","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":8124,"name":"cbrandily","email":"zzelle@gmail.com","username":"cbrandily"},"change_message_id":"0f1d2a35201c6802b28c559b5a121604a59d9449","unresolved":false,"context_lines":[{"line_number":437,"context_line":"maintainers should add their configuration file(s) to their repo and then"},{"line_number":438,"context_line":"remove them from neutron. If the in-tree shim refers to configuration items"},{"line_number":439,"context_line":"then this code should be moved out of tree too."},{"line_number":440,"context_line":""},{"line_number":441,"context_line":"Database Models"},{"line_number":442,"context_line":"---------------"},{"line_number":443,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"3afb71cf_142979e6","line":440,"updated":"2015-06-09 11:40:13.000000000","message":"Should we add a section about moving endpoints from neutron setup.cfg to out-of -tree component setup.cfg?","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"c66948de003bc5a96b5bf906706c81322692d5bb","unresolved":false,"context_lines":[{"line_number":437,"context_line":"maintainers should add their configuration file(s) to their repo and then"},{"line_number":438,"context_line":"remove them from neutron. If the in-tree shim refers to configuration items"},{"line_number":439,"context_line":"then this code should be moved out of tree too."},{"line_number":440,"context_line":""},{"line_number":441,"context_line":"Database Models"},{"line_number":442,"context_line":"---------------"},{"line_number":443,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa32b979_d1a800de","line":440,"in_reply_to":"3afb71cf_142979e6","updated":"2015-06-16 04:40:02.000000000","message":"Done","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":9361,"name":"Vivekanandan Narasimhan","email":"n.vivekanandan@ericsson.com","username":"viveknarasimhan"},"change_message_id":"72d035ffe27a8c114a516742a82e0d3d284a070a","unresolved":false,"context_lines":[{"line_number":444,"context_line":"Each decomposed plugin/driver that has its own tables in the neutron database"},{"line_number":445,"context_line":"should take these steps to move the models for the tables out of tree."},{"line_number":446,"context_line":""},{"line_number":447,"context_line":"#. Add the models to the plugin/driver repo."},{"line_number":448,"context_line":"#. Create a start migration for the repo\u0027s alembic branch."},{"line_number":449,"context_line":"#. Remove the plugin/driver models from the neutron repo."},{"line_number":450,"context_line":"#. Add the names of the removed tables to ``DRIVER_TABLES`` in"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5afe65bd_5afad7be","line":447,"updated":"2015-06-02 16:17:49.000000000","message":"Can you please confirm here that the mech-drivers that are neutron in-tree today as of Kilo, would need to be moved to their own repos?\n\nAnd also do we as part of that movement, move the models and the db migration scripts (which create/drop tables) to the respective plugin/driver repo\u0027s alembic_migrations folder?","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"c66948de003bc5a96b5bf906706c81322692d5bb","unresolved":false,"context_lines":[{"line_number":444,"context_line":"Each decomposed plugin/driver that has its own tables in the neutron database"},{"line_number":445,"context_line":"should take these steps to move the models for the tables out of tree."},{"line_number":446,"context_line":""},{"line_number":447,"context_line":"#. Add the models to the plugin/driver repo."},{"line_number":448,"context_line":"#. Create a start migration for the repo\u0027s alembic branch."},{"line_number":449,"context_line":"#. Remove the plugin/driver models from the neutron repo."},{"line_number":450,"context_line":"#. Add the names of the removed tables to ``DRIVER_TABLES`` in"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa32b979_31e84c10","line":447,"in_reply_to":"3afb71cf_14ea99db","updated":"2015-06-16 04:40:02.000000000","message":"I hope my update starts to make things a little clearer. I don\u0027t know how far into the territory of installation manual we want to go here in the devref. But please keep asking questions.","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":1689,"name":"Robert Kukura","email":"rk@theep.net","username":"rkukura"},"change_message_id":"3b129200f98c5cf58c50a580ef7387576d9a4b83","unresolved":false,"context_lines":[{"line_number":444,"context_line":"Each decomposed plugin/driver that has its own tables in the neutron database"},{"line_number":445,"context_line":"should take these steps to move the models for the tables out of tree."},{"line_number":446,"context_line":""},{"line_number":447,"context_line":"#. Add the models to the plugin/driver repo."},{"line_number":448,"context_line":"#. Create a start migration for the repo\u0027s alembic branch."},{"line_number":449,"context_line":"#. Remove the plugin/driver models from the neutron repo."},{"line_number":450,"context_line":"#. Add the names of the removed tables to ``DRIVER_TABLES`` in"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3afb71cf_e56d2699","line":447,"in_reply_to":"3afb71cf_4db8aae5","updated":"2015-06-08 21:18:59.000000000","message":"Drew, for an ML2 driver in a different repo, that repo\u0027s setup.py/setup.cfg would need to list the driver\u0027s entrypoint in the neutron.ml2.type_drivers, neutron.ml2.mechanism_drivers, or neutron.ml2.extension_drivers namespace. My understanding is that the entrypoints exported by all installed python packages get merged together at runtime into these namespaces.","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":8190,"name":"Drew Thorstensen (thorst)","email":"thorst@us.ibm.com","username":"thorst"},"change_message_id":"a09c235a95ad438aa00e0506f373514f74245a61","unresolved":false,"context_lines":[{"line_number":444,"context_line":"Each decomposed plugin/driver that has its own tables in the neutron database"},{"line_number":445,"context_line":"should take these steps to move the models for the tables out of tree."},{"line_number":446,"context_line":""},{"line_number":447,"context_line":"#. Add the models to the plugin/driver repo."},{"line_number":448,"context_line":"#. Create a start migration for the repo\u0027s alembic branch."},{"line_number":449,"context_line":"#. Remove the plugin/driver models from the neutron repo."},{"line_number":450,"context_line":"#. Add the names of the removed tables to ``DRIVER_TABLES`` in"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3afb71cf_14ea99db","line":447,"in_reply_to":"3afb71cf_e56d2699","updated":"2015-06-09 11:34:45.000000000","message":"So, that is what we\u0027ve done for now.  However, I my concern surrounding that is with the operator.\n\nOn the node where the Neutron Server is running, I would think the operator expectation is to install the Neutron Server (and perhaps some non-L2 agents).  Then on the compute nodes, install the ML2 agents themselves - which would be StackForge projects.\n\nBut if the StackForge project has the neutron.ml2.mechanism_drivers/type_drivers defined in its setup.py, does that lead to the following?\n\n- The operator needs to install the StackForge project on both the neutron server (to register the mechanism driver) and on the agent (understandable).\n- In a multi-hypervisor environment, would multiple \u0027agent\u0027 projects need to be installed on the Neutron Server node.  And if so, would each setup.py overwrite the previous neutron.ml2.mechanism_drivers/type_drivers definition?\n\nMy concern there (and I personally just don\u0027t know if this works or not) is if I install the PowerVM agent, I don\u0027t want to blast away the ability to use OVS or Linux Bridge agent within the same Neutron Server.  Is that not going to be an issue?\n\nThanks!","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":8190,"name":"Drew Thorstensen (thorst)","email":"thorst@us.ibm.com","username":"thorst"},"change_message_id":"8574680f423d1bc6a4bfef2514db5862c10e7a82","unresolved":false,"context_lines":[{"line_number":444,"context_line":"Each decomposed plugin/driver that has its own tables in the neutron database"},{"line_number":445,"context_line":"should take these steps to move the models for the tables out of tree."},{"line_number":446,"context_line":""},{"line_number":447,"context_line":"#. Add the models to the plugin/driver repo."},{"line_number":448,"context_line":"#. Create a start migration for the repo\u0027s alembic branch."},{"line_number":449,"context_line":"#. Remove the plugin/driver models from the neutron repo."},{"line_number":450,"context_line":"#. Add the names of the removed tables to ``DRIVER_TABLES`` in"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3afb71cf_4db8aae5","line":447,"in_reply_to":"5afe65bd_479c2ac0","updated":"2015-06-08 18:42:30.000000000","message":"It is not clear to me specifically how the mechanism drivers are moved (or removed) with this proposal.  Currently they\u0027re all stored in neutron/plugins/ml2/drivers/... and then referenced in the setup.py\n\nThe comment states that this would go away, but its not clear to me how this goes away.   What changes are required in the StackForge decomposed project to get the plugin to recognize the agent?\n\nI ask because I am working on a new ML2 agent for the PowerVM hypervisor.  The agent code itself is in StackForge (http://git.openstack.org/cgit/stackforge/neutron-powervm/).  I\u0027m trying to determine if my mechanism driver needs to:\n- go in neutron\n- go into our StackForge project\u0027s setup.py\n- Is no longer needed\n\nCan you help clarify?  Based on the comment I\u0027m assuming its the last?","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"5a0093fb310997ef2b77484e146db4fe270fbf58","unresolved":false,"context_lines":[{"line_number":444,"context_line":"Each decomposed plugin/driver that has its own tables in the neutron database"},{"line_number":445,"context_line":"should take these steps to move the models for the tables out of tree."},{"line_number":446,"context_line":""},{"line_number":447,"context_line":"#. Add the models to the plugin/driver repo."},{"line_number":448,"context_line":"#. Create a start migration for the repo\u0027s alembic branch."},{"line_number":449,"context_line":"#. Remove the plugin/driver models from the neutron repo."},{"line_number":450,"context_line":"#. Add the names of the removed tables to ``DRIVER_TABLES`` in"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5afe65bd_479c2ac0","line":447,"in_reply_to":"5afe65bd_5afad7be","updated":"2015-06-03 01:33:14.000000000","message":"The step to be taken here is that the \u0027shim\u0027 that today exist in the Neutron tree will simply go away. As for the DB migration scripts, the existing ones will stay. They are usually considered immutable once a release is cut and I see no reason why we would to move them out, especially when migrating from multiple branches is doable.","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":6659,"name":"Paul Michali","email":"pc@michali.net","username":"pcm"},"change_message_id":"0cae88d5c4fad94021213d93434b714f8cc2b8b3","unresolved":false,"context_lines":[{"line_number":448,"context_line":"#. Create a start migration for the repo\u0027s alembic branch."},{"line_number":449,"context_line":"#. Remove the plugin/driver models from the neutron repo."},{"line_number":450,"context_line":"#. Add the names of the removed tables to ``DRIVER_TABLES`` in"},{"line_number":451,"context_line":"   ``neutron/db/migration/alembic_migrations/external.py``"},{"line_number":452,"context_line":""},{"line_number":453,"context_line":"**ToDo: Automatically run all migration branches**"},{"line_number":454,"context_line":"    We aim to update the ``neutron-db-manage`` alembic script for neutron so"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5afe65bd_23cfef57","line":451,"updated":"2015-06-02 19:00:18.000000000","message":"After reading further, I see that this will be used in testing (L473). May want to mention here, why saving a list of the tables removed.","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"c66948de003bc5a96b5bf906706c81322692d5bb","unresolved":false,"context_lines":[{"line_number":448,"context_line":"#. Create a start migration for the repo\u0027s alembic branch."},{"line_number":449,"context_line":"#. Remove the plugin/driver models from the neutron repo."},{"line_number":450,"context_line":"#. Add the names of the removed tables to ``DRIVER_TABLES`` in"},{"line_number":451,"context_line":"   ``neutron/db/migration/alembic_migrations/external.py``"},{"line_number":452,"context_line":""},{"line_number":453,"context_line":"**ToDo: Automatically run all migration branches**"},{"line_number":454,"context_line":"    We aim to update the ``neutron-db-manage`` alembic script for neutron so"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa32b979_113bc89d","line":451,"in_reply_to":"5afe65bd_23cfef57","updated":"2015-06-16 04:40:02.000000000","message":"Done","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":10980,"name":"Doug Wiegley","email":"dougwig@parkside.io","username":"dougw"},"change_message_id":"8cb04b965b483372a7261ff9e561c798b77efec4","unresolved":false,"context_lines":[{"line_number":449,"context_line":"#. Remove the plugin/driver models from the neutron repo."},{"line_number":450,"context_line":"#. Add the names of the removed tables to ``DRIVER_TABLES`` in"},{"line_number":451,"context_line":"   ``neutron/db/migration/alembic_migrations/external.py``"},{"line_number":452,"context_line":""},{"line_number":453,"context_line":"**ToDo: Automatically run all migration branches**"},{"line_number":454,"context_line":"    We aim to update the ``neutron-db-manage`` alembic script for neutron so"},{"line_number":455,"context_line":"    that it can read the neutron configuration information to determine which"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5afe65bd_610a8dd4","line":452,"updated":"2015-06-02 15:03:51.000000000","message":"Suggest a prefix on database table names. Don\u0027t need two vendors deciding to use \"switches\" or something similarly generic.","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"c66948de003bc5a96b5bf906706c81322692d5bb","unresolved":false,"context_lines":[{"line_number":449,"context_line":"#. Remove the plugin/driver models from the neutron repo."},{"line_number":450,"context_line":"#. Add the names of the removed tables to ``DRIVER_TABLES`` in"},{"line_number":451,"context_line":"   ``neutron/db/migration/alembic_migrations/external.py``"},{"line_number":452,"context_line":""},{"line_number":453,"context_line":"**ToDo: Automatically run all migration branches**"},{"line_number":454,"context_line":"    We aim to update the ``neutron-db-manage`` alembic script for neutron so"},{"line_number":455,"context_line":"    that it can read the neutron configuration information to determine which"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1af86dd1_0f4a0884","line":452,"in_reply_to":"5afe65bd_610a8dd4","updated":"2015-06-16 04:40:02.000000000","message":"Done","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"c66948de003bc5a96b5bf906706c81322692d5bb","unresolved":false,"context_lines":[{"line_number":449,"context_line":"#. Remove the plugin/driver models from the neutron repo."},{"line_number":450,"context_line":"#. Add the names of the removed tables to ``DRIVER_TABLES`` in"},{"line_number":451,"context_line":"   ``neutron/db/migration/alembic_migrations/external.py``"},{"line_number":452,"context_line":""},{"line_number":453,"context_line":"**ToDo: Automatically run all migration branches**"},{"line_number":454,"context_line":"    We aim to update the ``neutron-db-manage`` alembic script for neutron so"},{"line_number":455,"context_line":"    that it can read the neutron configuration information to determine which"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa32b979_714c9442","line":452,"in_reply_to":"5afe65bd_610a8dd4","updated":"2015-06-16 04:40:02.000000000","message":"Done","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":1561,"name":"Russell Bryant","email":"rbryant@redhat.com","username":"russellb"},"change_message_id":"3790c35c68aec2efc02a4d23bb398fc906434126","unresolved":false,"context_lines":[{"line_number":449,"context_line":"#. Remove the plugin/driver models from the neutron repo."},{"line_number":450,"context_line":"#. Add the names of the removed tables to ``DRIVER_TABLES`` in"},{"line_number":451,"context_line":"   ``neutron/db/migration/alembic_migrations/external.py``"},{"line_number":452,"context_line":""},{"line_number":453,"context_line":"**ToDo: Automatically run all migration branches**"},{"line_number":454,"context_line":"    We aim to update the ``neutron-db-manage`` alembic script for neutron so"},{"line_number":455,"context_line":"    that it can read the neutron configuration information to determine which"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5afe65bd_c1e5c1a8","line":452,"in_reply_to":"5afe65bd_610a8dd4","updated":"2015-06-02 15:11:44.000000000","message":"What about a push to put anything that isn\u0027t generic in its own database?  I know it\u0027s like it is for historical reasons, but it seems wrong to have anything vendor specific in the neutron db.","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"5a0093fb310997ef2b77484e146db4fe270fbf58","unresolved":false,"context_lines":[{"line_number":449,"context_line":"#. Remove the plugin/driver models from the neutron repo."},{"line_number":450,"context_line":"#. Add the names of the removed tables to ``DRIVER_TABLES`` in"},{"line_number":451,"context_line":"   ``neutron/db/migration/alembic_migrations/external.py``"},{"line_number":452,"context_line":""},{"line_number":453,"context_line":"**ToDo: Automatically run all migration branches**"},{"line_number":454,"context_line":"    We aim to update the ``neutron-db-manage`` alembic script for neutron so"},{"line_number":455,"context_line":"    that it can read the neutron configuration information to determine which"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5afe65bd_27edae25","line":452,"in_reply_to":"5afe65bd_c1e5c1a8","updated":"2015-06-03 01:33:14.000000000","message":"Having its own database may complicate cases where there are foreign keys constraints across schemas for DBMS that do not support this well.\n\nAs like for the config namespace, I too think this isn\u0027t a problem exposed by the decomp per se. One will end up knowing about a name clash during staging/testing/validation and rectify the problem. We can surely promote a convention that mitigate the issue, but other than that I think we\u0027re good.","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":7249,"name":"Ann Taraday","email":"akamyshnikova@mirantis.com","username":"AKamyshnikova"},"change_message_id":"dcb42c52194e1a9a9c7b37355b941849ba6913bb","unresolved":false,"context_lines":[{"line_number":465,"context_line":"    If a driver\u0027s table has a reference (for example a foreign key) to a"},{"line_number":466,"context_line":"    neutron core table, and the referred item is changed in neutron, what"},{"line_number":467,"context_line":"    should we do? (This should be a rare occurrence - perhaps we can address"},{"line_number":468,"context_line":"    it on a case-by-case basis?)"},{"line_number":469,"context_line":""},{"line_number":470,"context_line":"Testing"},{"line_number":471,"context_line":"^^^^^^^"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5afe65bd_30bbd3c6","line":468,"updated":"2015-06-02 07:51:52.000000000","message":"I think we should have tests that will run migrations for neutron core and than for each separate branch, so if something like this occur, migration in branch should be changed according to new foreign key, etc. And I agree that such cases will happen rarely, so we should fix each case separately.\n\nMay be it is good to have a person who will check if new migration in neutron core can affect some tables in plugins branches and provide comments or quick fix for that.","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":9361,"name":"Vivekanandan Narasimhan","email":"n.vivekanandan@ericsson.com","username":"viveknarasimhan"},"change_message_id":"72d035ffe27a8c114a516742a82e0d3d284a070a","unresolved":false,"context_lines":[{"line_number":465,"context_line":"    If a driver\u0027s table has a reference (for example a foreign key) to a"},{"line_number":466,"context_line":"    neutron core table, and the referred item is changed in neutron, what"},{"line_number":467,"context_line":"    should we do? (This should be a rare occurrence - perhaps we can address"},{"line_number":468,"context_line":"    it on a case-by-case basis?)"},{"line_number":469,"context_line":""},{"line_number":470,"context_line":"Testing"},{"line_number":471,"context_line":"^^^^^^^"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5afe65bd_fad8631f","line":468,"in_reply_to":"5afe65bd_30bbd3c6","updated":"2015-06-02 16:17:49.000000000","message":"+1.\n\nWe should provide in-tree migration tests that would identify breakage of table links, when patchset touches core neutron tables referred by other tables out that will reside out of the core tree (ie., in the driver repo).","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"c66948de003bc5a96b5bf906706c81322692d5bb","unresolved":false,"context_lines":[{"line_number":465,"context_line":"    If a driver\u0027s table has a reference (for example a foreign key) to a"},{"line_number":466,"context_line":"    neutron core table, and the referred item is changed in neutron, what"},{"line_number":467,"context_line":"    should we do? (This should be a rare occurrence - perhaps we can address"},{"line_number":468,"context_line":"    it on a case-by-case basis?)"},{"line_number":469,"context_line":""},{"line_number":470,"context_line":"Testing"},{"line_number":471,"context_line":"^^^^^^^"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa32b979_51ff10aa","line":468,"in_reply_to":"5afe65bd_30bbd3c6","updated":"2015-06-16 04:40:02.000000000","message":"I am not sure I understand exactly what you meant here? From the neutron core repo we don\u0027t know of out-of-tree branches, so we can\u0027t test from the neutron repo. I added a recommendation that vendors should set up periodic testing in their own repos.","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":7249,"name":"Ann Taraday","email":"akamyshnikova@mirantis.com","username":"AKamyshnikova"},"change_message_id":"0491f14f60d4ee65217b2b82dd812af78131f2b3","unresolved":false,"context_lines":[{"line_number":465,"context_line":"    If a driver\u0027s table has a reference (for example a foreign key) to a"},{"line_number":466,"context_line":"    neutron core table, and the referred item is changed in neutron, what"},{"line_number":467,"context_line":"    should we do? (This should be a rare occurrence - perhaps we can address"},{"line_number":468,"context_line":"    it on a case-by-case basis?)"},{"line_number":469,"context_line":""},{"line_number":470,"context_line":"Testing"},{"line_number":471,"context_line":"^^^^^^^"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa32b979_dd9480e3","line":468,"in_reply_to":"fa32b979_51ff10aa","updated":"2015-06-16 12:52:31.000000000","message":"Yes, this is what I meant.","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"5a0093fb310997ef2b77484e146db4fe270fbf58","unresolved":false,"context_lines":[{"line_number":482,"context_line":"Other repo-split items"},{"line_number":483,"context_line":"----------------------"},{"line_number":484,"context_line":""},{"line_number":485,"context_line":"(These are still TBD.)"},{"line_number":486,"context_line":""},{"line_number":487,"context_line":"* Splitting policy.json?"},{"line_number":488,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"5afe65bd_47d1ca56","line":485,"updated":"2015-06-03 01:33:14.000000000","message":"I\u0027d love to see more on this, ping me if you want to bounce a few ideas.","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":6659,"name":"Paul Michali","email":"pc@michali.net","username":"pcm"},"change_message_id":"0cae88d5c4fad94021213d93434b714f8cc2b8b3","unresolved":false,"context_lines":[{"line_number":486,"context_line":""},{"line_number":487,"context_line":"* Splitting policy.json?"},{"line_number":488,"context_line":""},{"line_number":489,"context_line":"* Splitting extensions (or extensions to extenstion) to the API?"},{"line_number":490,"context_line":""},{"line_number":491,"context_line":"* Generic instructions (or a template) for installing an out-of-tree plugin or"},{"line_number":492,"context_line":"  driver for Neutron. Possibly something for the networking guide, and/or a"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5afe65bd_43730b81","line":489,"updated":"2015-06-02 19:00:18.000000000","message":"nit: 3rd occurrence. extenstion -\u003e extension","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":9361,"name":"Vivekanandan Narasimhan","email":"n.vivekanandan@ericsson.com","username":"viveknarasimhan"},"change_message_id":"72d035ffe27a8c114a516742a82e0d3d284a070a","unresolved":false,"context_lines":[{"line_number":491,"context_line":"* Generic instructions (or a template) for installing an out-of-tree plugin or"},{"line_number":492,"context_line":"  driver for Neutron. Possibly something for the networking guide, and/or a"},{"line_number":493,"context_line":"  template that plugin/driver maintainers can modify and include with their"},{"line_number":494,"context_line":"  package."},{"line_number":495,"context_line":""},{"line_number":496,"context_line":""},{"line_number":497,"context_line":"Decomposition Phase II Progress Chart"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5afe65bd_9a83afcc","line":494,"updated":"2015-06-02 16:17:49.000000000","message":"For new mechanism driver contributors in Liberty release, would they need to contribute their code out of tree and then abide by instructions in this doc to integrate with Neutron?","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":105,"name":"Kyle Mestery","email":"mestery@mestery.com","username":"mestery"},"change_message_id":"10d390316cb5693a79c1a8d029e0fd8e4361b245","unresolved":false,"context_lines":[{"line_number":491,"context_line":"* Generic instructions (or a template) for installing an out-of-tree plugin or"},{"line_number":492,"context_line":"  driver for Neutron. Possibly something for the networking guide, and/or a"},{"line_number":493,"context_line":"  template that plugin/driver maintainers can modify and include with their"},{"line_number":494,"context_line":"  package."},{"line_number":495,"context_line":""},{"line_number":496,"context_line":""},{"line_number":497,"context_line":"Decomposition Phase II Progress Chart"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5afe65bd_277daee7","line":494,"in_reply_to":"5afe65bd_9a83afcc","updated":"2015-06-03 01:51:46.000000000","message":"Yes, we\u0027re not accepting new drivers which do not come in pre-decomposed.","commit_id":"d3ce4954cefe82c216301cd14d1fcf544040cb80"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"243cc9b020fd8d04ce3fa18441e056d1b07d2a0c","unresolved":false,"context_lines":[{"line_number":364,"context_line":"  `3rd Party CI \u003chttp://docs.openstack.org/infra/system-config/third_party.html\u003e`_ to get one."},{"line_number":365,"context_line":"* TODO(armax): ..."},{"line_number":366,"context_line":""},{"line_number":367,"context_line":""},{"line_number":368,"context_line":"Decomposition of 3rd Party Code"},{"line_number":369,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":370,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa32b979_a337f5fd","line":367,"updated":"2015-06-23 17:22:46.000000000","message":"Agree. When I read this document from the top [1], I felt the same. I first see \"Development Strategy\" which describes the direction of phase-1 decomposition. It is better to update \"Development Strategy\" section to match phase-2 policy.\n\n[1] http://docs-draft.openstack.org/67/187267/2/check/gate-neutron-docs/b8853e9//doc/build/html/devref/contribute.html","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"912a42b26865ccfd65844f67513b39a424736fd2","unresolved":false,"context_lines":[{"line_number":364,"context_line":"  `3rd Party CI \u003chttp://docs.openstack.org/infra/system-config/third_party.html\u003e`_ to get one."},{"line_number":365,"context_line":"* TODO(armax): ..."},{"line_number":366,"context_line":""},{"line_number":367,"context_line":""},{"line_number":368,"context_line":"Decomposition of 3rd Party Code"},{"line_number":369,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":370,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba3cc151_29ee60b4","line":367,"in_reply_to":"fa32b979_a337f5fd","updated":"2015-07-01 19:28:08.000000000","message":"Done","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"eaf4b32a40d21114ae6234ee53b8bdaa9fe2f4be","unresolved":false,"context_lines":[{"line_number":365,"context_line":"* TODO(armax): ..."},{"line_number":366,"context_line":""},{"line_number":367,"context_line":""},{"line_number":368,"context_line":"Decomposition of 3rd Party Code"},{"line_number":369,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":370,"context_line":""},{"line_number":371,"context_line":"Plugins and drivers for non-reference implementations are known as \"Third"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa32b979_aeae1283","line":368,"updated":"2015-06-16 19:03:45.000000000","message":"I wonder if this part should go all the way up and be called \u0027Preamble\u0027, or \u0027The facts you need to know before you keep on reading!\u0027","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"912a42b26865ccfd65844f67513b39a424736fd2","unresolved":false,"context_lines":[{"line_number":365,"context_line":"* TODO(armax): ..."},{"line_number":366,"context_line":""},{"line_number":367,"context_line":""},{"line_number":368,"context_line":"Decomposition of 3rd Party Code"},{"line_number":369,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":370,"context_line":""},{"line_number":371,"context_line":"Plugins and drivers for non-reference implementations are known as \"Third"}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba3cc151_c92d74ff","line":368,"in_reply_to":"fa32b979_aeae1283","updated":"2015-07-01 19:28:08.000000000","message":"Done","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"eaf4b32a40d21114ae6234ee53b8bdaa9fe2f4be","unresolved":false,"context_lines":[{"line_number":384,"context_line":"described below in `Decomposition Phase 2`_."},{"line_number":385,"context_line":""},{"line_number":386,"context_line":""},{"line_number":387,"context_line":"Decomposition Phase 1, progress chart"},{"line_number":388,"context_line":"-------------------------------------"},{"line_number":389,"context_line":""},{"line_number":390,"context_line":"The chart below captures the progress of the core-vendor-decomposition effort"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa32b979_81351ff8","line":387,"updated":"2015-06-16 19:03:45.000000000","message":"I\u0027d be tempted to say that we might no longer need this one (which was partially converted in [1]). All the plugins/drivers that are still in the tree in whichever shape should be marked for deprecation at the end of L. In fact for those that haven\u0027t started it might make sense to go straight to phase 2?\n\n[1] https://github.com/openstack/neutron/blob/master/doc/source/devref/sub_projects.rst","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"912a42b26865ccfd65844f67513b39a424736fd2","unresolved":false,"context_lines":[{"line_number":384,"context_line":"described below in `Decomposition Phase 2`_."},{"line_number":385,"context_line":""},{"line_number":386,"context_line":""},{"line_number":387,"context_line":"Decomposition Phase 1, progress chart"},{"line_number":388,"context_line":"-------------------------------------"},{"line_number":389,"context_line":""},{"line_number":390,"context_line":"The chart below captures the progress of the core-vendor-decomposition effort"}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba3cc151_e932b85e","line":387,"in_reply_to":"fa32b979_81351ff8","updated":"2015-07-01 19:28:08.000000000","message":"Done","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"243cc9b020fd8d04ce3fa18441e056d1b07d2a0c","unresolved":false,"context_lines":[{"line_number":384,"context_line":"described below in `Decomposition Phase 2`_."},{"line_number":385,"context_line":""},{"line_number":386,"context_line":""},{"line_number":387,"context_line":"Decomposition Phase 1, progress chart"},{"line_number":388,"context_line":"-------------------------------------"},{"line_number":389,"context_line":""},{"line_number":390,"context_line":"The chart below captures the progress of the core-vendor-decomposition effort"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa32b979_9e0a4a89","line":387,"in_reply_to":"fa32b979_81351ff8","updated":"2015-06-23 17:22:46.000000000","message":"Totally agree.\n\nRegarding deprecation of in-tree remaining plugin at the end of Liberty, we need to declare it more broadly, e.g. sending the announcement to the dev ML. It would reduce the confusion and we can move things forward more smoothly.","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"912a42b26865ccfd65844f67513b39a424736fd2","unresolved":false,"context_lines":[{"line_number":384,"context_line":"described below in `Decomposition Phase 2`_."},{"line_number":385,"context_line":""},{"line_number":386,"context_line":""},{"line_number":387,"context_line":"Decomposition Phase 1, progress chart"},{"line_number":388,"context_line":"-------------------------------------"},{"line_number":389,"context_line":""},{"line_number":390,"context_line":"The chart below captures the progress of the core-vendor-decomposition effort"}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba3cc151_8933ec61","line":387,"in_reply_to":"fa32b979_9e0a4a89","updated":"2015-07-01 19:28:08.000000000","message":"Done","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"243cc9b020fd8d04ce3fa18441e056d1b07d2a0c","unresolved":false,"context_lines":[{"line_number":420,"context_line":"| Name                          |    Plugins/Drivers    | Launchpad |       PyPI       |  State  | Completed in |"},{"line_number":421,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":422,"context_line":"| freescale-nscs                |         ml2,fw        |    no     |       no         |   [D]   |              |"},{"line_number":423,"context_line":"+-------------------------------+-----------------------+-----------+------------------+---------+--------------+"},{"line_number":424,"context_line":""},{"line_number":425,"context_line":""},{"line_number":426,"context_line":"Decomposition Phase 2"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa32b979_3e09be84","line":423,"updated":"2015-06-23 17:22:46.000000000","message":"I think category [D] can be removed too because the current status of plugin decomposition is same among all categories [A] to [D].","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"912a42b26865ccfd65844f67513b39a424736fd2","unresolved":false,"context_lines":[{"line_number":420,"context_line":"| Name                          |    Plugins/Drivers    | Launchpad |       PyPI       |  State  | Completed in |"},{"line_number":421,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":422,"context_line":"| freescale-nscs                |         ml2,fw        |    no     |       no         |   [D]   |              |"},{"line_number":423,"context_line":"+-------------------------------+-----------------------+-----------+------------------+---------+--------------+"},{"line_number":424,"context_line":""},{"line_number":425,"context_line":""},{"line_number":426,"context_line":"Decomposition Phase 2"}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba3cc151_4942c4af","line":423,"in_reply_to":"fa32b979_3e09be84","updated":"2015-07-01 19:28:08.000000000","message":"Done","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":9423,"name":"Roey Chen","email":"roeyc@vmware.com","username":"roeyc"},"change_message_id":"cd19c5c4655f9b78e8b35d38d10148b4124de24d","unresolved":false,"context_lines":[{"line_number":481,"context_line":"    that it can read the neutron configuration information to determine which"},{"line_number":482,"context_line":"    plugins/drivers (and advanced services) are installed. It should then use"},{"line_number":483,"context_line":"    this information to run the alembic branch migrations for all the"},{"line_number":484,"context_line":"    installed components."},{"line_number":485,"context_line":""},{"line_number":486,"context_line":"* Note: After moving to the out-of-tree migration branch, care should be taken"},{"line_number":487,"context_line":"  when adding new tables. To prevent collision of table names it is recommended"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa32b979_6a10a459","line":484,"updated":"2015-06-24 19:25:17.000000000","message":"Should we strict the location where migrations script should be located inside a repo? e.g - myplugin/db/migrations or myplugin/neutron/db/migrations, it would make the update of \u0027neutron-db-manage\u0027 simpler.\n\nGenerally, having a unified repo structure for all plugins might be helpful in packaging (I\u0027m assuming).","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"912a42b26865ccfd65844f67513b39a424736fd2","unresolved":false,"context_lines":[{"line_number":481,"context_line":"    that it can read the neutron configuration information to determine which"},{"line_number":482,"context_line":"    plugins/drivers (and advanced services) are installed. It should then use"},{"line_number":483,"context_line":"    this information to run the alembic branch migrations for all the"},{"line_number":484,"context_line":"    installed components."},{"line_number":485,"context_line":""},{"line_number":486,"context_line":"* Note: After moving to the out-of-tree migration branch, care should be taken"},{"line_number":487,"context_line":"  when adding new tables. To prevent collision of table names it is recommended"}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba3cc151_8c077a17","line":484,"in_reply_to":"fa32b979_6a10a459","updated":"2015-07-01 19:28:08.000000000","message":"Done","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":9423,"name":"Roey Chen","email":"roeyc@vmware.com","username":"roeyc"},"change_message_id":"cd19c5c4655f9b78e8b35d38d10148b4124de24d","unresolved":false,"context_lines":[{"line_number":485,"context_line":""},{"line_number":486,"context_line":"* Note: After moving to the out-of-tree migration branch, care should be taken"},{"line_number":487,"context_line":"  when adding new tables. To prevent collision of table names it is recommended"},{"line_number":488,"context_line":"  to prefix the names witha a vendor string."},{"line_number":489,"context_line":""},{"line_number":490,"context_line":"* Note: A vendor may opt to use a separate database for their tables. This may"},{"line_number":491,"context_line":"  complicate cases where there are foreign key constraints across schemas for"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa32b979_d43159a3","line":488,"updated":"2015-06-24 19:25:17.000000000","message":"s/witha/with\n\nvendor \u003d\u003e vendor/plugin","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"912a42b26865ccfd65844f67513b39a424736fd2","unresolved":false,"context_lines":[{"line_number":485,"context_line":""},{"line_number":486,"context_line":"* Note: After moving to the out-of-tree migration branch, care should be taken"},{"line_number":487,"context_line":"  when adding new tables. To prevent collision of table names it is recommended"},{"line_number":488,"context_line":"  to prefix the names witha a vendor string."},{"line_number":489,"context_line":""},{"line_number":490,"context_line":"* Note: A vendor may opt to use a separate database for their tables. This may"},{"line_number":491,"context_line":"  complicate cases where there are foreign key constraints across schemas for"}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba3cc151_6c13165c","line":488,"in_reply_to":"fa32b979_d43159a3","updated":"2015-07-01 19:28:08.000000000","message":"Done","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"eaf4b32a40d21114ae6234ee53b8bdaa9fe2f4be","unresolved":false,"context_lines":[{"line_number":499,"context_line":"    If a driver\u0027s table has a reference (for example a foreign key) to a"},{"line_number":500,"context_line":"    neutron core table, and the referred item is changed in neutron, what"},{"line_number":501,"context_line":"    should we do? (This should be a rare occurrence - perhaps we can address"},{"line_number":502,"context_line":"    it on a case-by-case basis?)"},{"line_number":503,"context_line":""},{"line_number":504,"context_line":""},{"line_number":505,"context_line":"DB Model/Migration Testing"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa32b979_44a965de","line":502,"updated":"2015-06-16 19:03:45.000000000","message":"Testing should help in mitigate this issue. Changes to the existing core elements should be properly documented and advertised.","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"243cc9b020fd8d04ce3fa18441e056d1b07d2a0c","unresolved":false,"context_lines":[{"line_number":499,"context_line":"    If a driver\u0027s table has a reference (for example a foreign key) to a"},{"line_number":500,"context_line":"    neutron core table, and the referred item is changed in neutron, what"},{"line_number":501,"context_line":"    should we do? (This should be a rare occurrence - perhaps we can address"},{"line_number":502,"context_line":"    it on a case-by-case basis?)"},{"line_number":503,"context_line":""},{"line_number":504,"context_line":""},{"line_number":505,"context_line":"DB Model/Migration Testing"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa32b979_fe26f6cc","line":502,"in_reply_to":"fa32b979_44a965de","updated":"2015-06-23 17:22:46.000000000","message":"For such thing, we can use https://wiki.openstack.org/wiki/Neutron/LibraryAPIBreakage\n\nIt is not easy to me to find the wiki page :-(","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"912a42b26865ccfd65844f67513b39a424736fd2","unresolved":false,"context_lines":[{"line_number":499,"context_line":"    If a driver\u0027s table has a reference (for example a foreign key) to a"},{"line_number":500,"context_line":"    neutron core table, and the referred item is changed in neutron, what"},{"line_number":501,"context_line":"    should we do? (This should be a rare occurrence - perhaps we can address"},{"line_number":502,"context_line":"    it on a case-by-case basis?)"},{"line_number":503,"context_line":""},{"line_number":504,"context_line":""},{"line_number":505,"context_line":"DB Model/Migration Testing"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa32b979_53fe5139","line":502,"in_reply_to":"fa32b979_fe26f6cc","updated":"2015-07-01 19:28:08.000000000","message":"I have filed bug #1470598 to address this.","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"eaf4b32a40d21114ae6234ee53b8bdaa9fe2f4be","unresolved":false,"context_lines":[{"line_number":540,"context_line":""},{"line_number":541,"context_line":"* Note: It is advisable to include ``foo`` in the names of these entry points to"},{"line_number":542,"context_line":"  avoid conflicts with other third party packages that may get installed in the"},{"line_number":543,"context_line":"  same environment."},{"line_number":544,"context_line":""},{"line_number":545,"context_line":""},{"line_number":546,"context_line":"API Extensions"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa32b979_e497598e","line":543,"updated":"2015-06-16 19:03:45.000000000","message":"I\u0027d note that this happen quite frequently already.","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":8190,"name":"Drew Thorstensen (thorst)","email":"thorst@us.ibm.com","username":"thorst"},"change_message_id":"a9425ba011a67e499ad7d0f8f64f38dc29655753","unresolved":false,"context_lines":[{"line_number":540,"context_line":""},{"line_number":541,"context_line":"* Note: It is advisable to include ``foo`` in the names of these entry points to"},{"line_number":542,"context_line":"  avoid conflicts with other third party packages that may get installed in the"},{"line_number":543,"context_line":"  same environment."},{"line_number":544,"context_line":""},{"line_number":545,"context_line":""},{"line_number":546,"context_line":"API Extensions"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa32b979_95f239d1","line":543,"updated":"2015-06-16 20:07:16.000000000","message":"This is a great addition and helps clarify some of my earlier confusion.  Bonus points, we\u0027re on the right track with the PowerVM ML2 agent already.  :-)\n\nOne last concern.  I\u0027m 98% sure I know the answer...but want to verify.\n\nAm I correct in assuming that the decomposed ML2 driver will need to be installed on the Neutron Server system?  This is in addition to the compute node, where the agent is running as well.\n\nI would think so because of the database table discussion above.  I ask because I\u0027m trying to understand what the end operator set up scenario will be.","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":8190,"name":"Drew Thorstensen (thorst)","email":"thorst@us.ibm.com","username":"thorst"},"change_message_id":"5dbda6f91eea7f8095fbfbb502cf266e930db26e","unresolved":false,"context_lines":[{"line_number":540,"context_line":""},{"line_number":541,"context_line":"* Note: It is advisable to include ``foo`` in the names of these entry points to"},{"line_number":542,"context_line":"  avoid conflicts with other third party packages that may get installed in the"},{"line_number":543,"context_line":"  same environment."},{"line_number":544,"context_line":""},{"line_number":545,"context_line":""},{"line_number":546,"context_line":"API Extensions"}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba3cc151_4edba2ec","line":543,"in_reply_to":"fa32b979_8028a434","updated":"2015-07-01 20:25:28.000000000","message":"It does.  Thanks much!","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"243cc9b020fd8d04ce3fa18441e056d1b07d2a0c","unresolved":false,"context_lines":[{"line_number":540,"context_line":""},{"line_number":541,"context_line":"* Note: It is advisable to include ``foo`` in the names of these entry points to"},{"line_number":542,"context_line":"  avoid conflicts with other third party packages that may get installed in the"},{"line_number":543,"context_line":"  same environment."},{"line_number":544,"context_line":""},{"line_number":545,"context_line":""},{"line_number":546,"context_line":"API Extensions"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa32b979_8028a434","line":543,"in_reply_to":"fa32b979_95f239d1","updated":"2015-06-23 17:22:46.000000000","message":"@Drew,\n\nyes, you\u0027re right. All ML2 drivers are loaded by neutron server, so ML2 drivers need to be installed to a server where neutron-server runs.\n\nIf some ML2 driver requires corresponding an L2 agent, the L2 agent needs to be installed to compute nodes and network nodes too.\n\nBy this decomposition work, there is no change from this point of view.\n\nI hope this clarifies your question.","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"eaf4b32a40d21114ae6234ee53b8bdaa9fe2f4be","unresolved":false,"context_lines":[{"line_number":549,"context_line":"All third-party extensions (and extensions to extensions) shall be implemented"},{"line_number":550,"context_line":"out of tree."},{"line_number":551,"context_line":""},{"line_number":552,"context_line":"**ToDo: details on implementing an out-of-tree extension.**"},{"line_number":553,"context_line":""},{"line_number":554,"context_line":""},{"line_number":555,"context_line":"Interface Drivers"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa32b979_24278165","line":552,"updated":"2015-06-16 19:03:45.000000000","message":"It is possible to load extensions on an ad-hoc basis by leveraging the mechanism defined by [1,1a]. Service plugin extensions are loaded via mechanism [2]. However, the action items here is that we need to bless a mechanism for avoiding \u0027hack-ish\u0027 things like done in [3]\n\n[1] https://github.com/openstack/neutron/blob/master/etc/neutron.conf#L49\n[1a] https://github.com/openstack/networking-l2gw/blob/master/networking_l2gw/extensions/l2gateway.py#L26\n[2] https://github.com/openstack/neutron/blob/master/etc/neutron.conf#L78\n[3] https://github.com/openstack/networking-l2gw/blob/master/networking_l2gw/extensions/l2gateway.py#L27-L30","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"912a42b26865ccfd65844f67513b39a424736fd2","unresolved":false,"context_lines":[{"line_number":549,"context_line":"All third-party extensions (and extensions to extensions) shall be implemented"},{"line_number":550,"context_line":"out of tree."},{"line_number":551,"context_line":""},{"line_number":552,"context_line":"**ToDo: details on implementing an out-of-tree extension.**"},{"line_number":553,"context_line":""},{"line_number":554,"context_line":""},{"line_number":555,"context_line":"Interface Drivers"}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba3cc151_0c9e0a63","line":552,"in_reply_to":"fa32b979_24278165","updated":"2015-07-01 19:28:08.000000000","message":"I have included [1] [1a] and [2] as examples. I am leaving the action for [3] to you as we discussed at the mid-cycle.","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":8940,"name":"Sourabh Patwardhan","email":"sopatwar@gmail.com","username":"sopatwar"},"change_message_id":"a64f9ce7fb56a8c18be54434f0cc813c1b0fb94c","unresolved":false,"context_lines":[{"line_number":568,"context_line":"**ToDo: Interface Driver port bindings.**"},{"line_number":569,"context_line":"    These are currently defined by the ``VIF_TYPES`` in"},{"line_number":570,"context_line":"    ``neutron/extensions/portbindings.py``. We should try to make this"},{"line_number":571,"context_line":"    config-driven too."},{"line_number":572,"context_line":""},{"line_number":573,"context_line":""},{"line_number":574,"context_line":"Rootwrap Filters"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa32b979_ab94c4e1","line":571,"updated":"2015-06-16 18:08:20.000000000","message":"Could you elaborate on this ?","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"243cc9b020fd8d04ce3fa18441e056d1b07d2a0c","unresolved":false,"context_lines":[{"line_number":568,"context_line":"**ToDo: Interface Driver port bindings.**"},{"line_number":569,"context_line":"    These are currently defined by the ``VIF_TYPES`` in"},{"line_number":570,"context_line":"    ``neutron/extensions/portbindings.py``. We should try to make this"},{"line_number":571,"context_line":"    config-driven too."},{"line_number":572,"context_line":""},{"line_number":573,"context_line":""},{"line_number":574,"context_line":"Rootwrap Filters"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa32b979_80a18448","line":571,"in_reply_to":"fa32b979_44e165fd","updated":"2015-06-23 17:22:46.000000000","message":"I am not sure if we really need to register VIF type.\n\nAt now, an interface driver is used in two places: neutron agent (like dhcp/l3/lbaas-agent) and nova.\n\nFor neutron agent, we specify an interface driver by an agent config file. There is no problem on this because we keep the current strategy.\n\nFor nova VIF driver,\n- nova determines a appropriate VIF driver based on a value provided by port-binding extension.\n- A vendor driver/plugin can return an arbitrary string if nova has a corresponding VIF driver for the returned value.\n- It means Neutron core is not involved in the interaction with nova.\n- In addition, once VIF script spec in Nova lands, a vendor can fully control VIF driver.","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"912a42b26865ccfd65844f67513b39a424736fd2","unresolved":false,"context_lines":[{"line_number":568,"context_line":"**ToDo: Interface Driver port bindings.**"},{"line_number":569,"context_line":"    These are currently defined by the ``VIF_TYPES`` in"},{"line_number":570,"context_line":"    ``neutron/extensions/portbindings.py``. We should try to make this"},{"line_number":571,"context_line":"    config-driven too."},{"line_number":572,"context_line":""},{"line_number":573,"context_line":""},{"line_number":574,"context_line":"Rootwrap Filters"}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba3cc151_9f0c7a3c","line":571,"in_reply_to":"fa32b979_80a18448","updated":"2015-07-01 19:28:08.000000000","message":"I have changed the ToDo wording to say that Armando and Akihiro will discuss what needs to be done here.","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"eaf4b32a40d21114ae6234ee53b8bdaa9fe2f4be","unresolved":false,"context_lines":[{"line_number":568,"context_line":"**ToDo: Interface Driver port bindings.**"},{"line_number":569,"context_line":"    These are currently defined by the ``VIF_TYPES`` in"},{"line_number":570,"context_line":"    ``neutron/extensions/portbindings.py``. We should try to make this"},{"line_number":571,"context_line":"    config-driven too."},{"line_number":572,"context_line":""},{"line_number":573,"context_line":""},{"line_number":574,"context_line":"Rootwrap Filters"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa32b979_44e165fd","line":571,"in_reply_to":"fa32b979_ab94c4e1","updated":"2015-06-16 19:03:45.000000000","message":"I think we need to expose an API that enables the registration of these drivers on the fly.","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":8940,"name":"Sourabh Patwardhan","email":"sopatwar@gmail.com","username":"sopatwar"},"change_message_id":"a64f9ce7fb56a8c18be54434f0cc813c1b0fb94c","unresolved":false,"context_lines":[{"line_number":580,"context_line":"For example, to add a rootwrap filters for commands in repo ``networking-foo``:"},{"line_number":581,"context_line":""},{"line_number":582,"context_line":"* In the repo, create the file:"},{"line_number":583,"context_line":"  ``etc/neutron/rootwrap.d/foo.filters``"},{"line_number":584,"context_line":""},{"line_number":585,"context_line":"* In the repo\u0027s ``setup.cfg`` add the filters to data_files::"},{"line_number":586,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa32b979_ab7844f3","line":583,"updated":"2015-06-16 18:08:20.000000000","message":"Do commands that need to be added to both dhcp.filters and l3.filters go in foo.filters -- is there way to separate them ?","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"243cc9b020fd8d04ce3fa18441e056d1b07d2a0c","unresolved":false,"context_lines":[{"line_number":580,"context_line":"For example, to add a rootwrap filters for commands in repo ``networking-foo``:"},{"line_number":581,"context_line":""},{"line_number":582,"context_line":"* In the repo, create the file:"},{"line_number":583,"context_line":"  ``etc/neutron/rootwrap.d/foo.filters``"},{"line_number":584,"context_line":""},{"line_number":585,"context_line":"* In the repo\u0027s ``setup.cfg`` add the filters to data_files::"},{"line_number":586,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa32b979_0053343a","line":583,"in_reply_to":"fa32b979_ab7844f3","updated":"2015-06-23 17:22:46.000000000","message":"At now, all rootwrap filters are loaded regardless of agent type. Thus it is sufficient if a required command is registered in at least one of rootwrap filters.","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"a89fc267aafa5c004000e1f0bb041433c8094fc7","unresolved":false,"context_lines":[{"line_number":589,"context_line":"        etc/neutron/rootwrap.d \u003d"},{"line_number":590,"context_line":"            etc/neutron/rootwrap.d/foo.filters"},{"line_number":591,"context_line":""},{"line_number":592,"context_line":"  "},{"line_number":593,"context_line":"Other repo-split items"},{"line_number":594,"context_line":"~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":595,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa32b979_918598ae","line":592,"updated":"2015-06-16 04:43:02.000000000","message":"No one say a word!","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"eaf4b32a40d21114ae6234ee53b8bdaa9fe2f4be","unresolved":false,"context_lines":[{"line_number":589,"context_line":"        etc/neutron/rootwrap.d \u003d"},{"line_number":590,"context_line":"            etc/neutron/rootwrap.d/foo.filters"},{"line_number":591,"context_line":""},{"line_number":592,"context_line":"  "},{"line_number":593,"context_line":"Other repo-split items"},{"line_number":594,"context_line":"~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":595,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa32b979_84be8dd2","line":592,"in_reply_to":"fa32b979_918598ae","updated":"2015-06-16 19:03:45.000000000","message":"a word","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"243cc9b020fd8d04ce3fa18441e056d1b07d2a0c","unresolved":false,"context_lines":[{"line_number":595,"context_line":""},{"line_number":596,"context_line":"(These are still TBD.)"},{"line_number":597,"context_line":""},{"line_number":598,"context_line":"* Splitting policy.json?"},{"line_number":599,"context_line":""},{"line_number":600,"context_line":"* Generic instructions (or a template) for installing an out-of-tree plugin or"},{"line_number":601,"context_line":"  driver for Neutron. Possibly something for the networking guide, and/or a"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa32b979_841c4d78","line":598,"updated":"2015-06-23 17:22:46.000000000","message":"Unfortunately oslo.policy has a config \u0027policy_dirs\u0027, but this option is planned to remove in M cycle and it is now deprecated.","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"912a42b26865ccfd65844f67513b39a424736fd2","unresolved":false,"context_lines":[{"line_number":595,"context_line":""},{"line_number":596,"context_line":"(These are still TBD.)"},{"line_number":597,"context_line":""},{"line_number":598,"context_line":"* Splitting policy.json?"},{"line_number":599,"context_line":""},{"line_number":600,"context_line":"* Generic instructions (or a template) for installing an out-of-tree plugin or"},{"line_number":601,"context_line":"  driver for Neutron. Possibly something for the networking guide, and/or a"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa32b979_9685a708","line":598,"in_reply_to":"fa32b979_841c4d78","updated":"2015-07-01 19:28:08.000000000","message":"Discussed at the mid-cycle and Armando will investigate.","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"eaf4b32a40d21114ae6234ee53b8bdaa9fe2f4be","unresolved":false,"context_lines":[{"line_number":600,"context_line":"* Generic instructions (or a template) for installing an out-of-tree plugin or"},{"line_number":601,"context_line":"  driver for Neutron. Possibly something for the networking guide, and/or a"},{"line_number":602,"context_line":"  template that plugin/driver maintainers can modify and include with their"},{"line_number":603,"context_line":"  package."},{"line_number":604,"context_line":""},{"line_number":605,"context_line":""},{"line_number":606,"context_line":"Decomposition Phase II Progress Chart"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa32b979_c49b3571","line":603,"updated":"2015-06-16 19:03:45.000000000","message":"I think we\u0027d need to mention something about client extensions, that can be done thanks to [1]\n\n[1] https://review.openstack.org/#/c/148318/","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"912a42b26865ccfd65844f67513b39a424736fd2","unresolved":false,"context_lines":[{"line_number":600,"context_line":"* Generic instructions (or a template) for installing an out-of-tree plugin or"},{"line_number":601,"context_line":"  driver for Neutron. Possibly something for the networking guide, and/or a"},{"line_number":602,"context_line":"  template that plugin/driver maintainers can modify and include with their"},{"line_number":603,"context_line":"  package."},{"line_number":604,"context_line":""},{"line_number":605,"context_line":""},{"line_number":606,"context_line":"Decomposition Phase II Progress Chart"}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba3cc151_e2f5ed56","line":603,"in_reply_to":"fa32b979_c49b3571","updated":"2015-07-01 19:28:08.000000000","message":"Done","commit_id":"ca287f3f6133c323357aa57c210bfce0afc25372"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"4e173f497714cdace14aa88f765ae478b1666d7a","unresolved":false,"context_lines":[{"line_number":226,"context_line":"library, and it leads to the greatest level of flexibility when dealing with DevStack based"},{"line_number":227,"context_line":"dev/test deployments."},{"line_number":228,"context_line":""},{"line_number":229,"context_line":"Having said that, most Neutron plugins developed in the past likely already have"},{"line_number":230,"context_line":"integration with DevStack in the form of `neutron_plugins \u003chttps://git.openstack.org/cgit/openstack-dev/devstack/tree/lib/neutron_plugins\u003e`_."},{"line_number":231,"context_line":"If the plugin is being decomposed in vendor integration plus vendor library, it would"},{"line_number":232,"context_line":"be necessary to adjust the instructions provided in the neutron_plugin file to pull the"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_3501c6af","side":"PARENT","line":229,"updated":"2015-07-01 21:56:59.000000000","message":"nice cleanup","commit_id":"c452babc592c96b767bd07a405f3b5a5cd61c64c"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"25017ebc74483ebe89ae036eb7ff03e052702c53","unresolved":false,"context_lines":[{"line_number":226,"context_line":"library, and it leads to the greatest level of flexibility when dealing with DevStack based"},{"line_number":227,"context_line":"dev/test deployments."},{"line_number":228,"context_line":""},{"line_number":229,"context_line":"Having said that, most Neutron plugins developed in the past likely already have"},{"line_number":230,"context_line":"integration with DevStack in the form of `neutron_plugins \u003chttps://git.openstack.org/cgit/openstack-dev/devstack/tree/lib/neutron_plugins\u003e`_."},{"line_number":231,"context_line":"If the plugin is being decomposed in vendor integration plus vendor library, it would"},{"line_number":232,"context_line":"be necessary to adjust the instructions provided in the neutron_plugin file to pull the"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_73c3e389","side":"PARENT","line":229,"in_reply_to":"ba3cc151_3501c6af","updated":"2015-07-02 00:48:57.000000000","message":"Not sure if sarcasm.","commit_id":"c452babc592c96b767bd07a405f3b5a5cd61c64c"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"4e173f497714cdace14aa88f765ae478b1666d7a","unresolved":false,"context_lines":[{"line_number":1,"context_line":"Contributing new extensions to Neutron"},{"line_number":2,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":3,"context_line":""},{"line_number":4,"context_line":"Neutron has a pluggable architecture, with a number of extension points."},{"line_number":5,"context_line":"This documentation covers aspects relevant to contributing new Neutron"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_32e55c37","line":2,"updated":"2015-07-01 21:56:59.000000000","message":"I\u0027d add here:\n\n Introduction\n ------------","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"25017ebc74483ebe89ae036eb7ff03e052702c53","unresolved":false,"context_lines":[{"line_number":1,"context_line":"Contributing new extensions to Neutron"},{"line_number":2,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":3,"context_line":""},{"line_number":4,"context_line":"Neutron has a pluggable architecture, with a number of extension points."},{"line_number":5,"context_line":"This documentation covers aspects relevant to contributing new Neutron"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_e10e408b","line":2,"in_reply_to":"ba3cc151_32e55c37","updated":"2015-07-02 00:48:57.000000000","message":"Done","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"4e173f497714cdace14aa88f765ae478b1666d7a","unresolved":false,"context_lines":[{"line_number":30,"context_line":"migrations (and perhaps some config examples)."},{"line_number":31,"context_line":""},{"line_number":32,"context_line":"During the Liberty cycle the decomposition concept was taken to its conclusion"},{"line_number":33,"context_line":"by removing all the third party code from the Neutron tree, and all such code"},{"line_number":34,"context_line":"is now integration-only."},{"line_number":35,"context_line":""},{"line_number":36,"context_line":"Third party code is now \u0027outside the tree\u0027, which can be anything that is"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_d25af0f1","line":33,"updated":"2015-07-01 21:56:59.000000000","message":"nit: by allowing third party code to exist entirely out of tree. Further extension mechanisms have been provided to better support external plugins and drivers that alter the API and/or the data model.","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"25017ebc74483ebe89ae036eb7ff03e052702c53","unresolved":false,"context_lines":[{"line_number":30,"context_line":"migrations (and perhaps some config examples)."},{"line_number":31,"context_line":""},{"line_number":32,"context_line":"During the Liberty cycle the decomposition concept was taken to its conclusion"},{"line_number":33,"context_line":"by removing all the third party code from the Neutron tree, and all such code"},{"line_number":34,"context_line":"is now integration-only."},{"line_number":35,"context_line":""},{"line_number":36,"context_line":"Third party code is now \u0027outside the tree\u0027, which can be anything that is"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_e13de0dd","line":33,"in_reply_to":"ba3cc151_d25af0f1","updated":"2015-07-02 00:48:57.000000000","message":"Done","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"4e173f497714cdace14aa88f765ae478b1666d7a","unresolved":false,"context_lines":[{"line_number":40,"context_line":"should not be required for any member of the core team to be involved with this"},{"line_number":41,"context_line":"process, although core members of the Neutron team can participate in whichever"},{"line_number":42,"context_line":"capacity is deemed necessary to facilitate out-of-tree development."},{"line_number":43,"context_line":""},{"line_number":44,"context_line":"Below, the following strategies will be documented:"},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"* Design and Development;"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_52fee0ae","line":43,"updated":"2015-07-01 21:56:59.000000000","message":"I\u0027d add here:\n\n Contribution process\n --------------------","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"25017ebc74483ebe89ae036eb7ff03e052702c53","unresolved":false,"context_lines":[{"line_number":40,"context_line":"should not be required for any member of the core team to be involved with this"},{"line_number":41,"context_line":"process, although core members of the Neutron team can participate in whichever"},{"line_number":42,"context_line":"capacity is deemed necessary to facilitate out-of-tree development."},{"line_number":43,"context_line":""},{"line_number":44,"context_line":"Below, the following strategies will be documented:"},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"* Design and Development;"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_d6eadd0e","line":43,"in_reply_to":"ba3cc151_52fee0ae","updated":"2015-07-02 00:48:57.000000000","message":"Done","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"4e173f497714cdace14aa88f765ae478b1666d7a","unresolved":false,"context_lines":[{"line_number":41,"context_line":"process, although core members of the Neutron team can participate in whichever"},{"line_number":42,"context_line":"capacity is deemed necessary to facilitate out-of-tree development."},{"line_number":43,"context_line":""},{"line_number":44,"context_line":"Below, the following strategies will be documented:"},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"* Design and Development;"},{"line_number":47,"context_line":"* Testing and Continuous Integration;"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_9540d235","line":44,"updated":"2015-07-01 21:56:59.000000000","message":"I\u0027d say :)\n\nIf you want to want to extend OpenStack Networking with your technology, and you want to do it within the visibility of the OpenStack project, follow the guidelines and examples below. We\u0027ll describe best practices for:\n\n * design and development;\n * ...","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"25017ebc74483ebe89ae036eb7ff03e052702c53","unresolved":false,"context_lines":[{"line_number":41,"context_line":"process, although core members of the Neutron team can participate in whichever"},{"line_number":42,"context_line":"capacity is deemed necessary to facilitate out-of-tree development."},{"line_number":43,"context_line":""},{"line_number":44,"context_line":"Below, the following strategies will be documented:"},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"* Design and Development;"},{"line_number":47,"context_line":"* Testing and Continuous Integration;"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_412daca6","line":44,"in_reply_to":"ba3cc151_9540d235","updated":"2015-07-02 00:48:57.000000000","message":"Done","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"4e173f497714cdace14aa88f765ae478b1666d7a","unresolved":false,"context_lines":[{"line_number":50,"context_line":"* DevStack Integration;"},{"line_number":51,"context_line":"* Documentation;"},{"line_number":52,"context_line":""},{"line_number":53,"context_line":"This document will then provide a working example on how to contribute"},{"line_number":54,"context_line":"new additions to Neutron."},{"line_number":55,"context_line":""},{"line_number":56,"context_line":"Code Submission Strategy"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_d5a73a09","line":53,"updated":"2015-07-01 21:56:59.000000000","message":"I\u0027d get rid of this and say","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"25017ebc74483ebe89ae036eb7ff03e052702c53","unresolved":false,"context_lines":[{"line_number":50,"context_line":"* DevStack Integration;"},{"line_number":51,"context_line":"* Documentation;"},{"line_number":52,"context_line":""},{"line_number":53,"context_line":"This document will then provide a working example on how to contribute"},{"line_number":54,"context_line":"new additions to Neutron."},{"line_number":55,"context_line":""},{"line_number":56,"context_line":"Code Submission Strategy"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_612a3092","line":53,"in_reply_to":"ba3cc151_d5a73a09","updated":"2015-07-02 00:48:57.000000000","message":"Done","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"4e173f497714cdace14aa88f765ae478b1666d7a","unresolved":false,"context_lines":[{"line_number":53,"context_line":"This document will then provide a working example on how to contribute"},{"line_number":54,"context_line":"new additions to Neutron."},{"line_number":55,"context_line":""},{"line_number":56,"context_line":"Code Submission Strategy"},{"line_number":57,"context_line":"------------------------"},{"line_number":58,"context_line":""},{"line_number":59,"context_line":"Since the development footprint for third-party code is out-of-tree,"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_756aeeb4","line":56,"updated":"2015-07-01 21:56:59.000000000","message":"This should become Design and Development.","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"25017ebc74483ebe89ae036eb7ff03e052702c53","unresolved":false,"context_lines":[{"line_number":53,"context_line":"This document will then provide a working example on how to contribute"},{"line_number":54,"context_line":"new additions to Neutron."},{"line_number":55,"context_line":""},{"line_number":56,"context_line":"Code Submission Strategy"},{"line_number":57,"context_line":"------------------------"},{"line_number":58,"context_line":""},{"line_number":59,"context_line":"Since the development footprint for third-party code is out-of-tree,"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_56dfad68","line":56,"in_reply_to":"ba3cc151_756aeeb4","updated":"2015-07-02 00:48:57.000000000","message":"Done","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"4e173f497714cdace14aa88f765ae478b1666d7a","unresolved":false,"context_lines":[{"line_number":56,"context_line":"Code Submission Strategy"},{"line_number":57,"context_line":"------------------------"},{"line_number":58,"context_line":""},{"line_number":59,"context_line":"Since the development footprint for third-party code is out-of-tree,"},{"line_number":60,"context_line":"contributors do not need to submit blueprints, specifications or bugs against"},{"line_number":61,"context_line":"Neutron."},{"line_number":62,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_f55fdee2","line":59,"updated":"2015-07-01 21:56:59.000000000","message":"I\u0027d add: \n\nAssumed you have a working repository, any development to your own repo does not need any blueprint, specification or bugs against Neutron.","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"25017ebc74483ebe89ae036eb7ff03e052702c53","unresolved":false,"context_lines":[{"line_number":56,"context_line":"Code Submission Strategy"},{"line_number":57,"context_line":"------------------------"},{"line_number":58,"context_line":""},{"line_number":59,"context_line":"Since the development footprint for third-party code is out-of-tree,"},{"line_number":60,"context_line":"contributors do not need to submit blueprints, specifications or bugs against"},{"line_number":61,"context_line":"Neutron."},{"line_number":62,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_6101d005","line":59,"in_reply_to":"ba3cc151_f55fdee2","updated":"2015-07-02 00:48:57.000000000","message":"Done","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"4e173f497714cdace14aa88f765ae478b1666d7a","unresolved":false,"context_lines":[{"line_number":60,"context_line":"contributors do not need to submit blueprints, specifications or bugs against"},{"line_number":61,"context_line":"Neutron."},{"line_number":62,"context_line":""},{"line_number":63,"context_line":"If the vendor code is hosted on git.openstack.org then the gerrit review system"},{"line_number":64,"context_line":"is automatically provided. Contributors should follow the review guidelines"},{"line_number":65,"context_line":"similar to those of Neutron. However, the maintainer has flexibility to choose"},{"line_number":66,"context_line":"who can approve/merge changes in their own repo."}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_1565a2b3","line":63,"updated":"2015-07-01 21:56:59.000000000","message":"third-party?","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"25017ebc74483ebe89ae036eb7ff03e052702c53","unresolved":false,"context_lines":[{"line_number":60,"context_line":"contributors do not need to submit blueprints, specifications or bugs against"},{"line_number":61,"context_line":"Neutron."},{"line_number":62,"context_line":""},{"line_number":63,"context_line":"If the vendor code is hosted on git.openstack.org then the gerrit review system"},{"line_number":64,"context_line":"is automatically provided. Contributors should follow the review guidelines"},{"line_number":65,"context_line":"similar to those of Neutron. However, the maintainer has flexibility to choose"},{"line_number":66,"context_line":"who can approve/merge changes in their own repo."}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_d300af03","line":63,"in_reply_to":"ba3cc151_1565a2b3","updated":"2015-07-02 00:48:57.000000000","message":"Done","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"4e173f497714cdace14aa88f765ae478b1666d7a","unresolved":false,"context_lines":[{"line_number":164,"context_line":""},{"line_number":165,"context_line":"It is the duty of the new contributor to provide working links that can be"},{"line_number":166,"context_line":"referenced from the OpenStack upstream documentation."},{"line_number":167,"context_line":"#TODO(armax): provide more info, when available."},{"line_number":168,"context_line":""},{"line_number":169,"context_line":"How-to"},{"line_number":170,"context_line":"------"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_359d4666","line":167,"updated":"2015-07-01 21:56:59.000000000","message":"this should probably go","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"25017ebc74483ebe89ae036eb7ff03e052702c53","unresolved":false,"context_lines":[{"line_number":164,"context_line":""},{"line_number":165,"context_line":"It is the duty of the new contributor to provide working links that can be"},{"line_number":166,"context_line":"referenced from the OpenStack upstream documentation."},{"line_number":167,"context_line":"#TODO(armax): provide more info, when available."},{"line_number":168,"context_line":""},{"line_number":169,"context_line":"How-to"},{"line_number":170,"context_line":"------"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_d3274fb4","line":167,"in_reply_to":"ba3cc151_359d4666","updated":"2015-07-02 00:48:57.000000000","message":"Done","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"4e173f497714cdace14aa88f765ae478b1666d7a","unresolved":false,"context_lines":[{"line_number":166,"context_line":"referenced from the OpenStack upstream documentation."},{"line_number":167,"context_line":"#TODO(armax): provide more info, when available."},{"line_number":168,"context_line":""},{"line_number":169,"context_line":"How-to"},{"line_number":170,"context_line":"------"},{"line_number":171,"context_line":""},{"line_number":172,"context_line":"The how-to below assumes that the vendor library will be hosted on"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_d5289a35","line":169,"updated":"2015-07-01 21:56:59.000000000","message":"Perhaps this becomes \u0027Project Initial Setup\u0027?","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"25017ebc74483ebe89ae036eb7ff03e052702c53","unresolved":false,"context_lines":[{"line_number":166,"context_line":"referenced from the OpenStack upstream documentation."},{"line_number":167,"context_line":"#TODO(armax): provide more info, when available."},{"line_number":168,"context_line":""},{"line_number":169,"context_line":"How-to"},{"line_number":170,"context_line":"------"},{"line_number":171,"context_line":""},{"line_number":172,"context_line":"The how-to below assumes that the vendor library will be hosted on"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_7339a3d6","line":169,"in_reply_to":"ba3cc151_d5289a35","updated":"2015-07-02 00:48:57.000000000","message":"Done","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"4e173f497714cdace14aa88f765ae478b1666d7a","unresolved":false,"context_lines":[{"line_number":169,"context_line":"How-to"},{"line_number":170,"context_line":"------"},{"line_number":171,"context_line":""},{"line_number":172,"context_line":"The how-to below assumes that the vendor library will be hosted on"},{"line_number":173,"context_line":"git.openstack.org. This lets you tap in the entire OpenStack CI infrastructure"},{"line_number":174,"context_line":"and can be a great place to start from to contribute your new or existing"},{"line_number":175,"context_line":"driver/plugin. The list of steps below are summarized version of what you can"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_f52d9e46","line":172,"updated":"2015-07-01 21:56:59.000000000","message":"third-party?","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"25017ebc74483ebe89ae036eb7ff03e052702c53","unresolved":false,"context_lines":[{"line_number":169,"context_line":"How-to"},{"line_number":170,"context_line":"------"},{"line_number":171,"context_line":""},{"line_number":172,"context_line":"The how-to below assumes that the vendor library will be hosted on"},{"line_number":173,"context_line":"git.openstack.org. This lets you tap in the entire OpenStack CI infrastructure"},{"line_number":174,"context_line":"and can be a great place to start from to contribute your new or existing"},{"line_number":175,"context_line":"driver/plugin. The list of steps below are summarized version of what you can"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_133297f2","line":172,"in_reply_to":"ba3cc151_f52d9e46","updated":"2015-07-02 00:48:57.000000000","message":"Done","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"4e173f497714cdace14aa88f765ae478b1666d7a","unresolved":false,"context_lines":[{"line_number":186,"context_line":"  want to skip this step now, build the history first (next step), and come back"},{"line_number":187,"context_line":"  here to initialize the remainder of the repository with other files being"},{"line_number":188,"context_line":"  generated by the cookiecutter (like tox.ini, setup.cfg, setup.py, etc.)."},{"line_number":189,"context_line":"* Create a stackforge/ or openstack/ repository (see `Official Sub-Projects"},{"line_number":190,"context_line":"  \u003chttp://docs.openstack.org/developer/neutron/devref/sub_projects.html\u003e`_). For"},{"line_number":191,"context_line":"  this you need the help of the OpenStack infra team. It is worth noting that"},{"line_number":192,"context_line":"  you only get one shot at creating the StackForge repository. This is the time"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_15da824c","line":189,"updated":"2015-07-01 21:56:59.000000000","message":"sounds like stackforge is going to be dismissed as some point, we might want to refer to openstack only","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"25017ebc74483ebe89ae036eb7ff03e052702c53","unresolved":false,"context_lines":[{"line_number":186,"context_line":"  want to skip this step now, build the history first (next step), and come back"},{"line_number":187,"context_line":"  here to initialize the remainder of the repository with other files being"},{"line_number":188,"context_line":"  generated by the cookiecutter (like tox.ini, setup.cfg, setup.py, etc.)."},{"line_number":189,"context_line":"* Create a stackforge/ or openstack/ repository (see `Official Sub-Projects"},{"line_number":190,"context_line":"  \u003chttp://docs.openstack.org/developer/neutron/devref/sub_projects.html\u003e`_). For"},{"line_number":191,"context_line":"  this you need the help of the OpenStack infra team. It is worth noting that"},{"line_number":192,"context_line":"  you only get one shot at creating the StackForge repository. This is the time"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_332f9b89","line":189,"in_reply_to":"ba3cc151_15da824c","updated":"2015-07-02 00:48:57.000000000","message":"Done","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"4e173f497714cdace14aa88f765ae478b1666d7a","unresolved":false,"context_lines":[{"line_number":199,"context_line":"  documented in"},{"line_number":200,"context_line":"  `this section \u003chttp://docs.openstack.org/infra/manual/creators.html#update-the-gerrit-group-members\u003e`_."},{"line_number":201,"context_line":"* Fix, fix, fix: at this point you have an external base to work on. You"},{"line_number":202,"context_line":"  can develop against the new stackforge project, the same way you work"},{"line_number":203,"context_line":"  with any other OpenStack project: you have pep8, docs, and python27 CI"},{"line_number":204,"context_line":"  jobs that validate your patches when posted to Gerrit. For instance, one"},{"line_number":205,"context_line":"  thing you would need to do is to define an entry point for your plugin"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_15c12254","line":202,"updated":"2015-07-01 21:56:59.000000000","message":"get rid of stackforge","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"25017ebc74483ebe89ae036eb7ff03e052702c53","unresolved":false,"context_lines":[{"line_number":199,"context_line":"  documented in"},{"line_number":200,"context_line":"  `this section \u003chttp://docs.openstack.org/infra/manual/creators.html#update-the-gerrit-group-members\u003e`_."},{"line_number":201,"context_line":"* Fix, fix, fix: at this point you have an external base to work on. You"},{"line_number":202,"context_line":"  can develop against the new stackforge project, the same way you work"},{"line_number":203,"context_line":"  with any other OpenStack project: you have pep8, docs, and python27 CI"},{"line_number":204,"context_line":"  jobs that validate your patches when posted to Gerrit. For instance, one"},{"line_number":205,"context_line":"  thing you would need to do is to define an entry point for your plugin"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_d34e6f6e","line":202,"in_reply_to":"ba3cc151_15c12254","updated":"2015-07-02 00:48:57.000000000","message":"Done","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"4e173f497714cdace14aa88f765ae478b1666d7a","unresolved":false,"context_lines":[{"line_number":213,"context_line":"* TODO(armax): ..."},{"line_number":214,"context_line":""},{"line_number":215,"context_line":""},{"line_number":216,"context_line":"Final Decomposition"},{"line_number":217,"context_line":"-------------------"},{"line_number":218,"context_line":""},{"line_number":219,"context_line":"(This section currently describes the goals and progress of the completion of"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_158fe22a","line":216,"updated":"2015-07-01 21:56:59.000000000","message":"I\u0027d call this:\n\nIntegrating with the Neutron system\n\nIf so, perhaps we can skip the preamble below","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"25017ebc74483ebe89ae036eb7ff03e052702c53","unresolved":false,"context_lines":[{"line_number":213,"context_line":"* TODO(armax): ..."},{"line_number":214,"context_line":""},{"line_number":215,"context_line":""},{"line_number":216,"context_line":"Final Decomposition"},{"line_number":217,"context_line":"-------------------"},{"line_number":218,"context_line":""},{"line_number":219,"context_line":"(This section currently describes the goals and progress of the completion of"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_7340c334","line":216,"in_reply_to":"ba3cc151_158fe22a","updated":"2015-07-02 00:48:57.000000000","message":"Done","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"4e173f497714cdace14aa88f765ae478b1666d7a","unresolved":false,"context_lines":[{"line_number":233,"context_line":""},{"line_number":234,"context_line":"The existing shims shall now be moved out of tree, together with any test"},{"line_number":235,"context_line":"code. The entry points shall be moved as described below in `Entry Points`_."},{"line_number":236,"context_line":""},{"line_number":237,"context_line":""},{"line_number":238,"context_line":"Configuration Files"},{"line_number":239,"context_line":"~~~~~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_9525320a","line":236,"updated":"2015-07-01 21:56:59.000000000","message":"what we could do in the next sections is for instance:\n\nConfiguration files\n\n\u003cstate what is the practice is\u003e\n\nThen we add a subsection\n\nLiberty steps\n\n\u003cthis contains what needs to be done\u003e\n\n\nThis way, a the end of liberty we\u0027ll just remove the section headlined \u0027Liberty steps\u0027 whilst they get to completion.\n\nAm I making sense?","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"25017ebc74483ebe89ae036eb7ff03e052702c53","unresolved":false,"context_lines":[{"line_number":233,"context_line":""},{"line_number":234,"context_line":"The existing shims shall now be moved out of tree, together with any test"},{"line_number":235,"context_line":"code. The entry points shall be moved as described below in `Entry Points`_."},{"line_number":236,"context_line":""},{"line_number":237,"context_line":""},{"line_number":238,"context_line":"Configuration Files"},{"line_number":239,"context_line":"~~~~~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_73e68316","line":236,"in_reply_to":"ba3cc151_9525320a","updated":"2015-07-02 00:48:57.000000000","message":"Yes. Done.","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"4e173f497714cdace14aa88f765ae478b1666d7a","unresolved":false,"context_lines":[{"line_number":253,"context_line":"  prefix section names with a vendor string, e.g. [vendor_foo]."},{"line_number":254,"context_line":""},{"line_number":255,"context_line":""},{"line_number":256,"context_line":"Database Models and Migrations"},{"line_number":257,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":258,"context_line":""},{"line_number":259,"context_line":"Each decomposed plugin/driver that has its own tables in the neutron database"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_357546f9","line":256,"updated":"2015-07-01 21:56:59.000000000","message":"here for example: what guidelines should we give to plugins/drivers that add models and migrations?","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"25017ebc74483ebe89ae036eb7ff03e052702c53","unresolved":false,"context_lines":[{"line_number":253,"context_line":"  prefix section names with a vendor string, e.g. [vendor_foo]."},{"line_number":254,"context_line":""},{"line_number":255,"context_line":""},{"line_number":256,"context_line":"Database Models and Migrations"},{"line_number":257,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":258,"context_line":""},{"line_number":259,"context_line":"Each decomposed plugin/driver that has its own tables in the neutron database"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_337c7bb4","line":256,"in_reply_to":"ba3cc151_357546f9","updated":"2015-07-02 00:48:57.000000000","message":"Done","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"4e173f497714cdace14aa88f765ae478b1666d7a","unresolved":false,"context_lines":[{"line_number":305,"context_line":"A template unit or functional test will be provided that plugin/driver"},{"line_number":306,"context_line":"maintainers can use to develop a test for model-vs-migration sync in their"},{"line_number":307,"context_line":"repos. It is recommended that each third party CI sets up such a test, and runs"},{"line_number":308,"context_line":"it regularly against Neutron master."},{"line_number":309,"context_line":""},{"line_number":310,"context_line":""},{"line_number":311,"context_line":"Entry Points"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_9553f26a","line":308,"updated":"2015-07-01 21:56:59.000000000","message":"then here we can list what needs to happen in Liberty.\n\nThe patches that make that happen can clear out the subsection.","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"25017ebc74483ebe89ae036eb7ff03e052702c53","unresolved":false,"context_lines":[{"line_number":305,"context_line":"A template unit or functional test will be provided that plugin/driver"},{"line_number":306,"context_line":"maintainers can use to develop a test for model-vs-migration sync in their"},{"line_number":307,"context_line":"repos. It is recommended that each third party CI sets up such a test, and runs"},{"line_number":308,"context_line":"it regularly against Neutron master."},{"line_number":309,"context_line":""},{"line_number":310,"context_line":""},{"line_number":311,"context_line":"Entry Points"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba3cc151_d34bcf85","line":308,"in_reply_to":"ba3cc151_9553f26a","updated":"2015-07-02 00:48:57.000000000","message":"Done","commit_id":"daa522ac609b91ee4f44e3e4710b1f46757d3af7"},{"author":{"_account_id":1561,"name":"Russell Bryant","email":"rbryant@redhat.com","username":"russellb"},"change_message_id":"8b7941c03371308b9960b136901876425f2a7c60","unresolved":false,"context_lines":[{"line_number":22,"context_line":""},{"line_number":23,"context_line":"Plugins and drivers for non-reference implementations are known as \"Third"},{"line_number":24,"context_line":"Party\" code. This includes code for supporting vendor products, as well as"},{"line_number":25,"context_line":"code for supporting open-source networking implementations."},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"Before the Kilo release these plugins and drivers were included in the Neutron"},{"line_number":28,"context_line":"tree. During the Kilo cycle the third party plugins and drivers underwent the"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_6b28b533","line":25,"updated":"2015-07-02 13:09:28.000000000","message":"I\u0027d really like to see this referred to as something other than \"3rd party\".  If it\u0027s truly 3rd party, who cares how the project is run.  Many things are run as sub-projects within the Neutron project.  Those things aren\u0027t really 3rd party.  \n\nPerhaps \"driver sub-project\" is a better name?  Any other ideas","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":1561,"name":"Russell Bryant","email":"rbryant@redhat.com","username":"russellb"},"change_message_id":"669c8abaee28d876b09d7edaff81b915c5bf3e99","unresolved":false,"context_lines":[{"line_number":22,"context_line":""},{"line_number":23,"context_line":"Plugins and drivers for non-reference implementations are known as \"Third"},{"line_number":24,"context_line":"Party\" code. This includes code for supporting vendor products, as well as"},{"line_number":25,"context_line":"code for supporting open-source networking implementations."},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"Before the Kilo release these plugins and drivers were included in the Neutron"},{"line_number":28,"context_line":"tree. During the Kilo cycle the third party plugins and drivers underwent the"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_fd8a4363","line":25,"in_reply_to":"ba3cc151_028ea6cf","updated":"2015-07-02 14:39:20.000000000","message":"I just feel like \"third party\" implies second class citizen, and that\u0027s not what they are.\n\n\"API implementations\" works, but there are lots of APIs, and some projects even provide new APIs.  I\u0027m not really sure what captures it all.  \"sub-project repos\" ?","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"915d918c1674c4cb17478fa7625ff55eeb43655c","unresolved":false,"context_lines":[{"line_number":22,"context_line":""},{"line_number":23,"context_line":"Plugins and drivers for non-reference implementations are known as \"Third"},{"line_number":24,"context_line":"Party\" code. This includes code for supporting vendor products, as well as"},{"line_number":25,"context_line":"code for supporting open-source networking implementations."},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"Before the Kilo release these plugins and drivers were included in the Neutron"},{"line_number":28,"context_line":"tree. During the Kilo cycle the third party plugins and drivers underwent the"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_b1d94a59","line":25,"in_reply_to":"ba3cc151_6b28b533","updated":"2015-07-02 15:21:17.000000000","message":"I like the idea from Russel too, but I don\u0027t have an idea on a \"nice\" name at the moment. Regardless of having openstack/ hat or not (stackforge/ or others), they are run as sub-project or related projects.\n\nOn the other hand, \"Third Party CI\" is now a popular word used to refer \"external CI\"... hmm....\n\nThus, I am okay with using \"Third Party\" at the moment.\nI think we should not stick the \"word\" to make things forward.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":105,"name":"Kyle Mestery","email":"mestery@mestery.com","username":"mestery"},"change_message_id":"8bb87d11f104a5a43103662b6afeaaebd55fb142","unresolved":false,"context_lines":[{"line_number":22,"context_line":""},{"line_number":23,"context_line":"Plugins and drivers for non-reference implementations are known as \"Third"},{"line_number":24,"context_line":"Party\" code. This includes code for supporting vendor products, as well as"},{"line_number":25,"context_line":"code for supporting open-source networking implementations."},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"Before the Kilo release these plugins and drivers were included in the Neutron"},{"line_number":28,"context_line":"tree. During the Kilo cycle the third party plugins and drivers underwent the"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_028ea6cf","line":25,"in_reply_to":"ba3cc151_6b28b533","updated":"2015-07-02 14:35:57.000000000","message":"I\u0027m personally ok with \"Third Party\", but how about if we instead use the terminology \"neutron API implementations\". It builds on the idea of Neutron as a platform, and keeps these other implementations top of mind.\n\nThoughts?","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"9e058eca9ffef6b9388ce94166f7f0799b92bdca","unresolved":false,"context_lines":[{"line_number":22,"context_line":""},{"line_number":23,"context_line":"Plugins and drivers for non-reference implementations are known as \"Third"},{"line_number":24,"context_line":"Party\" code. This includes code for supporting vendor products, as well as"},{"line_number":25,"context_line":"code for supporting open-source networking implementations."},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"Before the Kilo release these plugins and drivers were included in the Neutron"},{"line_number":28,"context_line":"tree. During the Kilo cycle the third party plugins and drivers underwent the"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_f1947937","line":25,"in_reply_to":"ba3cc151_b1d94a59","updated":"2015-07-03 20:25:54.000000000","message":"Since the perfect term is still being discussed I won\u0027t change it yet. If we come to a definitive agreement at some point, then I can do a search\u0026replace.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":105,"name":"Kyle Mestery","email":"mestery@mestery.com","username":"mestery"},"change_message_id":"3177ce213242a606a85a25fc0744da2f331053c5","unresolved":false,"context_lines":[{"line_number":22,"context_line":""},{"line_number":23,"context_line":"Plugins and drivers for non-reference implementations are known as \"Third"},{"line_number":24,"context_line":"Party\" code. This includes code for supporting vendor products, as well as"},{"line_number":25,"context_line":"code for supporting open-source networking implementations."},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"Before the Kilo release these plugins and drivers were included in the Neutron"},{"line_number":28,"context_line":"tree. During the Kilo cycle the third party plugins and drivers underwent the"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_dd765f05","line":25,"in_reply_to":"ba3cc151_fd8a4363","updated":"2015-07-02 14:46:47.000000000","message":"\"sub-project repos\" sounds ok to me too.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":105,"name":"Kyle Mestery","email":"mestery@mestery.com","username":"mestery"},"change_message_id":"8bb87d11f104a5a43103662b6afeaaebd55fb142","unresolved":false,"context_lines":[{"line_number":47,"context_line":""},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"Contrubution Process"},{"line_number":50,"context_line":"--------------------"},{"line_number":51,"context_line":""},{"line_number":52,"context_line":"If you want to want to extend OpenStack Networking with your technology, and"},{"line_number":53,"context_line":"you want to do it within the visibility of the OpenStack project, follow the"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_02a54645","line":50,"updated":"2015-07-02 14:35:57.000000000","message":"Contribution","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"9e058eca9ffef6b9388ce94166f7f0799b92bdca","unresolved":false,"context_lines":[{"line_number":47,"context_line":""},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"Contrubution Process"},{"line_number":50,"context_line":"--------------------"},{"line_number":51,"context_line":""},{"line_number":52,"context_line":"If you want to want to extend OpenStack Networking with your technology, and"},{"line_number":53,"context_line":"you want to do it within the visibility of the OpenStack project, follow the"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_b1a03143","line":50,"in_reply_to":"ba3cc151_02a54645","updated":"2015-07-03 20:25:54.000000000","message":"Done","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"915d918c1674c4cb17478fa7625ff55eeb43655c","unresolved":false,"context_lines":[{"line_number":51,"context_line":""},{"line_number":52,"context_line":"If you want to want to extend OpenStack Networking with your technology, and"},{"line_number":53,"context_line":"you want to do it within the visibility of the OpenStack project, follow the"},{"line_number":54,"context_line":"guidelines and examples below. We\u0027ll describe best practices for:"},{"line_number":55,"context_line":""},{"line_number":56,"context_line":"* Design and Development;"},{"line_number":57,"context_line":"* Testing and Continuous Integration;"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_513a3ee8","line":54,"updated":"2015-07-02 15:21:17.000000000","message":"Very generic question.\n\nIs there any official plugin/driver list as Neutron team\nafter the decomposition is completed? If a maintainer of some third-party plugin/driver wants to make his/her work visible in OpenStack project, what is the recommended way?\n\nBefore Kilo, having their code in the main neutron tree makes them visible publicly. In Kilo, having shim codes for their code plays the similar role. How about in Liberty or later?","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"9e058eca9ffef6b9388ce94166f7f0799b92bdca","unresolved":false,"context_lines":[{"line_number":51,"context_line":""},{"line_number":52,"context_line":"If you want to want to extend OpenStack Networking with your technology, and"},{"line_number":53,"context_line":"you want to do it within the visibility of the OpenStack project, follow the"},{"line_number":54,"context_line":"guidelines and examples below. We\u0027ll describe best practices for:"},{"line_number":55,"context_line":""},{"line_number":56,"context_line":"* Design and Development;"},{"line_number":57,"context_line":"* Testing and Continuous Integration;"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_b1135164","line":54,"in_reply_to":"ba3cc151_513a3ee8","updated":"2015-07-03 20:25:54.000000000","message":"There is a list in sub_projects.rst\n\nI\u0027ll add some text to mention that. Hopefully it is OK for maintainers to submit a patch to add their project to the list.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":6659,"name":"Paul Michali","email":"pc@michali.net","username":"pcm"},"change_message_id":"aff9341422ebc18ca9267c8ae4d198f0fbe4e37c","unresolved":false,"context_lines":[{"line_number":55,"context_line":""},{"line_number":56,"context_line":"* Design and Development;"},{"line_number":57,"context_line":"* Testing and Continuous Integration;"},{"line_number":58,"context_line":"* Defect Management;"},{"line_number":59,"context_line":"* Backport Management for plugin specific code;"},{"line_number":60,"context_line":"* DevStack Integration;"},{"line_number":61,"context_line":"* Documentation;"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_f9002268","line":58,"updated":"2015-07-02 11:20:48.000000000","message":"Don\u0027t see best practices section for defect management. May want to name the sections below to match this list.  May want to use a different heading style for them too, so that they are all under the Contribution Process section.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"9e058eca9ffef6b9388ce94166f7f0799b92bdca","unresolved":false,"context_lines":[{"line_number":55,"context_line":""},{"line_number":56,"context_line":"* Design and Development;"},{"line_number":57,"context_line":"* Testing and Continuous Integration;"},{"line_number":58,"context_line":"* Defect Management;"},{"line_number":59,"context_line":"* Backport Management for plugin specific code;"},{"line_number":60,"context_line":"* DevStack Integration;"},{"line_number":61,"context_line":"* Documentation;"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_cf0c293e","line":58,"in_reply_to":"ba3cc151_9cbd3dda","updated":"2015-07-03 20:25:54.000000000","message":"I added this questions about security issues as a TODO item, and sent an email to the mailing list.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"915d918c1674c4cb17478fa7625ff55eeb43655c","unresolved":false,"context_lines":[{"line_number":55,"context_line":""},{"line_number":56,"context_line":"* Design and Development;"},{"line_number":57,"context_line":"* Testing and Continuous Integration;"},{"line_number":58,"context_line":"* Defect Management;"},{"line_number":59,"context_line":"* Backport Management for plugin specific code;"},{"line_number":60,"context_line":"* DevStack Integration;"},{"line_number":61,"context_line":"* Documentation;"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_9cbd3dda","line":58,"in_reply_to":"ba3cc151_f9002268","updated":"2015-07-02 15:21:17.000000000","message":"Agree with having a section for defect management.\n\nThe defect management is roughly classified into two parts: normal bug management and security issue management.\n\nRegarding the first part, it is simple and it is covered by \n\"design and development\" section below.\n\nRegarding the second part, it is not so simple.\nIs it handled by OpenStack security team?\nDo we need to file CVE for security isseus?\nDoes vendor need to publish OSSN or equivalent documents?\nOthers?\n\nHonestly I don\u0027t have a good specific idea now.\nIt can be discussed more broadly e.g. dev ML.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"e8a2132d6c27d404a82e11d5a31516887867248b","unresolved":false,"context_lines":[{"line_number":55,"context_line":""},{"line_number":56,"context_line":"* Design and Development;"},{"line_number":57,"context_line":"* Testing and Continuous Integration;"},{"line_number":58,"context_line":"* Defect Management;"},{"line_number":59,"context_line":"* Backport Management for plugin specific code;"},{"line_number":60,"context_line":"* DevStack Integration;"},{"line_number":61,"context_line":"* Documentation;"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_8fcc1ebc","line":58,"in_reply_to":"ba3cc151_f9002268","updated":"2015-07-02 15:01:39.000000000","message":"I have some words on this at lines 67-68 and 81-85, but I\u0027ll move those to a separate section. Thanks.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"915d918c1674c4cb17478fa7625ff55eeb43655c","unresolved":false,"context_lines":[{"line_number":144,"context_line":"If a change made to out-of-tree third-party code needs to be back-ported to"},{"line_number":145,"context_line":"in-tree code in a stable branch, the contributor may submit a review without a"},{"line_number":146,"context_line":"corresponding master branch change. The change will be evaluated by core"},{"line_number":147,"context_line":"reviewers to ensure that the backport is justified and that it does not affect"},{"line_number":148,"context_line":"Neutron core code stability."},{"line_number":149,"context_line":""},{"line_number":150,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_bc95a133","line":147,"updated":"2015-07-02 15:21:17.000000000","message":"more specifically, \"core reviewers\" should be \"core reviewers for stable branches\". We have a separate reviewer team for stable branches.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"9e058eca9ffef6b9388ce94166f7f0799b92bdca","unresolved":false,"context_lines":[{"line_number":144,"context_line":"If a change made to out-of-tree third-party code needs to be back-ported to"},{"line_number":145,"context_line":"in-tree code in a stable branch, the contributor may submit a review without a"},{"line_number":146,"context_line":"corresponding master branch change. The change will be evaluated by core"},{"line_number":147,"context_line":"reviewers to ensure that the backport is justified and that it does not affect"},{"line_number":148,"context_line":"Neutron core code stability."},{"line_number":149,"context_line":""},{"line_number":150,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_a0dbfa4e","line":147,"in_reply_to":"ba3cc151_bc95a133","updated":"2015-07-03 20:25:54.000000000","message":"Done","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"915d918c1674c4cb17478fa7625ff55eeb43655c","unresolved":false,"context_lines":[{"line_number":265,"context_line":""},{"line_number":266,"context_line":"Third-party configuration files still in the neutron tree have no dependencies"},{"line_number":267,"context_line":"and can simply be moved. The maintainers should add their configuration file(s)"},{"line_number":268,"context_line":"to their repo and then remove them from neutron."},{"line_number":269,"context_line":""},{"line_number":270,"context_line":""},{"line_number":271,"context_line":"Database Models and Migrations"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_7c5cf97c","line":268,"updated":"2015-07-02 15:21:17.000000000","message":"Is there any recommended way to have their config option in the configuration guide in docs.openstack.org?","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"9e058eca9ffef6b9388ce94166f7f0799b92bdca","unresolved":false,"context_lines":[{"line_number":265,"context_line":""},{"line_number":266,"context_line":"Third-party configuration files still in the neutron tree have no dependencies"},{"line_number":267,"context_line":"and can simply be moved. The maintainers should add their configuration file(s)"},{"line_number":268,"context_line":"to their repo and then remove them from neutron."},{"line_number":269,"context_line":""},{"line_number":270,"context_line":""},{"line_number":271,"context_line":"Database Models and Migrations"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_c0b39ee8","line":268,"in_reply_to":"ba3cc151_7c5cf97c","updated":"2015-07-03 20:25:54.000000000","message":"I don\u0027t know. I have added a TODO to figure this out.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"c5d19c23ac290c45c2dd26ae1147c0ca61ae74e0","unresolved":false,"context_lines":[{"line_number":265,"context_line":""},{"line_number":266,"context_line":"Third-party configuration files still in the neutron tree have no dependencies"},{"line_number":267,"context_line":"and can simply be moved. The maintainers should add their configuration file(s)"},{"line_number":268,"context_line":"to their repo and then remove them from neutron."},{"line_number":269,"context_line":""},{"line_number":270,"context_line":""},{"line_number":271,"context_line":"Database Models and Migrations"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_479ebd64","line":268,"in_reply_to":"ba3cc151_c0b39ee8","updated":"2015-07-04 04:54:46.000000000","message":"We need to explore the way. It is not a problem specific to plugin decomposition, and it is a common problem in so-called Neutron stadium.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"a4edf26506be708e662ea4f44447d2ebea7aa5af","unresolved":false,"context_lines":[{"line_number":273,"context_line":""},{"line_number":274,"context_line":"A third-party repo may contain database models. Each repo has its own alembic"},{"line_number":275,"context_line":"migration branch that adds, removes and modifies its corresponding tables in"},{"line_number":276,"context_line":"the neutron database schema."},{"line_number":277,"context_line":""},{"line_number":278,"context_line":"* Note: Care should be taken when adding new tables. To prevent collision of"},{"line_number":279,"context_line":"  table names it is recommended to prefix them with a vendor/plugin string."}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_d6b73dd6","line":276,"updated":"2015-07-02 00:56:57.000000000","message":"There is work afoot to make this more complicated by supporting online migrations, which will require multiple alembic branches in the repo. This section can be updated when the complications are solidified.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":11816,"name":"mike bayer","display_name":"Mike Bayer","email":"mike_mp@zzzcomputing.com","username":"zzzeek","status":"Red Hat"},"change_message_id":"85b9f31408ff4568b06e9394cfc07866bd127359","unresolved":false,"context_lines":[{"line_number":273,"context_line":""},{"line_number":274,"context_line":"A third-party repo may contain database models. Each repo has its own alembic"},{"line_number":275,"context_line":"migration branch that adds, removes and modifies its corresponding tables in"},{"line_number":276,"context_line":"the neutron database schema."},{"line_number":277,"context_line":""},{"line_number":278,"context_line":"* Note: Care should be taken when adding new tables. To prevent collision of"},{"line_number":279,"context_line":"  table names it is recommended to prefix them with a vendor/plugin string."}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_bc884172","line":276,"in_reply_to":"ba3cc151_4b561107","updated":"2015-07-02 13:54:30.000000000","message":"I have the sense that the kinds of DB migrations that 3rd parties work with are their own independent sets of tables, and not modifications to the core Neutron tables themselves.  I agree that 3rd party changes to Neutron\u0027s own tables should be prohibited outside of Neutron\u0027s own tree; if those extensions need Neutron\u0027s datamodel to have changes, those changes should be added in-tree.  as far as OSM, I can\u0027t say what\u0027s appropriate; a 3rd party extension might be given the choice to support \"online\" schema migrations for their own tables by doing expand/contract as well as providing the appropriate datamodel style, or not (e.g. \"our extension doesn\u0027t support online migration\").","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"9e058eca9ffef6b9388ce94166f7f0799b92bdca","unresolved":false,"context_lines":[{"line_number":273,"context_line":""},{"line_number":274,"context_line":"A third-party repo may contain database models. Each repo has its own alembic"},{"line_number":275,"context_line":"migration branch that adds, removes and modifies its corresponding tables in"},{"line_number":276,"context_line":"the neutron database schema."},{"line_number":277,"context_line":""},{"line_number":278,"context_line":"* Note: Care should be taken when adding new tables. To prevent collision of"},{"line_number":279,"context_line":"  table names it is recommended to prefix them with a vendor/plugin string."}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_40730e16","line":276,"in_reply_to":"ba3cc151_6340d134","updated":"2015-07-03 20:25:54.000000000","message":"Done","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"19950dd8b68463aa884283656e0485c53fd8a3d8","unresolved":false,"context_lines":[{"line_number":273,"context_line":""},{"line_number":274,"context_line":"A third-party repo may contain database models. Each repo has its own alembic"},{"line_number":275,"context_line":"migration branch that adds, removes and modifies its corresponding tables in"},{"line_number":276,"context_line":"the neutron database schema."},{"line_number":277,"context_line":""},{"line_number":278,"context_line":"* Note: Care should be taken when adding new tables. To prevent collision of"},{"line_number":279,"context_line":"  table names it is recommended to prefix them with a vendor/plugin string."}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_6340d134","line":276,"in_reply_to":"ba3cc151_a277ba9e","updated":"2015-07-02 15:54:23.000000000","message":"+1. Agree it is important to mention clearly it is not allowed for third-party db migration to touch neutron core db tables.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"04007a9770c821020962916c3a0f427927d4def7","unresolved":false,"context_lines":[{"line_number":273,"context_line":""},{"line_number":274,"context_line":"A third-party repo may contain database models. Each repo has its own alembic"},{"line_number":275,"context_line":"migration branch that adds, removes and modifies its corresponding tables in"},{"line_number":276,"context_line":"the neutron database schema."},{"line_number":277,"context_line":""},{"line_number":278,"context_line":"* Note: Care should be taken when adding new tables. To prevent collision of"},{"line_number":279,"context_line":"  table names it is recommended to prefix them with a vendor/plugin string."}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_a277ba9e","line":276,"in_reply_to":"ba3cc151_bc884172","updated":"2015-07-02 14:28:02.000000000","message":"I made some attempt to specify the independence of tables on lines 286-288 below, but I think that should probably be stated at the beginning of this section and in more detail.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":1561,"name":"Russell Bryant","email":"rbryant@redhat.com","username":"russellb"},"change_message_id":"7a44430094e93e5e61bddefcfa8152d746b26b64","unresolved":false,"context_lines":[{"line_number":273,"context_line":""},{"line_number":274,"context_line":"A third-party repo may contain database models. Each repo has its own alembic"},{"line_number":275,"context_line":"migration branch that adds, removes and modifies its corresponding tables in"},{"line_number":276,"context_line":"the neutron database schema."},{"line_number":277,"context_line":""},{"line_number":278,"context_line":"* Note: Care should be taken when adding new tables. To prevent collision of"},{"line_number":279,"context_line":"  table names it is recommended to prefix them with a vendor/plugin string."}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_22996a7c","line":276,"in_reply_to":"ba3cc151_bc884172","updated":"2015-07-02 14:27:42.000000000","message":"Yes, for some reason I had the impression that there were migrations that did custom mods to core neutron tables, but Henry corrected me and says that\u0027s not the case.  In that case, disregard this comment.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":1561,"name":"Russell Bryant","email":"rbryant@redhat.com","username":"russellb"},"change_message_id":"8b7941c03371308b9960b136901876425f2a7c60","unresolved":false,"context_lines":[{"line_number":273,"context_line":""},{"line_number":274,"context_line":"A third-party repo may contain database models. Each repo has its own alembic"},{"line_number":275,"context_line":"migration branch that adds, removes and modifies its corresponding tables in"},{"line_number":276,"context_line":"the neutron database schema."},{"line_number":277,"context_line":""},{"line_number":278,"context_line":"* Note: Care should be taken when adding new tables. To prevent collision of"},{"line_number":279,"context_line":"  table names it is recommended to prefix them with a vendor/plugin string."}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_4b561107","line":276,"in_reply_to":"ba3cc151_d6b73dd6","updated":"2015-07-02 13:09:28.000000000","message":"I actually think this is terrible and should be explicitly prohibited.  The Neutron tables should be strictly defined and *never* modified.  Any new data should be in a separate database.  For anything that *must* be in the same database, it should be done in such a way that it\u0027s generic and could be used by other drivers if applicable.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":8279,"name":"Fawad Khaliq","email":"fawadkq@gmail.com","username":"fawadkhaliq"},"change_message_id":"d16735915697006cbed1d4bad2bac0a4ea1782ae","unresolved":false,"context_lines":[{"line_number":287,"context_line":"in neutron core tables. However, the alembic branch for a plugin/driver repo"},{"line_number":288,"context_line":"shall never update any part of a table that it does not own."},{"line_number":289,"context_line":""},{"line_number":290,"context_line":"**ToDo: Automatically run all migration branches**"},{"line_number":291,"context_line":"    We aim to update the ``neutron-db-manage`` alembic script for neutron so"},{"line_number":292,"context_line":"    that it can read the neutron configuration information to determine which"},{"line_number":293,"context_line":"    plugins/drivers (and advanced services) are installed. It should then use"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_f980f7f8","line":290,"updated":"2015-07-03 06:55:07.000000000","message":"Migration is one of the main pain points and I believe it requires attention in the first iteration.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"9e058eca9ffef6b9388ce94166f7f0799b92bdca","unresolved":false,"context_lines":[{"line_number":287,"context_line":"in neutron core tables. However, the alembic branch for a plugin/driver repo"},{"line_number":288,"context_line":"shall never update any part of a table that it does not own."},{"line_number":289,"context_line":""},{"line_number":290,"context_line":"**ToDo: Automatically run all migration branches**"},{"line_number":291,"context_line":"    We aim to update the ``neutron-db-manage`` alembic script for neutron so"},{"line_number":292,"context_line":"    that it can read the neutron configuration information to determine which"},{"line_number":293,"context_line":"    plugins/drivers (and advanced services) are installed. It should then use"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_9422b400","line":290,"in_reply_to":"ba3cc151_f980f7f8","updated":"2015-07-03 20:25:54.000000000","message":"Added a note that bug #1470625 is filed for this.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":8279,"name":"Fawad Khaliq","email":"fawadkq@gmail.com","username":"fawadkhaliq"},"change_message_id":"d16735915697006cbed1d4bad2bac0a4ea1782ae","unresolved":false,"context_lines":[{"line_number":298,"context_line":"    If a driver\u0027s table has a reference (for example a foreign key) to a"},{"line_number":299,"context_line":"    neutron core table, and the referred item is changed in neutron, what"},{"line_number":300,"context_line":"    should we do? (This should be a rare occurrence - perhaps we can address"},{"line_number":301,"context_line":"    it on a case-by-case basis?)"},{"line_number":302,"context_line":""},{"line_number":303,"context_line":"Liberty Steps"},{"line_number":304,"context_line":"+++++++++++++"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_d93df32b","line":301,"updated":"2015-07-03 06:55:07.000000000","message":"+1. Indeed it will be a rare case and case-by-case seems reasonable enough.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":8279,"name":"Fawad Khaliq","email":"fawadkq@gmail.com","username":"fawadkhaliq"},"change_message_id":"d16735915697006cbed1d4bad2bac0a4ea1782ae","unresolved":false,"context_lines":[{"line_number":310,"context_line":"#. Create a start migration for the repo\u0027s alembic branch. Note: it is"},{"line_number":311,"context_line":"   recommended to keep the migration file(s) in the same location in the"},{"line_number":312,"context_line":"   third-party repo as is done in the neutron repo,"},{"line_number":313,"context_line":"   i.e. ``networking_foo/db/migration/alembic_migrations/versions/*.py``"},{"line_number":314,"context_line":"#. Remove the models from the neutron repo."},{"line_number":315,"context_line":"#. Add the names of the removed tables to ``DRIVER_TABLES`` in"},{"line_number":316,"context_line":"   ``neutron/db/migration/alembic_migrations/external.py`` (this is used for"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_19003b65","line":313,"updated":"2015-07-03 06:55:07.000000000","message":"How would auto generate utilities in neutron-db-manage will work when trying to generate migration scripts for networking-foo projects? It would be helpful if you can elaborate that a little bit here.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"9e058eca9ffef6b9388ce94166f7f0799b92bdca","unresolved":false,"context_lines":[{"line_number":310,"context_line":"#. Create a start migration for the repo\u0027s alembic branch. Note: it is"},{"line_number":311,"context_line":"   recommended to keep the migration file(s) in the same location in the"},{"line_number":312,"context_line":"   third-party repo as is done in the neutron repo,"},{"line_number":313,"context_line":"   i.e. ``networking_foo/db/migration/alembic_migrations/versions/*.py``"},{"line_number":314,"context_line":"#. Remove the models from the neutron repo."},{"line_number":315,"context_line":"#. Add the names of the removed tables to ``DRIVER_TABLES`` in"},{"line_number":316,"context_line":"   ``neutron/db/migration/alembic_migrations/external.py`` (this is used for"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_4f3019e9","line":313,"in_reply_to":"ba3cc151_19003b65","updated":"2015-07-03 20:25:54.000000000","message":"Added a TODO for this. Its usage will probably be in another document though, maybe just put a pointer to it from here.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":6659,"name":"Paul Michali","email":"pc@michali.net","username":"pcm"},"change_message_id":"aff9341422ebc18ca9267c8ae4d198f0fbe4e37c","unresolved":false,"context_lines":[{"line_number":318,"context_line":""},{"line_number":319,"context_line":""},{"line_number":320,"context_line":"DB Model/Migration Testing"},{"line_number":321,"context_line":"^^^^^^^^^^^^^^^^^^^^^^^^^^"},{"line_number":322,"context_line":""},{"line_number":323,"context_line":"Here is a `template functional test"},{"line_number":324,"context_line":"\u003chttps://bugs.launchpad.net/neutron/+bug/1470678\u003e`_ (TODO:Ann) third-party"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_998b16c3","line":321,"updated":"2015-07-02 11:20:48.000000000","message":"dashes vs carets for level, same as Dbase models and migration?","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"e8a2132d6c27d404a82e11d5a31516887867248b","unresolved":false,"context_lines":[{"line_number":318,"context_line":""},{"line_number":319,"context_line":""},{"line_number":320,"context_line":"DB Model/Migration Testing"},{"line_number":321,"context_line":"^^^^^^^^^^^^^^^^^^^^^^^^^^"},{"line_number":322,"context_line":""},{"line_number":323,"context_line":"Here is a `template functional test"},{"line_number":324,"context_line":"\u003chttps://bugs.launchpad.net/neutron/+bug/1470678\u003e`_ (TODO:Ann) third-party"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_0f156ee3","line":321,"in_reply_to":"ba3cc151_998b16c3","updated":"2015-07-02 15:01:39.000000000","message":"Tildes, I think, will make the heading levels sane. Thanks.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":8279,"name":"Fawad Khaliq","email":"fawadkq@gmail.com","username":"fawadkhaliq"},"change_message_id":"d16735915697006cbed1d4bad2bac0a4ea1782ae","unresolved":false,"context_lines":[{"line_number":348,"context_line":"    console_scripts \u003d"},{"line_number":349,"context_line":"        neutron-foo-agent \u003d networking_foo.cmd.eventlet.agents.foo:main"},{"line_number":350,"context_line":"    neutron.core_plugins \u003d"},{"line_number":351,"context_line":"        foo_legacy \u003d networking_foo.plugins.legacy.plugin:FooPluginV2"},{"line_number":352,"context_line":"    neutron.service_plugins \u003d"},{"line_number":353,"context_line":"        foo_l3 \u003d networking_foo.services.l3_router.l3_foo:FooL3ServicePlugin"},{"line_number":354,"context_line":"    neutron.ml2.type_drivers \u003d"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_b9990fc6","line":351,"updated":"2015-07-03 06:55:07.000000000","message":"not sure if I understand the term \"legacy\" here. Are you referring to core monolithic plugins as legacy? Any particular reason why?","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"9e058eca9ffef6b9388ce94166f7f0799b92bdca","unresolved":false,"context_lines":[{"line_number":348,"context_line":"    console_scripts \u003d"},{"line_number":349,"context_line":"        neutron-foo-agent \u003d networking_foo.cmd.eventlet.agents.foo:main"},{"line_number":350,"context_line":"    neutron.core_plugins \u003d"},{"line_number":351,"context_line":"        foo_legacy \u003d networking_foo.plugins.legacy.plugin:FooPluginV2"},{"line_number":352,"context_line":"    neutron.service_plugins \u003d"},{"line_number":353,"context_line":"        foo_l3 \u003d networking_foo.services.l3_router.l3_foo:FooL3ServicePlugin"},{"line_number":354,"context_line":"    neutron.ml2.type_drivers \u003d"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_54c42c5e","line":351,"in_reply_to":"ba3cc151_b9990fc6","updated":"2015-07-03 20:25:54.000000000","message":"Yes I was referring to core monolithic plugins as legacy. The old OVS and LB monolithic plugins have been converted to ML2 mechanism drivers, so I guess that is why I was equating them with \"legacy\". This term might offend existing monolithic plugins though, so I will just use \"monolithic\" instead.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"9320bc13fa6d50d868193b076e75875e2550c478","unresolved":false,"context_lines":[{"line_number":379,"context_line":"from the networking-l2gw project."},{"line_number":380,"context_line":""},{"line_number":381,"context_line":"**ToDo**"},{"line_number":382,"context_line":"    (Armando) We need a mechanism for avoiding \u0027hack-ish\u0027 things like done in"},{"line_number":383,"context_line":"    https://github.com/openstack/networking-l2gw/blob/master/networking_l2gw/extensions/l2gateway.py#L27-L30"},{"line_number":384,"context_line":""},{"line_number":385,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_69f87dc5","line":382,"updated":"2015-07-03 18:22:16.000000000","message":"This is being tackled in [1].\n\nI guess we can remove this TODO and say that one can either use library API [2] or use config option [3] when deploying:\n\n [1] https://review.openstack.org/#/q/topic:prefix-cleanup,n,z\n [2] https://github.com/openstack/neutron/blob/master/neutron/api/extensions.py#L672\n [3] https://github.com/openstack/neutron/blob/master/etc/neutron.conf#L47","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"9e058eca9ffef6b9388ce94166f7f0799b92bdca","unresolved":false,"context_lines":[{"line_number":379,"context_line":"from the networking-l2gw project."},{"line_number":380,"context_line":""},{"line_number":381,"context_line":"**ToDo**"},{"line_number":382,"context_line":"    (Armando) We need a mechanism for avoiding \u0027hack-ish\u0027 things like done in"},{"line_number":383,"context_line":"    https://github.com/openstack/networking-l2gw/blob/master/networking_l2gw/extensions/l2gateway.py#L27-L30"},{"line_number":384,"context_line":""},{"line_number":385,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_74d050f8","line":382,"in_reply_to":"ba3cc151_69f87dc5","updated":"2015-07-03 20:25:54.000000000","message":"Done","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":1561,"name":"Russell Bryant","email":"rbryant@redhat.com","username":"russellb"},"change_message_id":"8b7941c03371308b9960b136901876425f2a7c60","unresolved":false,"context_lines":[{"line_number":380,"context_line":""},{"line_number":381,"context_line":"**ToDo**"},{"line_number":382,"context_line":"    (Armando) We need a mechanism for avoiding \u0027hack-ish\u0027 things like done in"},{"line_number":383,"context_line":"    https://github.com/openstack/networking-l2gw/blob/master/networking_l2gw/extensions/l2gateway.py#L27-L30"},{"line_number":384,"context_line":""},{"line_number":385,"context_line":""},{"line_number":386,"context_line":"Interface Drivers"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_8b6179ab","line":383,"updated":"2015-07-02 13:09:28.000000000","message":"I\u0027d like to see a note in this section saying that no further driver specific API extensions should not be added.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"9e058eca9ffef6b9388ce94166f7f0799b92bdca","unresolved":false,"context_lines":[{"line_number":380,"context_line":""},{"line_number":381,"context_line":"**ToDo**"},{"line_number":382,"context_line":"    (Armando) We need a mechanism for avoiding \u0027hack-ish\u0027 things like done in"},{"line_number":383,"context_line":"    https://github.com/openstack/networking-l2gw/blob/master/networking_l2gw/extensions/l2gateway.py#L27-L30"},{"line_number":384,"context_line":""},{"line_number":385,"context_line":""},{"line_number":386,"context_line":"Interface Drivers"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_34dac818","line":383,"in_reply_to":"ba3cc151_4951f9d7","updated":"2015-07-03 20:25:54.000000000","message":"I have created bug #1471325 to split out the cisco stuff from the client.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"e8a2132d6c27d404a82e11d5a31516887867248b","unresolved":false,"context_lines":[{"line_number":380,"context_line":""},{"line_number":381,"context_line":"**ToDo**"},{"line_number":382,"context_line":"    (Armando) We need a mechanism for avoiding \u0027hack-ish\u0027 things like done in"},{"line_number":383,"context_line":"    https://github.com/openstack/networking-l2gw/blob/master/networking_l2gw/extensions/l2gateway.py#L27-L30"},{"line_number":384,"context_line":""},{"line_number":385,"context_line":""},{"line_number":386,"context_line":"Interface Drivers"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_cf7f86de","line":383,"in_reply_to":"ba3cc151_8b6179ab","updated":"2015-07-02 15:01:39.000000000","message":"So say a new project similar to l2gw comes along. What should they do instead?","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"9320bc13fa6d50d868193b076e75875e2550c478","unresolved":false,"context_lines":[{"line_number":380,"context_line":""},{"line_number":381,"context_line":"**ToDo**"},{"line_number":382,"context_line":"    (Armando) We need a mechanism for avoiding \u0027hack-ish\u0027 things like done in"},{"line_number":383,"context_line":"    https://github.com/openstack/networking-l2gw/blob/master/networking_l2gw/extensions/l2gateway.py#L27-L30"},{"line_number":384,"context_line":""},{"line_number":385,"context_line":""},{"line_number":386,"context_line":"Interface Drivers"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_4951f9d7","line":383,"in_reply_to":"ba3cc151_92a7610a","updated":"2015-07-03 18:22:16.000000000","message":"To be honest I don\u0027t think this is the place for this discussion. For better or for worse, Neutron has been conceived as a pluggable framework, on many levels, CLI, API, plugins, drivers, etc, and the decomposition work should not alter that, but only describe how to leverage that pluggability, in a new  OOO (out-of-tree) world.\n\nIf pluggability changes are made, then this devref should reflect that.\n\nNow going to Russell\u0027s point of view for the CLI, I agree that \u0027stock\u0027 neutron cli should not have built-in vendor extensions, but the CLI itself can be customized, so that extensions can be plugged into it. So customer A can see one flavor of neutron help, customer B can see another.\n\nThe very core command of neutron \u0027ext-list\u0027 shows that diversity since day 1 of the project.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":1561,"name":"Russell Bryant","email":"rbryant@redhat.com","username":"russellb"},"change_message_id":"7ae4aa377fd618da23a6eeacb2448e69cf920ca4","unresolved":false,"context_lines":[{"line_number":380,"context_line":""},{"line_number":381,"context_line":"**ToDo**"},{"line_number":382,"context_line":"    (Armando) We need a mechanism for avoiding \u0027hack-ish\u0027 things like done in"},{"line_number":383,"context_line":"    https://github.com/openstack/networking-l2gw/blob/master/networking_l2gw/extensions/l2gateway.py#L27-L30"},{"line_number":384,"context_line":""},{"line_number":385,"context_line":""},{"line_number":386,"context_line":"Interface Drivers"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_92a7610a","line":383,"in_reply_to":"ba3cc151_cf7f86de","updated":"2015-07-02 15:06:14.000000000","message":"Well, my impression is that l2gw provides a generic REST API that could be implemented by another driver.  I need to look closer, though.  We were planning to implement this interface with OVN, for example.\n\nWhat I\u0027m really talking about here is something that is absolutely backend specific and couldn\u0027t possibly be implemented by anyone else.  As an example, if you run \"neutron help\" and see all the APIs with a \"cisco-\" prefix, I think that\u0027s fundamentally wrong and should not be allowed in the Neutron API at all.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"19950dd8b68463aa884283656e0485c53fd8a3d8","unresolved":false,"context_lines":[{"line_number":438,"context_line":""},{"line_number":439,"context_line":"(These are still TBD.)"},{"line_number":440,"context_line":""},{"line_number":441,"context_line":"* Splitting policy.json? **ToDo** Armando will investigate."},{"line_number":442,"context_line":""},{"line_number":443,"context_line":"* Generic instructions (or a template) for installing an out-of-tree plugin or"},{"line_number":444,"context_line":"  driver for Neutron. Possibly something for the networking guide, and/or a"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_c3075d80","line":441,"updated":"2015-07-02 15:54:23.000000000","message":"(comment only) policy_dirs configuration is deprecated in oslo.policy now, but I think it is a possible option and we can discuss it with the Oslo team. Honestly I don\u0027t know the background why this option is deprecated.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"c5d19c23ac290c45c2dd26ae1147c0ca61ae74e0","unresolved":false,"context_lines":[{"line_number":438,"context_line":""},{"line_number":439,"context_line":"(These are still TBD.)"},{"line_number":440,"context_line":""},{"line_number":441,"context_line":"* Splitting policy.json? **ToDo** Armando will investigate."},{"line_number":442,"context_line":""},{"line_number":443,"context_line":"* Generic instructions (or a template) for installing an out-of-tree plugin or"},{"line_number":444,"context_line":"  driver for Neutron. Possibly something for the networking guide, and/or a"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_a791c954","line":441,"in_reply_to":"ba3cc151_b4fc9873","updated":"2015-07-04 04:54:46.000000000","message":"Sure. We first need to know the reason why policy_dirs is deprecated.","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"9e058eca9ffef6b9388ce94166f7f0799b92bdca","unresolved":false,"context_lines":[{"line_number":438,"context_line":""},{"line_number":439,"context_line":"(These are still TBD.)"},{"line_number":440,"context_line":""},{"line_number":441,"context_line":"* Splitting policy.json? **ToDo** Armando will investigate."},{"line_number":442,"context_line":""},{"line_number":443,"context_line":"* Generic instructions (or a template) for installing an out-of-tree plugin or"},{"line_number":444,"context_line":"  driver for Neutron. Possibly something for the networking guide, and/or a"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba3cc151_b4fc9873","line":441,"in_reply_to":"ba3cc151_c3075d80","updated":"2015-07-03 20:25:54.000000000","message":"Can you start this discussion with the oslo team and keep us informed?","commit_id":"a5b2fba5c8970adbfdd2d43a1be3f5e9c18f3378"},{"author":{"_account_id":6598,"name":"Berezovsky Irena","email":"irenab.dev@gmail.com","username":"irenab"},"change_message_id":"391d577e7523195301273ace508725e79edf96bb","unresolved":false,"context_lines":[{"line_number":49,"context_line":"Contribution Process"},{"line_number":50,"context_line":"--------------------"},{"line_number":51,"context_line":""},{"line_number":52,"context_line":"If you want to want to extend OpenStack Networking with your technology, and"},{"line_number":53,"context_line":"you want to do it within the visibility of the OpenStack project, follow the"},{"line_number":54,"context_line":"guidelines and examples below. We\u0027ll describe best practices for:"},{"line_number":55,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"ba3cc151_db970439","line":52,"updated":"2015-07-04 18:39:50.000000000","message":"Remove \u0027to want\u0027","commit_id":"4a15bfc0ce6636b644a67f17d5fa382a39410969"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"e18aa54b3bcf6d51dcaa02eaf41037f8b0089238","unresolved":false,"context_lines":[{"line_number":49,"context_line":"Contribution Process"},{"line_number":50,"context_line":"--------------------"},{"line_number":51,"context_line":""},{"line_number":52,"context_line":"If you want to want to extend OpenStack Networking with your technology, and"},{"line_number":53,"context_line":"you want to do it within the visibility of the OpenStack project, follow the"},{"line_number":54,"context_line":"guidelines and examples below. We\u0027ll describe best practices for:"},{"line_number":55,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"ba3cc151_3bfe2906","line":52,"in_reply_to":"ba3cc151_db970439","updated":"2015-07-06 14:58:23.000000000","message":"Done","commit_id":"4a15bfc0ce6636b644a67f17d5fa382a39410969"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"16e78fac3ab92486f9dcf1cc4a2cd69f726e9a7c","unresolved":false,"context_lines":[{"line_number":399,"context_line":"Extensions can be loaded in two ways:"},{"line_number":400,"context_line":""},{"line_number":401,"context_line":"#. Use the ``append_api_extensions_path()`` library API. See"},{"line_number":402,"context_line":"   https://github.com/openstack/neutron/blob/master/neutron/api/extensions.py#L672"},{"line_number":403,"context_line":"#. Leverage the ``api_extensions_path`` config variable when deploying. See"},{"line_number":404,"context_line":"   https://github.com/openstack/neutron/blob/master/etc/neutron.conf#L52"},{"line_number":405,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"ba3cc151_9d78942d","line":402,"updated":"2015-07-04 11:48:34.000000000","message":"This may be subject to movement, so the link might become stale, but I don\u0027t have a better idea right now.","commit_id":"4a15bfc0ce6636b644a67f17d5fa382a39410969"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"e18aa54b3bcf6d51dcaa02eaf41037f8b0089238","unresolved":false,"context_lines":[{"line_number":399,"context_line":"Extensions can be loaded in two ways:"},{"line_number":400,"context_line":""},{"line_number":401,"context_line":"#. Use the ``append_api_extensions_path()`` library API. See"},{"line_number":402,"context_line":"   https://github.com/openstack/neutron/blob/master/neutron/api/extensions.py#L672"},{"line_number":403,"context_line":"#. Leverage the ``api_extensions_path`` config variable when deploying. See"},{"line_number":404,"context_line":"   https://github.com/openstack/neutron/blob/master/etc/neutron.conf#L52"},{"line_number":405,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"ba3cc151_b2a9e126","line":402,"in_reply_to":"ba3cc151_9d78942d","updated":"2015-07-06 14:58:23.000000000","message":"I reworded this so that the reader has to look up the API in the source code. After all, this is a developer reference.","commit_id":"4a15bfc0ce6636b644a67f17d5fa382a39410969"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"16e78fac3ab92486f9dcf1cc4a2cd69f726e9a7c","unresolved":false,"context_lines":[{"line_number":401,"context_line":"#. Use the ``append_api_extensions_path()`` library API. See"},{"line_number":402,"context_line":"   https://github.com/openstack/neutron/blob/master/neutron/api/extensions.py#L672"},{"line_number":403,"context_line":"#. Leverage the ``api_extensions_path`` config variable when deploying. See"},{"line_number":404,"context_line":"   https://github.com/openstack/neutron/blob/master/etc/neutron.conf#L52"},{"line_number":405,"context_line":""},{"line_number":406,"context_line":""},{"line_number":407,"context_line":"Interface Drivers"}],"source_content_type":"text/x-rst","patch_set":5,"id":"ba3cc151_3d75c831","line":404,"updated":"2015-07-04 11:48:34.000000000","message":"ditto","commit_id":"4a15bfc0ce6636b644a67f17d5fa382a39410969"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"e18aa54b3bcf6d51dcaa02eaf41037f8b0089238","unresolved":false,"context_lines":[{"line_number":401,"context_line":"#. Use the ``append_api_extensions_path()`` library API. See"},{"line_number":402,"context_line":"   https://github.com/openstack/neutron/blob/master/neutron/api/extensions.py#L672"},{"line_number":403,"context_line":"#. Leverage the ``api_extensions_path`` config variable when deploying. See"},{"line_number":404,"context_line":"   https://github.com/openstack/neutron/blob/master/etc/neutron.conf#L52"},{"line_number":405,"context_line":""},{"line_number":406,"context_line":""},{"line_number":407,"context_line":"Interface Drivers"}],"source_content_type":"text/x-rst","patch_set":5,"id":"ba3cc151_d2a6e552","line":404,"in_reply_to":"ba3cc151_3d75c831","updated":"2015-07-06 14:58:23.000000000","message":"ditto","commit_id":"4a15bfc0ce6636b644a67f17d5fa382a39410969"},{"author":{"_account_id":105,"name":"Kyle Mestery","email":"mestery@mestery.com","username":"mestery"},"change_message_id":"09749f280163feb7d99c10bafd6a314fe12044a7","unresolved":false,"context_lines":[{"line_number":362,"context_line":"* Create 3rd Party CI account: if you do not already have one, follow"},{"line_number":363,"context_line":"  instructions for"},{"line_number":364,"context_line":"  `3rd Party CI \u003chttp://docs.openstack.org/infra/system-config/third_party.html\u003e`_ to get one."},{"line_number":365,"context_line":"* TODO(armax): ..."},{"line_number":366,"context_line":""},{"line_number":367,"context_line":""},{"line_number":368,"context_line":"Decomposition progress chart"}],"source_content_type":"text/x-rst","patch_set":6,"id":"ba3cc151_6e37f5e3","side":"PARENT","line":365,"updated":"2015-07-06 15:23:56.000000000","message":"What is armax going to do here?","commit_id":"211c0355778c1aef0dd4a44553f604b4fa3f72b3"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"fde1754deff203d1d8995127335f1a8883452192","unresolved":false,"context_lines":[{"line_number":362,"context_line":"* Create 3rd Party CI account: if you do not already have one, follow"},{"line_number":363,"context_line":"  instructions for"},{"line_number":364,"context_line":"  `3rd Party CI \u003chttp://docs.openstack.org/infra/system-config/third_party.html\u003e`_ to get one."},{"line_number":365,"context_line":"* TODO(armax): ..."},{"line_number":366,"context_line":""},{"line_number":367,"context_line":""},{"line_number":368,"context_line":"Decomposition progress chart"}],"source_content_type":"text/x-rst","patch_set":6,"id":"ba3cc151_6b0efce6","side":"PARENT","line":365,"in_reply_to":"ba3cc151_6e37f5e3","updated":"2015-07-06 18:18:51.000000000","message":"One day hopefully provide more details of how to leverage the infra resources to do testing. Removing the TODO for now.","commit_id":"211c0355778c1aef0dd4a44553f604b4fa3f72b3"},{"author":{"_account_id":105,"name":"Kyle Mestery","email":"mestery@mestery.com","username":"mestery"},"change_message_id":"09749f280163feb7d99c10bafd6a314fe12044a7","unresolved":false,"context_lines":[{"line_number":72,"context_line":"----------------------"},{"line_number":73,"context_line":""},{"line_number":74,"context_line":"Assuming you have a working repository, any development to your own repo does"},{"line_number":75,"context_line":"not need any blueprint, specification or bugs against Neutron."},{"line_number":76,"context_line":""},{"line_number":77,"context_line":"If your code is hosted on git.openstack.org then the gerrit review system is"},{"line_number":78,"context_line":"automatically provided. Contributors should follow the review guidelines"}],"source_content_type":"text/x-rst","patch_set":6,"id":"ba3cc151_883590f8","line":75,"updated":"2015-07-06 15:23:56.000000000","message":"Add this:\n\n\"However, if your project is a part of the Neutron Stadium effort, you are expected to participate in the principles of the Four Opens, meaning your design should be done in the open. Thus, it is encouraged to file documentation for changes in your own repository.\"","commit_id":"ec7bad93edb8689c08cc3e80350592814e0f41e1"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"fde1754deff203d1d8995127335f1a8883452192","unresolved":false,"context_lines":[{"line_number":72,"context_line":"----------------------"},{"line_number":73,"context_line":""},{"line_number":74,"context_line":"Assuming you have a working repository, any development to your own repo does"},{"line_number":75,"context_line":"not need any blueprint, specification or bugs against Neutron."},{"line_number":76,"context_line":""},{"line_number":77,"context_line":"If your code is hosted on git.openstack.org then the gerrit review system is"},{"line_number":78,"context_line":"automatically provided. Contributors should follow the review guidelines"}],"source_content_type":"text/x-rst","patch_set":6,"id":"ba3cc151_959d9d5b","line":75,"in_reply_to":"ba3cc151_883590f8","updated":"2015-07-06 18:18:51.000000000","message":"Done","commit_id":"ec7bad93edb8689c08cc3e80350592814e0f41e1"},{"author":{"_account_id":105,"name":"Kyle Mestery","email":"mestery@mestery.com","username":"mestery"},"change_message_id":"09749f280163feb7d99c10bafd6a314fe12044a7","unresolved":false,"context_lines":[{"line_number":85,"context_line":"checking the third-party code against Neutron changes. See `Testing and"},{"line_number":86,"context_line":"Continuous Integration`_ below for more detailed recommendations."},{"line_number":87,"context_line":""},{"line_number":88,"context_line":"Design documents can still be supplied in form of RST documents, within the"},{"line_number":89,"context_line":"same third-party library repo. If changes to the common Neutron code are"},{"line_number":90,"context_line":"required, an `RFE"},{"line_number":91,"context_line":"\u003chttp://docs.openstack.org/developer/neutron/policies/blueprints.html#neutron-request-for-feature-enhancements\u003e`_"}],"source_content_type":"text/x-rst","patch_set":6,"id":"ba3cc151_e8245cc7","line":88,"updated":"2015-07-06 15:23:56.000000000","message":"s/RST/Restructured Text (RST)/","commit_id":"ec7bad93edb8689c08cc3e80350592814e0f41e1"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"fde1754deff203d1d8995127335f1a8883452192","unresolved":false,"context_lines":[{"line_number":85,"context_line":"checking the third-party code against Neutron changes. See `Testing and"},{"line_number":86,"context_line":"Continuous Integration`_ below for more detailed recommendations."},{"line_number":87,"context_line":""},{"line_number":88,"context_line":"Design documents can still be supplied in form of RST documents, within the"},{"line_number":89,"context_line":"same third-party library repo. If changes to the common Neutron code are"},{"line_number":90,"context_line":"required, an `RFE"},{"line_number":91,"context_line":"\u003chttp://docs.openstack.org/developer/neutron/policies/blueprints.html#neutron-request-for-feature-enhancements\u003e`_"}],"source_content_type":"text/x-rst","patch_set":6,"id":"ba3cc151_75afb97d","line":88,"in_reply_to":"ba3cc151_e8245cc7","updated":"2015-07-06 18:18:51.000000000","message":"Done","commit_id":"ec7bad93edb8689c08cc3e80350592814e0f41e1"},{"author":{"_account_id":105,"name":"Kyle Mestery","email":"mestery@mestery.com","username":"mestery"},"change_message_id":"09749f280163feb7d99c10bafd6a314fe12044a7","unresolved":false,"context_lines":[{"line_number":147,"context_line":""},{"line_number":148,"context_line":"See `this openstack-dev mailing list message"},{"line_number":149,"context_line":"\u003chttp://lists.openstack.org/pipermail/openstack-dev/2015-July/068617.html\u003e`_"},{"line_number":150,"context_line":"for detailed answers to the following questions:"},{"line_number":151,"context_line":""},{"line_number":152,"context_line":"* How should security issues be managed?"},{"line_number":153,"context_line":"* Should the OpenStack security team be involved?"}],"source_content_type":"text/x-rst","patch_set":6,"id":"ba3cc151_ae0dfd38","line":150,"updated":"2015-07-06 15:23:56.000000000","message":"Can we put the answers here instead of relying on the mailing list post?","commit_id":"ec7bad93edb8689c08cc3e80350592814e0f41e1"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"fde1754deff203d1d8995127335f1a8883452192","unresolved":false,"context_lines":[{"line_number":147,"context_line":""},{"line_number":148,"context_line":"See `this openstack-dev mailing list message"},{"line_number":149,"context_line":"\u003chttp://lists.openstack.org/pipermail/openstack-dev/2015-July/068617.html\u003e`_"},{"line_number":150,"context_line":"for detailed answers to the following questions:"},{"line_number":151,"context_line":""},{"line_number":152,"context_line":"* How should security issues be managed?"},{"line_number":153,"context_line":"* Should the OpenStack security team be involved?"}],"source_content_type":"text/x-rst","patch_set":6,"id":"ba3cc151_d8083c94","line":150,"in_reply_to":"ba3cc151_ae0dfd38","updated":"2015-07-06 18:18:51.000000000","message":"It felt a bit odd just copying Jeremy\u0027s responses straight into the doc here, but OK. I will also reply to his email to let him know that we have stolen his words. :)","commit_id":"ec7bad93edb8689c08cc3e80350592814e0f41e1"},{"author":{"_account_id":6697,"name":"Sandhya Dasu","email":"sandhya.openinfra@gmail.com","username":"sadasu"},"change_message_id":"36b8c726881a54ca20eb3bd5bbd22a0f0fad9409","unresolved":false,"context_lines":[{"line_number":232,"context_line":"* Fix, fix, fix: at this point you have an external base to work on. You can"},{"line_number":233,"context_line":"  develop against the new git.openstack.org project, the same way you work with"},{"line_number":234,"context_line":"  any other OpenStack project: you have pep8, docs, and python27 CI jobs that"},{"line_number":235,"context_line":"  validate your patches when posted to Gerrit. For instance, one thing you"},{"line_number":236,"context_line":"  would need to do is to define an entry point for your plugin or driver in"},{"line_number":237,"context_line":"  your own setup.cfg similarly as to how it is done in the `setup.cfg for ODL"},{"line_number":238,"context_line":"  \u003chttps://git.openstack.org/cgit/openstack/networking-odl/tree/setup.cfg#n31\u003e`_."}],"source_content_type":"text/x-rst","patch_set":6,"id":"ba3cc151_dbf26f06","line":235,"updated":"2015-07-06 21:24:37.000000000","message":"Theset of lines starting from \"For instance\" can be moved under the next bullet point.","commit_id":"ec7bad93edb8689c08cc3e80350592814e0f41e1"},{"author":{"_account_id":105,"name":"Kyle Mestery","email":"mestery@mestery.com","username":"mestery"},"change_message_id":"09749f280163feb7d99c10bafd6a314fe12044a7","unresolved":false,"context_lines":[{"line_number":258,"context_line":"the Neutron tree. Each category of code and its removal plan is described"},{"line_number":259,"context_line":"below."},{"line_number":260,"context_line":""},{"line_number":261,"context_line":"**NOTE!** Third-party plugins/drivers which do not start decomposition in"},{"line_number":262,"context_line":"Liberty will be marked as deprecated, and they will be removed before the"},{"line_number":263,"context_line":"Mita-3 milestone."},{"line_number":264,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"ba3cc151_6eacd5ed","line":261,"updated":"2015-07-06 15:23:56.000000000","message":"This needs to be highlighted at the top of this document, because it\u0027s a serious thing which everyone needs to read. We need to publish this at each meeting, send emails to the list, and try to reach out to plugin owners in-tree. In short, it\u0027s going to suck but we have to do it if we\u0027re going to remove code from people who are not a part of this community except on the marketing side and have been getting a free ride up until now.","commit_id":"ec7bad93edb8689c08cc3e80350592814e0f41e1"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"fde1754deff203d1d8995127335f1a8883452192","unresolved":false,"context_lines":[{"line_number":258,"context_line":"the Neutron tree. Each category of code and its removal plan is described"},{"line_number":259,"context_line":"below."},{"line_number":260,"context_line":""},{"line_number":261,"context_line":"**NOTE!** Third-party plugins/drivers which do not start decomposition in"},{"line_number":262,"context_line":"Liberty will be marked as deprecated, and they will be removed before the"},{"line_number":263,"context_line":"Mita-3 milestone."},{"line_number":264,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"ba3cc151_3802883f","line":261,"in_reply_to":"ba3cc151_6eacd5ed","updated":"2015-07-06 18:18:51.000000000","message":"Blurb moved to the very top.","commit_id":"ec7bad93edb8689c08cc3e80350592814e0f41e1"},{"author":{"_account_id":105,"name":"Kyle Mestery","email":"mestery@mestery.com","username":"mestery"},"change_message_id":"09749f280163feb7d99c10bafd6a314fe12044a7","unresolved":false,"context_lines":[{"line_number":260,"context_line":""},{"line_number":261,"context_line":"**NOTE!** Third-party plugins/drivers which do not start decomposition in"},{"line_number":262,"context_line":"Liberty will be marked as deprecated, and they will be removed before the"},{"line_number":263,"context_line":"Mita-3 milestone."},{"line_number":264,"context_line":""},{"line_number":265,"context_line":""},{"line_number":266,"context_line":"Existing Shims"}],"source_content_type":"text/x-rst","patch_set":6,"id":"ba3cc151_88991022","line":263,"updated":"2015-07-06 15:23:56.000000000","message":"While I like Mita, perhaps adding \"Mxxx\" is more appropriate. Unless you know something about the Mxxx name which I do not. ;)","commit_id":"ec7bad93edb8689c08cc3e80350592814e0f41e1"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"fde1754deff203d1d8995127335f1a8883452192","unresolved":false,"context_lines":[{"line_number":260,"context_line":""},{"line_number":261,"context_line":"**NOTE!** Third-party plugins/drivers which do not start decomposition in"},{"line_number":262,"context_line":"Liberty will be marked as deprecated, and they will be removed before the"},{"line_number":263,"context_line":"Mita-3 milestone."},{"line_number":264,"context_line":""},{"line_number":265,"context_line":""},{"line_number":266,"context_line":"Existing Shims"}],"source_content_type":"text/x-rst","patch_set":6,"id":"ba3cc151_58ff4c34","line":263,"in_reply_to":"ba3cc151_88991022","updated":"2015-07-06 18:18:51.000000000","message":"Done","commit_id":"ec7bad93edb8689c08cc3e80350592814e0f41e1"},{"author":{"_account_id":105,"name":"Kyle Mestery","email":"mestery@mestery.com","username":"mestery"},"change_message_id":"803eab6709047a264eefe34ed1348a21eb848b5c","unresolved":false,"context_lines":[{"line_number":8,"context_line":"be marked as deprecated, and they will be removed before the Mxxx-3"},{"line_number":9,"context_line":"milestone.**"},{"line_number":10,"context_line":""},{"line_number":11,"context_line":"Read on for details ..."},{"line_number":12,"context_line":""},{"line_number":13,"context_line":""},{"line_number":14,"context_line":"Introduction"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ba3cc151_c43055a1","line":11,"updated":"2015-07-06 19:34:33.000000000","message":"Love this.","commit_id":"b510dd5c2e4eb6c33be1e047e00991ce51d6aec0"}]}
