VhbddlmZmZmZeZdZdZdZddl Z ddl Z ddl Z ddl Z ddl Z ddlmZddlmZdZd Zd Zd Zd Zd ZdZdZdZdZdZdZedk(reyy))absolute_importdivisionprint_functiona)' module: vmadm short_description: Manage SmartOS virtual machines and zones description: - Manage SmartOS virtual machines through vmadm(1M). author: Jasper Lievisse Adriaanse (@jasperla) extends_documentation_fragment: - community.general.attributes attributes: check_mode: support: full diff_mode: support: none options: archive_on_delete: required: false description: - When enabled, the zone dataset is mounted on C(/zones/archive) upon removal. type: bool autoboot: required: false description: - Whether or not a VM is booted when the system is rebooted. type: bool brand: choices: [joyent, joyent-minimal, lx, kvm, bhyve] default: joyent description: - Type of virtual machine. The V(bhyve) option was added in community.general 0.2.0. type: str boot: required: false description: - Set the boot order for KVM VMs. type: str cpu_cap: required: false description: - Sets a limit on the amount of CPU time that can be used by a VM. Use V(0) for no cap. type: int cpu_shares: required: false description: - Sets a limit on the number of fair share scheduler (FSS) CPU shares for a VM. This limit is relative to all other VMs on the system. type: int cpu_type: required: false choices: [qemu64, host] default: qemu64 description: - Control the type of virtual CPU exposed to KVM VMs. type: str customer_metadata: required: false description: - Metadata to be set and associated with this VM, this contain customer modifiable keys. type: dict delegate_dataset: required: false description: - Whether to delegate a ZFS dataset to an OS VM. type: bool disk_driver: required: false description: - Default value for a virtual disk model for KVM guests. type: str disks: required: false description: - A list of disks to add, valid properties are documented in vmadm(1M). type: list elements: dict dns_domain: required: false description: - Domain value for C(/etc/hosts). type: str docker: required: false description: - Docker images need this flag enabled along with the O(brand) set to C(lx). type: bool filesystems: required: false description: - Mount additional filesystems into an OS VM. type: list elements: dict firewall_enabled: required: false description: - Enables the firewall, allowing fwadm(1M) rules to be applied. type: bool flexible_disk_size: required: false description: - This sets an upper bound for the amount of space that a bhyve instance may use for its disks and snapshots of those disks (in MiBs). type: int version_added: 10.5.0 force: required: false description: - Force a particular action (in other words, stop or delete a VM). type: bool fs_allowed: required: false description: - Comma separated list of filesystem types this zone is allowed to mount. type: str hostname: required: false description: - Zone/VM hostname. type: str image_uuid: required: false description: - Image UUID. type: str indestructible_delegated: required: false description: - Adds an C(@indestructible) snapshot to delegated datasets. type: bool indestructible_zoneroot: required: false description: - Adds an C(@indestructible) snapshot to zoneroot. type: bool internal_metadata: required: false description: - Metadata to be set and associated with this VM, this contains operator generated keys. type: dict internal_metadata_namespace: required: false description: - List of namespaces to be set as C(internal_metadata-only); these namespaces come from O(internal_metadata) rather than O(customer_metadata). type: str kernel_version: required: false description: - Kernel version to emulate for LX VMs. type: str limit_priv: required: false description: - Set (comma separated) list of privileges the zone is allowed to use. type: str maintain_resolvers: required: false description: - Resolvers in C(/etc/resolv.conf) are updated when updating the O(resolvers) property. type: bool max_locked_memory: required: false description: - Total amount of memory (in MiBs) on the host that can be locked by this VM. type: int max_lwps: required: false description: - Maximum number of lightweight processes this VM is allowed to have running. type: int max_physical_memory: required: false description: - Maximum amount of memory (in MiBs) on the host that the VM is allowed to use. type: int max_swap: required: false description: - Maximum amount of virtual memory (in MiBs) the VM is allowed to use. type: int mdata_exec_timeout: required: false description: - Timeout in seconds (or 0 to disable) for the C(svc:/smartdc/mdata:execute) service that runs user-scripts in the zone. type: int name: required: false aliases: [alias] description: - Name of the VM. vmadm(1M) uses this as an optional name. type: str nic_driver: required: false description: - Default value for a virtual NIC model for KVM guests. type: str nics: required: false description: - A list of nics to add, valid properties are documented in vmadm(1M). type: list elements: dict nowait: required: false description: - Consider the provisioning complete when the VM first starts, rather than when the VM has rebooted. type: bool owner_uuid: required: false description: - Define the UUID of the owner of the VM. type: str version_added: 10.5.0 qemu_opts: required: false description: - Additional qemu arguments for KVM guests. This overwrites the default arguments provided by vmadm(1M) and should only be used for debugging. type: str qemu_extra_opts: required: false description: - Additional qemu cmdline arguments for KVM guests. type: str quota: required: false description: - Quota on zone filesystems (in MiBs). type: int ram: required: false description: - Amount of virtual RAM for a KVM guest (in MiBs). type: int resolvers: required: false description: - List of resolvers to be put into C(/etc/resolv.conf). type: list elements: str routes: required: false description: - Dictionary that maps destinations to gateways, these are set as static routes in the VM. type: dict spice_opts: required: false description: - Addition options for SPICE-enabled KVM VMs. type: str spice_password: required: false description: - Password required to connect to SPICE. By default no password is set. Please note this can be read from the Global Zone. type: str state: choices: [present, running, absent, deleted, stopped, created, restarted, rebooted] default: running description: - States for the VM to be in. Please note that V(present), V(stopped) and V(restarted) operate on a VM that is currently provisioned. V(present) means that the VM is created if it was absent, and that it is in a running state. V(absent) shutdowns the zone before removing it. V(stopped) means the zone is created if it does not exist already, before shutting it down. type: str tmpfs: required: false description: - Amount of memory (in MiBs) that is available in the VM for the C(/tmp) filesystem. type: int uuid: required: false description: - UUID of the VM. Can either be a full UUID or V(*) for all VMs. type: str vcpus: required: false description: - Number of virtual CPUs for a KVM guest. type: int vga: required: false description: - Specify VGA emulation used by KVM VMs. type: str virtio_txburst: required: false description: - Number of packets that can be sent in a single flush of the tx queue of virtio NICs. type: int virtio_txtimer: required: false description: - Timeout (in nanoseconds) for the TX timer of virtio NICs. type: int vnc_password: required: false description: - Password required to connect to VNC. By default no password is set. Please note this can be read from the Global Zone. type: str vnc_port: required: false description: - TCP port to listen of the VNC server. Or set V(0) for random, or V(-1) to disable. type: int zfs_data_compression: required: false description: - Specifies compression algorithm used for this VMs data dataset. This option only has effect on delegated datasets. type: str zfs_data_recsize: required: false description: - Suggested block size (power of 2) for files in the delegated dataset's filesystem. type: int zfs_filesystem_limit: required: false description: - Maximum number of filesystems the VM can have. type: int zfs_io_priority: required: false description: - IO throttle priority value relative to other VMs. type: int zfs_root_compression: required: false description: - Specifies compression algorithm used for this VMs root dataset. This option only has effect on the zoneroot dataset. type: str zfs_root_recsize: required: false description: - Suggested block size (power of 2) for files in the zoneroot dataset's filesystem. type: int zfs_snapshot_limit: required: false description: - Number of snapshots the VM can have. type: int zpool: required: false description: - ZFS pool the VM's zone dataset is created in. type: str a - name: Create SmartOS zone community.general.vmadm: brand: joyent state: present alias: fw_zone image_uuid: 95f265b8-96b2-11e6-9597-972f3af4b6d5 firewall_enabled: true indestructible_zoneroot: true nics: - nic_tag: admin ip: dhcp primary: true internal_metadata: root_pw: 'secret' quota: 1 - name: Delete a zone community.general.vmadm: alias: test_zone state: deleted - name: Stop all zones community.general.vmadm: uuid: '*' state: stopped ai uuid: description: UUID of the managed VM. returned: always type: str sample: 'b217ab0b-cf57-efd8-cd85-958d0b80be33' alias: description: Alias of the managed VM. returned: When addressing a VM by alias. type: str sample: 'dns-zone' state: description: State of the target, after execution. returned: success type: str sample: 'running' N) AnsibleModule) to_nativec|jddd|dj|g}|j|\}}}|dk7r#|jdj||| t j |}r|dj|Sy#t $rH}|jdj|t|tj Yd}~cd}~wwxYw) Nlookup-j-ozuuid={0}rz&Could not perform lookup of {0} on {1}msg exception5Invalid JSON returned by vmadm for uuid lookup of {0}r detailsr vmadmformat run_command fail_jsonjsonloads Exceptionr traceback format_excget) moduleuuidpropcmdrcstdoutstderr stdout_jsones k/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/general/plugins/modules/vmadm.py get_vm_propr's <<4tZ5F5Ft5L MC!--c2R Qw8??dKW]  _Djj( 1~!!$'' DGNNtTaLI,@,@,B  D DDs B C>CCc|jdddddj|g}|j|\}}}|dk7r"|jdj|| t j |}r|djdSy#t $rH}|jd j|t|tj Yd}~cd}~wwxYw) Nr r r rz alias={0}rzCould not retrieve UUID of {0}r rrr)raliasr r!r"r#r$r%s r& get_vm_uuidr*s <<4v{7I7I%7P QC!--c2R Qw077>&  R Djj( 1~!!&)) DGNNuUaLI,@,@,B  D DDsB C>CCcd|jddddg}|j|\}}}|dk7r|jd| tj|}|Dcgc]}|d c}Scc}w#t $r9}|jdt |tj Yd}~yd}~wwxYw) Nr r r rrzFailed to get VMs listr zCould not retrieve VM UUIDsr) rrrrrrrrr)rr r!r"r#r$vr%s r&get_all_vm_uuidsr-s <<4v 6C!--c2R Qw5H;jj( #./a& /// ;:IaL#,#7#7#9  ; ;;s*A- A(%A-(A-- B/6/B**B/c t||}t||\}}}|dk7rd}|jd|nd}tjd|}|r@|j d} t | s4|jdj| n|jd |d k7r1t| |} | s"|jd j| | tj|| fS#t$rK} |jd j|t| tjYd} ~ | fSd} ~ wwxYw) NrFzCould not create VMr TzSuccessfully created VM (.*)zInvalid UUID for VM {0}?r z.Could not retrieve UUID of newly created(?) VMrunningz!Could not set VM {0} to state {1}z5Could not remove temporary JSON payload file {0}: {1})create_payloadvmadm_create_vmrrematchgroups is_valid_uuidr set_vm_stateosunlinkrrrr) rrvm_state payload_filer!dummyr#changedr4vm_uuidretr%s r&new_vmr@sX!&$/L)&,?R Qw2fE7@ llnQ'G )  %?%F%Fw%O P   !Q  R y vw9C  %H%O%OPWYa%b c; , G  ; T[[\hjstujvw#,#7#7#9  ; ; G  ;sC44 E=>EEcD|jdd|g}|j|S)Ncreatez-f)rr)rr;r s r&r2r2s% <<4 6C   c ""c|j}t||d}|r||k(ryddgddgddgddgd}||\}}|d r|rd gng}|j|g|z|gz} |j| \} } } t j d | } | duS) NstatestopTstartFdeletereboot)stoppedr0deletedrebootedforcez-Fz^Successfully.*)paramsr'rrr3r4) rr>r:prEcmdscommand forceablerMr r<r#r4s r&r7r7 s A  1E %8# D>U#d#u%  DhGYjYTFBE << !E )WI 5C#//4UE6 HH& /E  rCctddg}|jjDcic]\}}||vr|r||}}} tj|} tjd}tj|dt|d5} | jddd|Scc}}w#t$r/}|j dt jYd}~d}~wwxYw#1swY|SxYw#t$r<}|j dt|zt jYd}~Sd}~wwxYw) NrMrEz#Could not create valid JSON payloadr wzCould not save JSON payload: %s)rNitemsrdumpsrrrrtempfilemkstempr8chmodopenwriter) rrmodule_optionskr,vmdef vmdef_jsonr%fnamefhs r&r1r1)sBw'NMM'')  Aq N "q 1 E  YZZ&  q  "1%  %  ! HHZ  ! L3  Y5AUAUAW  Y YY ! L q>1MYbYmYmYopp LqsRB$B*9C2C%C2* C"3%CC"%C/*C2/C22 D7;1D22D7cnt|||}|y|ry|jdj||y)NFTz!Failed to set VM {0} to state {1}r/)r7rr)rrr:r?s r&vm_state_transitionreJs? vtX .C { @GGhWXrCcPtjd|tjduS)Nz+^[0-9a-f]{8}-([0-9a-f]{4}-){3}[0-9a-f]{12}$)r3r4 IGNORECASE)rs r&r6r6Vs 88A4 W_c ccrCcdDcgc]}||j|fc}Dcgc]\}}|r|dk7r t|s|}}}|r1|jdjdj |yycc}wcc}}w)N)r image_uuid*zNo valid UUID(s) found for: {0}z, r/)rNr6rrjoin)rxnamepvaluefaileds r&validate_uuidsrpZs=SSqaq!12S D& fmM&,A F >EEdiiPVFWXY Ts A8A=c |jd}|dk(r|jdd}t|D]L}t||d}|s|dk(rd}|jr|rt||d|k7s9d}FL A V9D gJE && ( ( ' ' + +u F 61V9- 0hGyFvrC__main__) __future__rrrr __metaclass__ DOCUMENTATIONEXAMPLESRETURNrr8r3rYransible.module_utils.basicr+ansible.module_utils.common.text.convertersrr'r*r-r@r2r7r1rer6rprvr__name__rrCr&rsA@ V p  8 $ 5A(,*2;"!H#8B YdZ4Pf zFrC