Jump to: navigation, search

Difference between revisions of "Ironic/Drivers"

(created)
 
m
 
(58 intermediate revisions by 20 users not shown)
Line 1: Line 1:
 
== Drivers ==
 
== Drivers ==
  
Ironic supports pluggable back-end drivers for different types of hardware to enable features specific to unique hardware platforms and leverage divergent capabilities via a common API . This API is divided into three sections: core, common, and vendor. While authors of vendor drivers may break new ground in the designated "vendor_passthru" section of the API, they are strongly encouraged to converge on a common API across vendors. More details may be found under the [http://docs.openstack.org/developer/ironic/dev/architecture.html#drivers system architecture] description.
+
Ironic supports pluggable back-end drivers for different types of hardware to enable features specific to unique hardware platforms and leverage divergent capabilities via a common API. Drivers are composed from ''hardware types'' and "hardware interfaces".
 +
* [https://docs.openstack.org/ironic/latest/install/enabling-drivers.html Installation: enabling hardware types and interfaces]
 +
* [https://docs.openstack.org/ironic/latest/admin/drivers.html Available hardware types and interfaces]
 +
* [https://docs.openstack.org/ironic/latest/contributor/drivers.html#writing-a-hardware-type Writing a new hardware type]
  
Hardware drivers must undergo CI testing so as to ensure their continued functionality. Some drivers will be tested upstream, while many will require third-party CI testing due to the unique nature of their hardware (and the unmanageable complexity were a single team required to maintain a test infrastructure encompassing hardware from many diverse vendors). Guidelines on that testing can be found on the [[Ironic/Testing]] wiki page.
 
  
Out-of-tree drivers are supported by Ironic and may be loaded via python entrypionts.
+
Every supported driver is covered either by the standard CI or by a [https://wiki.openstack.org/wiki/ThirdPartySystems Third Party CI]. The [https://github.com/openstack/ironic-staging-drivers ironic-staging-drivers project] hosts a few drivers that are '''unsupported by the community'''.
 
 
The table below describes the CI test coverage of the drivers present in Ironic's tree upstream.
 
 
 
{| class="wikitable"
 
|-
 
! Driver Name and Module !! Primary Contact !! Testing Status
 
|-
 
| pxe_ssh || PTL / devananda || upstream CI tested
 
|-
 
| pxe_ipmitool || PTL / devananda || No CI testing, but TripleO is using this.
 
|-
 
| pxe_ipminative || linggao? ||
 
|-
 
| pxe_seamicro || Pete Yamazaki? ||
 
|}
 

Latest revision as of 17:10, 26 March 2018

Drivers

Ironic supports pluggable back-end drivers for different types of hardware to enable features specific to unique hardware platforms and leverage divergent capabilities via a common API. Drivers are composed from hardware types and "hardware interfaces".


Every supported driver is covered either by the standard CI or by a Third Party CI. The ironic-staging-drivers project hosts a few drivers that are unsupported by the community.