VhQ z d dl mZmZmZ eZdZdZ d dlZdZ d dl m Z dZ
d dlmZ d d lmZ d
Zd Zd Zg Zg d Zg d
Zej1 e ej1 e dddZdddZdddZ G d de Z G d de Z G d de Z d Z!d Z"e#dk( r e" yy# e
$ r dZ Y w xY w# e
$ r dZ
Y w xY w) )absolute_importdivisionprint_functionah
---
module: virt_net
author: "Maciej Delmanowski (@drybjed)"
short_description: Manage libvirt network configuration
description:
- Manage I(libvirt) networks.
options:
name:
aliases: ['network']
description:
- Name of the network being managed. Note that network must be previously
defined with xml.
type: str
state:
choices: [ "active", "inactive", "present", "absent" ]
description:
- Specify which state you want a network to be in.
If 'active', network will be started.
If 'present', ensure that network is present but do not change its
state; if it is missing, you need to specify xml argument.
If 'inactive', network will be stopped.
If 'undefined' or 'absent', network will be removed from I(libvirt) configuration.
type: str
command:
choices: [ "define", "create", "start", "stop", "destroy",
"undefine", "get_xml", "list_nets", "facts",
"info", "status", "modify"]
description:
- In addition to state management, various non-idempotent commands are available.
See examples.
Modify was added in Ansible version 2.1.
type: str
autostart:
type: bool
description:
- Specify if a given network should be started automatically on system boot.
extends_documentation_fragment:
- community.libvirt.virt.options_uri
- community.libvirt.virt.options_xml
- community.libvirt.requirements
requirements:
- "python-lxml"
a
- name: Define a new network
community.libvirt.virt_net:
command: define
name: br_nat
xml: '{{ lookup("template", "network/bridge.xml.j2") }}'
- name: Start a network
community.libvirt.virt_net:
command: create
name: br_nat
- name: List available networks
community.libvirt.virt_net:
command: list_nets
- name: Get XML data of a specified network
community.libvirt.virt_net:
command: get_xml
name: br_nat
- name: Stop a network
community.libvirt.virt_net:
command: destroy
name: br_nat
- name: Undefine a network
community.libvirt.virt_net:
command: undefine
name: br_nat
# Gather facts about networks
# Facts will be available as 'ansible_libvirt_networks'
- name: Gather facts about networks
community.libvirt.virt_net:
command: facts
- name: Gather information about network managed by 'libvirt' remotely using uri
community.libvirt.virt_net:
command: info
uri: '{{ item }}'
with_items: '{{ libvirt_uris }}'
register: networks
- name: Ensure that a network is active (needs to be defined and built first)
community.libvirt.virt_net:
state: active
name: br_nat
- name: Ensure that a network is inactive
community.libvirt.virt_net:
state: inactive
name: br_nat
- name: Ensure that a given network will be started at boot
community.libvirt.virt_net:
autostart: true
name: br_nat
- name: Disable autostart for a given network
community.libvirt.virt_net:
autostart: false
name: br_nat
- name: Add a new host in the dhcp pool
community.libvirt.virt_net:
name: br_nat
command: modify
xml: ""
NTF)etree)
AnsibleModule) to_native ) createstatusstartstopundefinedestroyget_xmldefinemodify) list_netsfactsinfoinactiveactive)r r noyesc e Zd Zy)
EntryNotFoundN)__name__
__module__ __qualname__ n/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/libvirt/plugins/modules/virt_net.pyr r s r! r c e Zd Zd Zd Zd Zd Zd Zd Zd Z d Z
d Z d
Z d Z
d Zd
Zd Zd Zd Zd Zd Zd Zd Zy)LibvirtConnectionc d || _ t j | }|s t d || _ y )Nz hypervisor connection failure)modulelibvirtopen Exceptionconn)selfurir& r* s r" __init__zLibvirtConnection.__init__ s- ||C ;< < r! c |dk( r^| j j | j j z }|D cg c] }| j j | c}S | j j | S c c}w # t j
$ r5}|j
t j k( rt d|z d }~ww xY w)Nznetwork %s not found) r* listNetworkslistDefinedNetworksnetworkLookupByNamer' libvirtErrorget_error_codeVIR_ERR_NO_NETWORKr )r+ entryidnamesnes r"
find_entryz LibvirtConnection.find_entry s b=II**,tyy/L/L/NNE>CDDII11!4D D 99009 9 E ## !W%?%??#$:W$DEE s "B %B C
0CC
c @ | j j s | j | j S | j | j }|s | j j
d S y # t
$ r | j j
d cY S w xY wNTchanged)r&
check_moder: r isActiver) exit_jsonr+ r6 states r" r zLibvirtConnection.create s {{%%??7+224 4
; 099; {{,,T,::
;{{,,T,::
;s A5 5%B B c | j | }t j | }t j |j d }|j dk( r |j d }|j
d }d }|D ] } | j d |k( s| } n || j j s|j rQ|j t j t j d|t j t j z }
nB|j t j t j d|t j }
nd}
|
dk( ry|j d |j d k( r$|j d |j d k( ry | j j s|j rQ|j t j t j d|t j t j z }
nB|j t j t j d|t j }
nd}
|
dk( ry| j j# d
t% | z y ) Nr hostmacz/network/ip/dhcp/hostr/ TnameipFz%updating this is not supported yet %smsg)r: r
fromstringXMLDesctaggetxpathr& r? r@ updater' #VIR_NETWORK_UPDATE_COMMAND_ADD_LAST VIR_NETWORK_SECTION_IP_DHCP_HOST VIR_NETWORK_UPDATE_AFFECT_LIVE VIR_NETWORK_UPDATE_AFFECT_CONFIG!VIR_NETWORK_UPDATE_COMMAND_MODIFY fail_jsonr ) r+ r6 xmlnetworknew_dataold_datamac_addrhostsrE hress r" r zLibvirtConnection.modify s* //'*##C(##GOOA$67 <<6 ! ||E*H NN#:;ED
55<8+ D
|{{-- '') %nnW-X-X-4-U-U-/g6\6\_f `H `H 7H I &nnW-X-X-4-U-U-/g6^6^ `
C!8 88F#x||F';;RZR^R^_cRd@d ;;11"++-")..1Z1Z181Y1Y13S':`:`cj dL dL ;L#MC #*..1Z1Z181Y1Y13S':b:b#dC
ax # "IIVYN"Z [r! c | j j s | j | j S | j | j r | j j d S y r< )r& r? r: r r@ rA r+ r6 s r" r zLibvirtConnection.destroy sY {{%%??7+335 5w'002{{,,T,:: 3r! c d } | j | }d}|r | j | j S | j j r | j j | S y # t $ r d}Y aw xY w)NTFr= )r: r r r& r? rA )r+ r6 entryfounds r" r zLibvirtConnection.undefine s| OOG,EE ??7+446 6 ;; ! !;;(((7 7 "
E s A+ + A98A9c N |j }t j |d S Nunknown)r@ ENTRY_STATE_ACTIVE_MAPrN )r+ rb rC s r" get_status2z LibvirtConnection.get_status2 s! %))%;;r! c N | j j s5| j | j }t j |d S | j | j }t j |d S # t $ r t j dd cY S w xY w)Nrf r )r& r? r: r@ rg rN r) rB s r"
get_statusz LibvirtConnection.get_status" s {{%%OOG,557E)--eY? ?
I 099;-11%CC
I-11*iHH
Is
4B B$#B$c @ | j | j S N)r:
UUIDStringr` s r" get_uuidzLibvirtConnection.get_uuid- w'2244r! c B | j | j d S )Nr )r: rL r` s r" r zLibvirtConnection.get_xml0 s w'//22r! c t j | j | j d } |j d d j d }|S # t $ r t d w xY w)Nr z/network/forwardmodezForward mode not specifiedr rK r: rL rO rN r)
ValueErrorr+ r6 rW results r" get_forwardz LibvirtConnection.get_forward3 sn tw 7 ? ? BC ;YY 121599&AF
; 9: : ; #A A/c t j | j | j d } |j d d j d }|S # t $ r t d w xY w)Nr z/network/domainrG zDomain not specifiedrs ru s r"
get_domainz LibvirtConnection.get_domain; sn tw 7 ? ? BC 5YY 01!488@F
5 34 4 5rx c t j | j | j d } |j d d j d }|S # t $ r t d w xY w)Nr z /network/macaddresszMAC address not specifiedrs ru s r" get_macaddressz LibvirtConnection.get_macaddressC sm tw 7 ? ? BC :YY~.q155i@F
: 89 9 :rx c l | j | j }t j |d S re )r: autostartENTRY_STATE_AUTOSTART_MAPrN rB s r"
get_autostartz LibvirtConnection.get_autostartK s, (224(,,UI>>r! c | j j s | j | j S | j | j S # t $ r | j j d cY S w xY wr< )r& r? r: r r) rA r` s r" get_autostart2z LibvirtConnection.get_autostart2O sk {{%%??7+557 7
;w/99;;
;{{,,T,::
;s A %A>=A>c Z | j j s | j | j | S | j | j }t | |k7 r | j j
d S y # t
$ r | j j
d cY S w xY wr< )r& r? r: setAutostartr r) rA bool)r+ r6 valrC s r"
set_autostartz LibvirtConnection.set_autostartX s {{%%??7+88= =
; 0::< E{c!{{,,T,:: "
;{{,,T,::
;s B %B*)B*c @ | j | j S rl )r:
bridgeNamer` s r"
get_bridgez LibvirtConnection.get_bridgec ro r! c l | j | j }t j |d S re )r: isPersistentENTRY_STATE_PERSISTENT_MAPrN rB s r" get_persistentz LibvirtConnection.get_persistentf s, (557)--eY??r! c D | j | }|j S rl )r:
DHCPLeases)r+ r6 rX s r" get_dhcp_leasesz!LibvirtConnection.get_dhcp_leasesj s //'*!!##r! c | j j s| j j | S | j | y # t
$ r | j j
d cY S w xY wr< )r& r? r* networkDefineXMLr: r) rA r+ r6 rW s r" define_from_xmlz!LibvirtConnection.define_from_xmln s\ {{%%99--c2 2
;(
;{{,,T,::
;s A %A-,A-N)r r r r- r: r r r r rh rj rn r rw rz r} r r r r r r r r r! r" r$ r$ sj
;2\h; 8 < I53?; ;5@$;r! r$ c | e Zd Zd Zd ZddZd Zd Zd Zd Z d Z
d
Z d Z d Z
d
Zd Zd Zd Zd Zd ZddZy) VirtNetworkc j || _ || _ t | j | j | _ y rl )r& r, r$ r* )r+ r, r& s r" r- zVirtNetwork.__init__z s& %dhh < r! c 8 | j j | S rl )r* r: r` s r" get_netzVirtNetwork.get_net yy##G,,r! Nc
g }| j j d D ]b }|r?|| j j | k( s$|j |j D|j |j d |S )Nr/ )r* r: rh appendrG )r+ rC resultsrb s r" r zVirtNetwork.list_nets sj YY))"- -EDII 1 1% 88NN5::<0uzz|, - r! c g }| j D ]3 }| j j | }|j |d| 5 |S )N )r r* rj r )r+ r rb state_blurbs r" rC zVirtNetwork.state sI ^^% ;E ))..u5K NNe[9 : ; r! c : | j j |d S )NTr* r r` s r" r zVirtNetwork.autostart s yy&&w55r! c 8 | j j | S rl )r* r r` s r" r zVirtNetwork.get_autostart s yy''00r! c : | j j || S rl r rB s r" r zVirtNetwork.set_autostart s yy&&w66r! c | j j | dk( ry | j j | S # t j $ r,}|j t j k( rY d }~y d }~ww xY wNr )r* rj r r' r3 r4 VIR_ERR_NETWORK_EXIST)r+ r6 r9 s r" r zVirtNetwork.create si 99 (H 4 99##G, ,## !W%B%BB s < A;!A65A66A;c : | j j || S rl )r* r r s r" r zVirtNetwork.modify s yy --r! c $ | j | S rl )r r` s r" r
zVirtNetwork.start s {{7##r! c v | j j | dk( r| j j | S y r )r* rj r r` s r" r zVirtNetwork.stop s3 99 (H 499$$W- - 5r! c $ | j | S rl )r r` s r" r zVirtNetwork.destroy s yy!!r! c 8 | j j | S rl )r* r r` s r" r zVirtNetwork.undefine s yy!!'**r! c 8 | j j | S rl )r* rj r` s r" r zVirtNetwork.status r r! c 8 | j j | S rl )r* r r` s r" r zVirtNetwork.get_xml s yy ))r! c : | j j || S rl )r* r r s r" r zVirtNetwork.define s yy((#66r! c & | j d S )Nr )
facts_mode)r )r+ s r" r zVirtNetwork.info s zzVz,,r! c t }|r|g}n| j }|D ]= }t ||< | j j | || d< | j j | || d< | j j | || d< | j j
| || d< | j j | || d< | j j | || d< | j j | || d< | j j | || d< | j j | || d < @ t }|d
k( rt |d < ||d d < |S |d
k( r||d< |S # t $ r Y w xY w# t $ r Y w xY w# t $ r Y w xY w# t $ r Y w xY w)Nr
persistentrC bridgeuuid dhcp_leases forward_modedomain
macaddressr
ansible_factsansible_libvirt_networksr networks)dictr r* r r rj r rn r AttributeErrorrw rt rz r} )r+ rG r r entriesrb r s r" r zVirtNetwork.facts s & fGnn&G E !VGEN*.))*A*A%*HGEN; '+/99+C+CE+JGEN< (&*ii&:&:5&AGEN7 #'+yy';';E'BGEN8 $%)YY%7%7%>GEN6 "
04 0I0I%0P}-
151F1Fu1M~.
+/99+?+?+Fx(
/3yy/G/G/N|,1 8 %)VE/ "AHE/ "#= > 6
! 'E* 1 "
sH !F|j | dk7 r|j | d|d < |j | |d< t |fS | j d
t |fS |r|t v r|s| j d|z
|dv rM|s| j |dz
|j | |d k( r|j! || }
|
|d }t |fS t# || | }t |t
s||i}t |fS t% || rF|d k( r|r|j' | }n t# || }t |t
s||i}t |fS | j d |z
||s| j d
d |d < |r3|j) | sd|d < |j+ |d |d< t |fS |j) | rd|d < |j+ |d |d< t |fS | j d
y # t $ r; |s| j d|z dz
|j || d|d}Y t |fS w xY w# t $ r! |j || d|d}Y t |fS w xY w)!NrC rG commandr, rW r r )rC z&state change requires a specified namerI Fr> )r r TrJ )presentz network 'z$' not present, but xml not specified)r> created)r r ) undefinedabsentzunexpected statez %s requires 1 argument: name)r r z requires xml argumentr )r> modifiedr zCommand %s not recognizedz3expected state or command parameter to be specified)paramsrN r r
isinstancer VIRT_SUCCESSrV r r
r r r r r ENTRY_COMMANDSr getattrhasattrr r r ) r& rC rG r r, rW r vr^ r mods r" corer s{ MM gt ,E == VT *Dmm 40G
--
E4
(C
--
E4
(C
!!+t4IC A
C K'kkk&#t$C.CS !I J I J xx~)!%I WWT]E
2 S 1 k
!
9 $, S ! l
"kkmGw88D>Z/%)C N!"4 CJ S -
-kkmGw88D>Z/IIdO!%I ZZ -E
S
!3 4S n $ %Cg%M N..$$3K)K$LAIIdO
(* hhtS 1*-4 @#S((%'!W%d+C c4( n $ $
Q
'!dggdm)ga)+ c4( n $ $
!d)d$es#"&48" S +
9@ % =HHT3'&*tr s1 A @
+
ZE N H G 4 0 /
N # M " I D; D;Nr& rjgPT,#^ zF K H Gs" B# B0 #B-,B-0B:9B: