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 |
|
Una bandera booleana que indica si se deben verificar el certificado TLS del servidor y el nombre de host. | |
kerberosbooleano |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
Si Cierto Los LUN del dominio de almacenamiento FCP se anularán antes de agregarlos. | |
fetch_nestedbooleano |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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)
Valoraciones y comentarios
Recuerda algo, que tienes la capacidad de agregar una reseña .
¡Haz clic para puntuar esta entrada!
(Votos: 0 Promedio: 0)