Neutron Plugins and Drivers

2014-09-05T20:29:29Z

Andrew Grimberg: /* Existing Plugin and Drivers */ note recheck command for OpenDaylight CI

=== Introduction ===
Ensuring release quality through proper testing is an important tenant of the OpenStack community and Neutron team wants to do our part. We are introducing changes below provide more visibility into the quality and stability of vendor plugin and driver code. The policies described here are in effect immediately.

=== Rationale ===
Code proposals for third party plugins have always presented a review challenge for the Neutron core team. In the early days, code was often proposed by core project contributors and our review process only validated whether the requirements were met for community coding style and unit testing. As Neutron has added new resources via extensions, it has become more difficult for Neutron reviewers to ensure the proposed code is functional. Many of the plugins and/or drivers require proprietary hardware and/or software to conduct such testing.

In addition to testing changes, the Neutron team is revising the requirements for the point of contact for third party code. The changes bring the written expectations for contacts in line with current practice.

=== Plugin and Driver Processes ===
Getting a plugin or driver merged upstream into Neutron allows you the benefit of being a part of the simultaneous release, and likely having your plugin or driver packaged with distributions which ship releases based on the simultaneous releases from upstream. However, this is not a "free ride", you should ideally be giving back more than you are taking by getting your code upstream. When you submit your code, you're putting a burden on the existing reviews and infrastructure. The same goes with subsequent bug fixes and backports to stable releases. Thus, you should have someone from your company or team reviewing other code upstream, participating in meetings, etc. The following is a list of requirements for inclusion of code upstream:
* Code which passes review, has adequate unit tests, and passes pep8 guidelines.
* A [http://ci.openstack.org/third_party.html functioning CI system], which has been running successfully against your plugin/driver patches, and other patches as well.
* Participation in Neutron meetings, IRC channels, and email lists.
* A member of the plugin/driver team participating in code reviews of other upstream code.

=== Removal of Upstream Plugins or Drivers ===
If you fail to meet the criteria above, you risk having your plugin or driver removed from upstream. The core team will continue to evaluate third party CI systems to ensure they are running and correctly testing patches for third party plugins and drivers. If they fail to function, an email will be sent to the openstack-dev mailing list asking for the owner to fix this issue. Ideally, the owner will reply to the email thread, and will work with the Neutron and Infra teams to address the CI issue. If no reply is received or if adequate progress is not being made to address the issue within 2 weeks, a process to remove the plugin or driver from upstream will commence. To get your plugin or driver upstream after it has been removed will take a functioning third party CI system running for a month, correctly voting on changes upstream.

=== Point of Contact Requirements ===
Each third party plugin and/or driver shall designate a point of contact for each coordinated release cycle. The contact will serve as a liaison between the Neutron core team and the vendor or community supporting the plugin or driver. The contact shall:

* Attend weekly Neutron team IRC meetings
* Be an active reviewer and contributor
* Be an active participant on openstack-dev mailing list
* Assist the core team with triaging bugs specific to the plugin and/or driver
* Ensure OpenStack development deadlines are properly communicated back to their company and/or community

=== Testing Requirements ===
https://wiki.openstack.org/wiki/NeutronThirdPartyTesting

=== Existing Plugin and Drivers ===
Plugins and drivers currently in the Neutron project repository will be given a grace period until the Icehouse-2 milestone to implement external third party testing. At that time, the Neutron team will release a list of the compatible plugins and drivers (i.e. those that meet the testing requirements). Plugins and drivers that do not have external testing will be deprecated at the Icehouse release and will be candidates for removal when the J-release cycle opens.

The page [[ThirdPartySystems]] gathers information about all third party CI system (including Neutron related).

{| class="wikitable"
|-
! Vendor !! Plugin/Driver Name !! Contact Name !! Status !! Recheck command !! Notes
|-
| Neutron Team || ML2 - OVS/LB || Infra Team || Y || || Covered by Infra (Jenkins)
|-
| A10 Networks || LBaaS Driver || Doug Wiegley || Y || recheck-a10 || None
|-
| Arista Networks || ML2 Driver || Sukhdev Kapur || Y || recheck/reverify no bug/bug # || None
|-
| Big Switch || Plugin || Kevin Benton || Y || recheck-bigswitch || None
|-
| Big Switch || ML2 Driver || Kevin Benton || Y || || None
|-
| Brocade || Vyatta Plugin || Karthik Natarajan || Y || || None
|-
| Brocade || ML2 Driver || Shiv Haris || Y || || None
|-
| Cisco || Plugin - NXOS || Dane Leblanc || N || || It is deprecated and It will be removed in Juno
|-
| Cisco || Plugin - N1Kv || Dane Leblanc || Y || || None
|-
| Cisco || ML2 - APIC || Dane Leblanc || Y || || None
|-
| Cisco || ML2 - DFA || Dane Leblanc || Y || || None
|-
| Cisco || ML2 - NXOS || Dane Leblanc || Y || || None
|-
| Cisco || VPNaaS - Driver || Dane Leblanc || Y || || None
|-
| Cloudbase Solutions || Plugin - Hyper-V || Alessandro Pilotti || Y || check hyper-v || None
|-
| Embrane || Plugin || Ignacio Scopetta || N ||embrane-recheck|| CI fails for their own plugin commits: https://review.openstack.org/#/c/108226/
|-
| Embrane || LBaaS - Driver || Ignacio Scopetta || N ||embrane-recheck|| No CI in place. Candidate to be removed from Neutron
|-
| Freescale || ML2 - Driver || Trinath Somanchi || Y || || None
|-
| Freescale || FWaaS - Driver || Trinath Somanchi || Y || || None
|-
| IBM || Plugin - SDN-VE || Daya Kamath || - || || Results are not clear. Need clarification from IBM
|-
| Juniper || Plugin - Contrail || Rudra Rugge || Y || || Needs to start testing all Neutron commits. Plugins just got merged in Juno-3
|-
| Mellanox || Plugin || Omri Marcovitch || N || recheck mlnx || It is deprecated. Will be removed in Kilo
|-
| Mellanox || ML2 - Driver || Omri Marcovitch || Y || recheck mlnx || None
|-
| Mellanox || ML2 - Sriovnic switch || Omri Marcovitch || Y || recheck mlnx || None
|-
| Metaplugin || Plugin - Multiple || NTT Team || N || || It is missing some Neutron commits
|-
| Midokura || Plugin - Midonet || Lucas Eznarriaga || Y || recheck midokura|| None
|-
| NEC || Plugin - OpenFlow || Akihiro Motoki || Y || recheck-nec || None
|-
| Citrix NetScaler || LBaaS - Driver || Parikshit Manur || Y || || None
|-
| Nuage Networks || Plugin - VSP || Franck Yelles || Y || || None
|-
| OFAgent || ML2 - OF || Yamamoto Takashi || Y || recheck-ryu || None
|-
| One Convergence || Plugin - NVSD || Hemanth Ravi || Y || || None
|-
| OpenDaylight || ML2 - ODL || Dave Tucker (dave_tucker) / Kyle Mestery (mestery) || - || recheck-opendaylight || It is missing some Neutron commits
|-
| PLUMgrid || Plugin - Director || Fawad Khaliq || Y || || None
|-
| Ryu || Plugin - Ryu Controller || Yamamoto Takashi || Y || recheck-ryu || It is been deprecated and It will be removed in Kilo
|-
| Radware || LBaaS - Driver || Samuel Bercovici || N || || CI does not exist. Should be removed from Neutron
|-
| Tail-f NCS || ML2 - NCS || Luke Gorrie || Y || || None
|-
| vArmour || FWaaS || Gary Duan || '''N''' || || CI results are not accurate, it shows PASSED for Negative tests. CI does not post results in a public site: http://10.150.10.100:8080/job/vArmour-Neutron-CI/2273/
|-
| VMware || Plugin - NSX || Aaron Rosen || Y || || VMware team is working on some issues with the CI
|}

ThirdPartySystems/OpenDaylight CI

2014-09-02T21:16:15Z

Andrew Grimberg: Fill in base information for ODL Jenkins

{{ThirdPartySystemInfo|name=OpenDaylight CI
|account=odl-jenkins
|contact=The Linux Foundation Collaborative Projects admin team, odl-openstack@opendaylight.org
|intent=Neutron testing for OpenDaylight mechanism driver
|structure=Jenkins using Gerrit Trigger plugin
|method=what you are actually doing
|programs=touched by this system
|status=in production, voting}}

ThirdPartySystems/OpenDaylight CI

2014-09-02T21:11:47Z

Andrew Grimberg: Initial version of page

{{ThirdPartySystemInfo|name=Name of 3rd party system
|account=gerrit account
|contact=contact info for people taking responsibility for this system
|intent=of this system, why do you have it
|structure=of this system, what tools are you using
|method=what you are actually doing
|programs=touched by this system
|status=of this system, in production, testing, non-voting, voting, disabled}}

ThirdPartySystems

2014-09-02T21:11:21Z

Andrew Grimberg: /* Third Party CI Systems */ Add OpenDaylight CI subpage

== Third Party CI Systems ==

{| border="1" cellpadding="2" cellspacing="0" class="wikitable"
|+
!colspan="2"|3rd Party CI Systems
|-
!Name
!Link
|-
{{ThirdPartySystemTableEntry|A10 Networks CI}}
{{ThirdPartySystemTableEntry|Arista-CI}}
{{ThirdPartySystemTableEntry|Brocade VDX CI}}
{{ThirdPartySystemTableEntry|Brocade Vyatta CI}}
{{ThirdPartySystemTableEntry|Big Switch CI}}
{{ThirdPartySystemTableEntry|Cisco CI}}
{{ThirdPartySystemTableEntry|Citrix NetScaler CI}}
{{ThirdPartySystemTableEntry|datera-ci}}
{{ThirdPartySystemTableEntry|DB Datasets CI}}
{{ThirdPartySystemTableEntry|Dell StorageCenter CI}}
{{ThirdPartySystemTableEntry|emc-vmax-ci}}
{{ThirdPartySystemTableEntry|emc-vnx-ci}}
{{ThirdPartySystemTableEntry|emc-xio-ci}}
{{ThirdPartySystemTableEntry|emc-vipr-ci}}
{{ThirdPartySystemTableEntry|Freescale CI}}
{{ThirdPartySystemTableEntry|HDS HNAS CI}}
{{ThirdPartySystemTableEntry|HP Storage CI}}
{{ThirdPartySystemTableEntry|Huawei CI}}
{{ThirdPartySystemTableEntry|Hyper-V CI}}
{{ThirdPartySystemTableEntryDown|IBMPowerKVMCI}}
{{ThirdPartySystemTableEntry|IBM GPFS CI}}
{{ThirdPartySystemTableEntry|IBM NAS CI}}
{{ThirdPartySystemTableEntry|IBM SDN-VE CI}}
{{ThirdPartySystemTableEntry|IBM STORWIZE CI}}
{{ThirdPartySystemTableEntry|IBM XIV-DS8K CI}}
{{ThirdPartySystemTableEntry|Intel-PCI-CI}}
{{ThirdPartySystemTableEntry|Mellanox CI}}
{{ThirdPartySystemTableEntry|Metaplugin CI}}
{{ThirdPartySystemTableEntry|Midokura CI}}
{{ThirdPartySystemTableEntry|murano-ci}}
{{ThirdPartySystemTableEntry|NEC CI}}
{{ThirdPartySystemTableEntry|Nuage CI}}
{{ThirdPartySystemTableEntry|OFAgent CI}}
{{ThirdPartySystemTableEntry|One Convergence CI}}
{{ThirdPartySystemTableEntry|OpenDaylight CI}}
{{ThirdPartySystemTableEntry|ProphetStor CI}}
{{ThirdPartySystemTableEntry|Pure Storage CI}}
{{ThirdPartySystemTableEntry|Radware CI}}
{{ThirdPartySystemTableEntry|RedHat CI}}
{{ThirdPartySystemTableEntry|Scality CI}}
{{ThirdPartySystemTableEntry|SwiftStack Cluster CI}}
{{ThirdPartySystemTableEntry|Tail-f NCS CI}}
{{ThirdPartySystemTableEntry|VMware CI}}
{{ThirdPartySystemTableEntry|XenServer CI}}
{{ThirdPartySystemTableEntryDown|Example}}
|-
|}

Instructions on how to add a new system to the above table:
* Add an '''alphabetical''' entry in the above table: <code><nowiki>{{ThirdPartySystemTableEntry|Example}}</nowiki></code> where Example is the name of your system
* Save the page and click on the link to the new page
* Select the "edit the page" option and paste <code><nowiki>{{subst:ThirdPartySystemInfoSubst}}</nowiki></code> into your new page and then save it. This will expand to a table. Edit the table replacing the placeholder values with the correct values for your system
* If your system is going down or having problems, change the entry to <code><nowiki>{{ThirdPartySystemTableEntryDown|<your ci system name>}}</nowiki></code>
----
[[Category:ThirdPartySystems]]

OpenStack - User contributions [en]

Neutron Plugins and Drivers

ThirdPartySystems/OpenDaylight CI

ThirdPartySystems/OpenDaylight CI

ThirdPartySystems