External/libvirt
1
0
Fork 0
mirror of https://gitlab.com/libvirt/libvirt.git synced 2024-12-22 13:45:38 +00:00
Code Issues Packages Projects Releases Wiki Activity

schema: add password configuration for ssh disk

Browse Source 
Right now, ssh network disks are not usable. There is some basic support
in libvirt that is meant to support disk chains that have backing disks
located at ssh urls, but there is no real way for a user to configure a
ssh-based disk.  This commit allows users to configure an ssh disk with
password authentication. Implementation will follow.

<disk type='network'>
  <source  protocol='ssh' ...>
    <auth username='myusername'>
      <secret type='iscsi' usage='secretname'/>
    </auth>
</disk>

Signed-off-by: Jonathon Jongsma <jjongsma@redhat.com>
Reviewed-by: Peter Krempa <pkrempa@redhat.com>
This commit is contained in:
Jonathon Jongsma 2022-12-21 14:27:08 -06:00
parent 40935b395c
commit cf88b13090
2 changed files with 36 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
docs/formatdomain.rst
View File

@ -2784,7 +2784,7 @@ paravirtualized driver is specified via the ``disk`` element.
``network``
The ``protocol`` attribute specifies the protocol to access to the
requested image. Possible values are "nbd", "iscsi", "rbd", "sheepdog",
"gluster", "vxhs", "nfs", "http", "https", "ftp", ftps", or "tftp".
"gluster", "vxhs", "nfs", "http", "https", "ftp", ftps", "tftp", or "ssh".
For any ``protocol`` other than ``nbd`` an additional attribute ``name``
is mandatory to specify which volume/image will be used.
@ -2945,18 +2945,19 @@ paravirtualized driver is specified via the ``disk`` element.
``auth``
:since:`Since libvirt 3.9.0` , the ``auth`` element is supported for a
disk ``type`` "network" that is using a ``source`` element with the
``protocol`` attributes "rbd" or "iscsi". If present, the ``auth`` element
provides the authentication credentials needed to access the source. It
includes a mandatory attribute ``username``, which identifies the username
to use during authentication, as well as a sub-element ``secret`` with
mandatory attribute ``type``, to tie back to a `libvirt secret
object <formatsecret.html>`__ that holds the actual password or other
credentials (the domain XML intentionally does not expose the password,
only the reference to the object that does manage the password). Known
secret types are "ceph" for Ceph RBD network sources and "iscsi" for CHAP
authentication of iSCSI targets. Both will require either a ``uuid``
attribute with the UUID of the secret object or a ``usage`` attribute
matching the key that was specified in the secret object.
``protocol`` attributes "rbd", "iscsi", or "ssh". If present, the
``auth`` element provides the authentication credentials needed to access
the source. It includes a mandatory attribute ``username``, which
identifies the username to use during authentication, as well as a
sub-element ``secret`` with mandatory attribute ``type``, to tie back to
a `libvirt secret object <formatsecret.html>`__ that holds the actual
password or other credentials (the domain XML intentionally does not
expose the password, only the reference to the object that does manage
the password). Known secret types are "ceph" for Ceph RBD network sources
and "iscsi" for CHAP authentication of iSCSI targets. Both will require
either a ``uuid`` attribute with the UUID of the secret object or a
``usage`` attribute matching the key that was specified in the secret
object.
``encryption``
:since:`Since libvirt 3.9.0` , the ``encryption`` can be a sub-element of
the ``source`` element for encrypted storage sources. If present,

23
src/conf/schemas/domaincommon.rng
View File

@ -2173,6 +2173,27 @@
</element>
</define>
<define name="diskSourceNetworkProtocolSSH">
<element name="source">
<interleave>
<attribute name="protocol">
<choice>
<value>ssh</value>
</choice>
</attribute>
<attribute name="name"/>
<ref name="diskSourceCommon"/>
<ref name="diskSourceNetworkHost"/>
<optional>
<ref name="encryption"/>
</optional>
<ref name="diskSourceNetworkProtocolPropsCommon"/>
<optional>
<ref name="diskAuth"/>
</optional>
</interleave>
</element>
</define>
<define name="diskSourceNetworkProtocolSimple">
<element name="source">
<interleave>
@ -2180,7 +2201,6 @@
<choice>
<value>sheepdog</value>
<value>tftp</value>
<value>ssh</value>
</choice>
</attribute>
<attribute name="name"/>
@ -2290,6 +2310,7 @@
<ref name="diskSourceNetworkProtocolHTTPS"/>
<ref name="diskSourceNetworkProtocolFTPS"/>
<ref name="diskSourceNetworkProtocolFTP"/>
<ref name="diskSourceNetworkProtocolSSH"/>
<ref name="diskSourceNetworkProtocolSimple"/>
<ref name="diskSourceNetworkProtocolVxHS"/>
<ref name="diskSourceNetworkProtocolNFS"/>