diff options
| author | Zuul <zuul@review.opendev.org> | 2022-09-20 19:32:30 +0000 |
|---|---|---|
| committer | Gerrit Code Review <review@openstack.org> | 2022-09-20 19:32:30 +0000 |
| commit | 2daafdbb3ff0dbf02872958021bb35837c712da5 (patch) | |
| tree | 01af13ef612892f4f4b4bf7d4d4af6c2fd4e0a37 | |
| parent | 501016fce3a5efce437376dac01ee3ae68f9f552 (diff) | |
| parent | e340fc39b925d864a5a03772e9d63edf30f6b911 (diff) | |
| download | ironic-2daafdbb3ff0dbf02872958021bb35837c712da5.tar.gz | |
Merge "Document existence of non-production "fake" driver"
| -rw-r--r-- | doc/source/admin/drivers.rst | 1 | ||||
| -rw-r--r-- | doc/source/admin/drivers/fake.rst | 36 |
2 files changed, 37 insertions, 0 deletions
diff --git a/doc/source/admin/drivers.rst b/doc/source/admin/drivers.rst index c3d8eb377..f35cb2dfa 100644 --- a/doc/source/admin/drivers.rst +++ b/doc/source/admin/drivers.rst @@ -26,6 +26,7 @@ Hardware Types drivers/redfish drivers/snmp drivers/xclarity + drivers/fake Changing Hardware Types and Interfaces -------------------------------------- diff --git a/doc/source/admin/drivers/fake.rst b/doc/source/admin/drivers/fake.rst new file mode 100644 index 000000000..ea7d7ef4c --- /dev/null +++ b/doc/source/admin/drivers/fake.rst @@ -0,0 +1,36 @@ +=========== +Fake driver +=========== + +Overview +======== + +The ``fake-hardware`` hardware type is what it claims to be: fake. Use of this +type or the ``fake`` interfaces should be temporary or limited to +non-production environments, as the ``fake`` interfaces do not perform any of +the actions typically expected. + +The ``fake`` interfaces can be configured to be combined with any of the +"real" hardware interfaces, allowing you to effectively disable one or more +hardware interfaces for testing by simply setting that interface to +``fake``. + +Use cases +========= + +Development +----------- +Developers can use ``fake-hardware`` hardware-type to mock out nodes for +testing without those nodes needing to exist with physical or virtual hardware. + +Adoption +-------- +Some OpenStack deployers have used ``fake`` interfaces in Ironic to allow an +adoption-style workflow with Nova. By setting a node's hardware interfaces to +``fake``, it's possible to deploy to that node with Nova without causing any +actual changes to the hardware or an OS already deployed on it. + +This is generally an unsupported use case, but it is possible. For more +information, see the relevant `post from CERN TechBlog`_. + +.. _`post from CERN TechBlog`: https://techblog.web.cern.ch/techblog/post/ironic-nova-adoption/ |