Nota

Este complemento es parte del colección ovirt.ovirt (versión 1.3.0).

Para instalarlo use: ansible-galaxy collection install ovirt.ovirt.

Para usarlo en un libro de jugadas, especifique: ovirt.ovirt.ovirt_storage_domain.

Nuevo en la versión 1.0.0: de ovirt.ovirt

  • Sinopsis
  • Requisitos
  • Parámetros
  • Notas
  • Ejemplos de
  • Valores devueltos

Sinopsis

  • Módulo para gestionar dominios de almacenamiento en oVirt / RHV

Requisitos

Los siguientes requisitos son necesarios en el host que ejecuta este módulo.

  • pitón> = 2,7
  • ovirt-motor-sdk-python> = 4.4.0

Parámetros

Parámetro Opciones / Valores predeterminados Comentarios
authdiccionario / requerido Diccionario con valores necesarios para crear una conexión HTTP / HTTPS a oVirt:
ca_filecuerda Un archivo PEM que contiene los certificados de CA de confianza. El certificado presentado por el servidor se verificará utilizando estos certificados de CA. ca_file El parámetro no está configurado, se usa el almacén de certificados de CA de todo el sistema. OVIRT_CAFILE Variable ambiental.
encabezadosdiccionario Diccionario de encabezados HTTP que se agregarán a cada llamada a la API.
nombre de hostcuerda Una cadena que contiene el nombre de host del servidor, generalmente algo como `server.example.com`.El valor predeterminado se establece mediante OVIRT_HOSTNAME variable de entorno. url o hostname es requerido.
insegurobooleano
    Opciones:

  • no
Una bandera booleana que indica si se deben verificar el certificado TLS del servidor y el nombre de host.
kerberosbooleano
    Opciones:

  • no
Un indicador booleano que indica si se debe utilizar la autenticación Kerberos en lugar de la autenticación básica predeterminada.
contraseñacuerda / requerido La contraseña del usuario El valor predeterminado es establecido por OVIRT_PASSWORD Variable ambiental.
simbólicocuerda Token que se utilizará en lugar de iniciar sesión con nombre de usuario / contraseña. El valor predeterminado lo establece OVIRT_TOKEN Variable ambiental.
urlcuerda Una cadena que contiene la URL de la API del servidor, generalmente algo como `https://server.example.com/ovirt-engine/api`.El valor predeterminado se establece mediante OVIRT_URL variable de entorno. url o hostname es requerido.
nombre de usuariocuerda / requerido El nombre del usuario, algo como [email protected].El valor predeterminado se establece mediante OVIRT_USERNAME Variable ambiental.
respaldobooleano
    Opciones:

  • no
Bandera booleana que indica si el dominio de almacenamiento está configurado como respaldo o no.
comentariocuerda Comentario del dominio de almacenamiento.
bloqueador_espacio_crítico_acciónentero Indica el espacio libre mínimo que debe contener el dominio de almacenamiento en porcentajes.
centro de datoscuerda Nombre del centro de datos donde se debe adjuntar el dominio de almacenamiento. Este parámetro no es idempotente, no es posible cambiar el centro de datos del dominio de almacenamiento.
descripcióncuerda Descripción del dominio de almacenamiento.
destruirbooleano
    Opciones:

  • no
Eliminación lógica del dominio de almacenamiento. Si cierto retiene los datos del dominio de almacenamiento para la importación.Este parámetro es relevante solo cuando state es ausente.
discard_after_deletebooleano
    Opciones:

  • no
Si Cierto Los bloques de dominio de almacenamiento se descartarán al eliminarlos. Habilitado de forma predeterminada. Este parámetro es relevante solo para dominios de almacenamiento basados ​​en bloques.
función_dominiocuerda
    Opciones:

  • datos
  • Yo asi
  • exportar
Función del dominio de almacenamiento: este parámetro no es idempotente, no es posible cambiar la función del dominio de almacenamiento.
alias: tipo
fcpdiccionario Diccionario con valores para el tipo de almacenamiento de canal de fibra: tenga en cuenta que estos parámetros no son idempotentes.
lun_idcuerda ID de LUN.
override_lunsbooleano
    Opciones:

  • no
Si Cierto Los LUN del dominio de almacenamiento FCP se anularán antes de agregarlos.
fetch_nestedbooleano
    Opciones:

  • no
Si Cierto el módulo obtendrá datos adicionales de la API. Obtendrá los ID de los discos VM, instantáneas, etc. El usuario puede configurar para obtener otros atributos de las entidades anidadas especificando nested_attributes.
formatobooleano
    Opciones:

  • no
Si Cierto El dominio de almacenamiento se formateará después de eliminarlo de oVirt / RHV. Este parámetro es relevante solo cuando state es ausente.
glusterfsdiccionario Diccionario con valores para el tipo de almacenamiento GlusterFS: tenga en cuenta que estos parámetros no son idempotentes.
Direccióncuerda Dirección del servidor de Gluster. Por ejemplo: myserver.mydomain.com
mount_optionscuerda Opción que se pasará al montar el almacenamiento.
senderocuerda Ruta del punto de montaje. Por ejemplo: / ruta / a / mi / datos
anfitrióncuerda Host que se utilizará para montar el almacenamiento.
identificacióncuerda Id del dominio de almacenamiento que se va a importar.
iscsidiccionario Diccionario con valores para el tipo de almacenamiento iSCSI: tenga en cuenta que estos parámetros no son idempotentes.
Direccióncuerda Dirección del servidor de almacenamiento iSCSI.
lun_idcuerda ID de LUN.
override_lunsbooleano
    Opciones:

  • no
Si Cierto Los luns del dominio de almacenamiento ISCSI se anularán antes de agregarlos.
contraseñacuerda Una contraseña CHAP para iniciar sesión en un destino.
Puertocuerda Puerto del servidor de almacenamiento iSCSI.
objetivocuerda El IQN de destino para el dispositivo de almacenamiento.
target_lun_mapcuerda Lista de diccionario que contiene destinos y LUN.
nombre de usuariocuerda Un nombre de usuario de CHAP para iniciar sesión en un destino.
localfsdiccionario Diccionario con valores para el tipo de almacenamiento localfs: tenga en cuenta que estos parámetros no son idempotentes.
senderocuerda Ruta del punto de montaje. Por ejemplo: / ruta / a / mi / datos
almacenaje_de_bloques_gestionadosdiccionario Diccionario con valores para el tipo de almacenamiento en bloque administrado Nota: disponible en ovirt 4.3
opciones_controladorlista / elementos = diccionario Las opciones que se deben pasar al crear un dominio de almacenamiento utilizando un controlador de cinder. name y value de la opción de conductor
opciones_sensibles_controladorlista / elementos = diccionario Parámetros que contienen información confidencial, que se deben pasar al crear un dominio de almacenamiento utilizando un controlador de cinder. name y value de la opción sensible al conductor
nombrecuerda Nombre del dominio de almacenamiento a administrar. (No se requiere cuando el estado es importado)
atributos_anidadoslista / elementos = cadena Especifica una lista de los atributos que deben obtenerse de la API. Este parámetro se aplica solo cuando fetch_nested es cierto.
nfsdiccionario Diccionario con valores para el tipo de almacenamiento NFS: tenga en cuenta que estos parámetros no son idempotentes.
Direccióncuerda Dirección del servidor NFS. Por ejemplo: myserver.mydomain.com
mount_optionscuerda Opción que se pasará al montar el almacenamiento.
senderocuerda Ruta del punto de montaje. Por ejemplo: / ruta / a / mi / datos
retransmisionescuerda El número de veces que se debe reintentar una solicitud antes de intentar más acciones de recuperación. Rango de 0 a 65535.
se acabó el tiempocuerda El tiempo en décimas de segundo para esperar una respuesta antes de reintentar las solicitudes NFS. Rango de 0 a 65535.
versióncuerda Versión NFS. Uno de: auto, v3, v4 o v4_1.
intervalo de encuestaentero Defecto:
3
Número de segundos que espera el módulo hasta que se envía otra solicitud de sondeo sobre el estado de la entidad.
posixfsdiccionario Diccionario con valores para el tipo de almacenamiento PosixFS: tenga en cuenta que estos parámetros no son idempotentes.
mount_optionscuerda Opción que se pasará al montar el almacenamiento.
senderocuerda Ruta del punto de montaje. Por ejemplo: / ruta / a / mi / datos
vfs_typecuerda Tipo de sistema de archivos virtual.
estadocuerda
    Opciones:

  • regalo
  • ausente
  • mantenimiento
  • Sin adjuntar
  • importado
  • update_ovf_store
Si el dominio de almacenamiento está presente / ausente / mantenimiento / no adjunto / importado / update_ovf_storeimportado es compatible desde la versión 2.4.update_ovf_store esta apoyado desde la versión 2.5, actualmente si wait es (verdadero), no esperamos la actualización.
se acabó el tiempoentero Defecto:
180
La cantidad de tiempo en segundos que el módulo debe esperar para que la instancia entre en el estado deseado.
Esperebooleano
    Opciones:

  • no
yes si el módulo debe esperar a que la entidad entre en el estado deseado.
warning_low_spaceentero Indica el porcentaje mínimo de espacio libre en un dominio de almacenamiento para presentar una advertencia.
wipe_after_deletebooleano
    Opciones:

  • no
Bandera booleana que indica si el dominio de almacenamiento debe borrar los datos después de eliminarlos.

Notas

Nota

  • Para utilizar este módulo, debe instalar oVirt Python SDK. Para asegurarse de que esté instalado con la versión correcta, puede crear la siguiente tarea: pip: nombre = ovirt-engine-sdk-python versión = 4.4.0

Ejemplos de

# Examples don't contain auth parameter for simplicity,# look at ovirt_auth module to see how to reuse authentication:# Add data NFS storage domain-ovirt.ovirt.ovirt_storage_domain:name: data_nfs
    host: myhost
    data_center: mydatacenter
    nfs:address: 10.34.63.199
      path: /path/data

# Add data NFS storage domain with id for data center-ovirt.ovirt.ovirt_storage_domain:name: data_nfs
    host: myhost
    data_center:11111nfs:address: 10.34.63.199
      path: /path/data
      mount_options: noexec,nosuid

# Add data localfs storage domain-ovirt.ovirt.ovirt_storage_domain:name: data_localfs
    host: myhost
    data_center: mydatacenter
    localfs:path: /path/to/data

# Add data iSCSI storage domain:-ovirt.ovirt.ovirt_storage_domain:name: data_iscsi
    host: myhost
    data_center: mydatacenter
    iscsi:target: iqn.2016-08-09.domain-01:nickname
      lun_id:- 1IET_000d0001
       - 1IET_000d0002
      address: 10.34.63.204
    discard_after_delete:Truebackup:Falsecritical_space_action_blocker:5warning_low_space:10# Since Ansible 2.5 you can specify multiple targets for storage domain,# Add data iSCSI storage domain with multiple targets:-ovirt.ovirt.ovirt_storage_domain:name: data_iscsi
    host: myhost
    data_center: mydatacenter
    iscsi:target_lun_map:-target: iqn.2016-08-09.domain-01:nickname
          lun_id: 1IET_000d0001
        -target: iqn.2016-08-09.domain-02:nickname
          lun_id: 1IET_000d0002
      address: 10.34.63.204
    discard_after_delete:True# Add data glusterfs storage domain-ovirt.ovirt.ovirt_storage_domain:name: glusterfs_1
    host: myhost
    data_center: mydatacenter
    glusterfs:address: 10.10.10.10
      path: /path/data

# Create export NFS storage domain:-ovirt.ovirt.ovirt_storage_domain:name: myexportdomain
    domain_function: export
    host: myhost
    data_center: mydatacenter
    nfs:address: 10.34.63.199
      path: /path/export
    wipe_after_delete:Falsebackup:Truecritical_space_action_blocker:2warning_low_space:5# Import export NFS storage domain:-ovirt.ovirt.ovirt_storage_domain:state: imported
    domain_function: export
    host: myhost
    data_center: mydatacenter
    nfs:address: 10.34.63.199
      path: /path/export

# Import FCP storage domain:-ovirt.ovirt.ovirt_storage_domain:state: imported
    name: data_fcp
    host: myhost
    data_center: mydatacenter
    fcp:# Update OVF_STORE:-ovirt.ovirt.ovirt_storage_domain:state: update_ovf_store
    name: domain

# Create ISO NFS storage domain-ovirt.ovirt.ovirt_storage_domain:name: myiso
    domain_function: iso
    host: myhost
    data_center: mydatacenter
    nfs:address: 10.34.63.199
      path: /path/iso

# Create managed storage domain# Available from ovirt 4.3 and ansible 2.9-ovirt.ovirt.ovirt_storage_domain:name: my_managed_domain
    host: myhost
    data_center: mydatacenter
    managed_block_storage:driver_options:-name: rbd_pool
          value: pool1
        -name: rbd_user
          value: admin
        -name: volume_driver
          value: cinder.volume.drivers.rbd.RBDDriver
        -name: rbd_keyring_conf
          value: /etc/ceph/keyring
      driver_sensitive_options:-name: secret_password
          value: password

# Remove storage domain-ovirt.ovirt.ovirt_storage_domain:state: absent
    name: mystorage_domain
    format:true

Valores devueltos

Los valores de retorno comunes están documentados aquí, los siguientes son los campos exclusivos de este módulo:

Llave Devuelto Descripción
identificacióncuerda En caso de éxito si se encuentra el dominio de almacenamiento. ID del dominio de almacenamiento que se gestiona
Muestra:7de90f31-222c-436c-a1ca-7e655bd5b60c
dominio_almacenamientodiccionario En caso de éxito si se encuentra el dominio de almacenamiento. Diccionario de todos los atributos del dominio de almacenamiento. Los atributos del dominio de almacenamiento se pueden encontrar en su instancia de oVirt / RHV en la siguiente URL: http://ovirt.github.io/ovirt-engine-api-model/master/#types/storage_domain.

Autores

  • Ondra Machacek (@machacekondra)
  • Martín Necas (@mnecas)