VhddlmZmZmZeZdZdZddlZddl Z ddl m Z ddl m Z ddlmZmZmZddlmZd Zd ZGd d eZd ZdZedk(reyy))absolute_importdivisionprint_functionaF, module: proxmox short_description: Management of instances in Proxmox VE cluster description: - Allows you to create/delete/stop instances in Proxmox VE cluster. - The module automatically detects containerization type (lxc for PVE 4, openvz for older). attributes: check_mode: support: none diff_mode: support: none options: password: description: - The instance root password. type: str hostname: description: - The instance hostname. - Required only for O(state=present). - Must be unique if vmid is not passed. type: str ostemplate: description: - The template for VM creating. - Required only for O(state=present). type: str disk: description: - This option was previously described as "hard disk size in GB for instance" however several formats describing a lxc mount are permitted. - Older versions of Proxmox will accept a numeric value for size using the O(storage) parameter to automatically choose which storage to allocate from, however new versions enforce the C(:) syntax. - Additional options are available by using some combination of the following key-value pairs as a comma-delimited list C([volume=] [,acl=<1|0>] [,mountoptions=] [,replicate=<1|0>] [,ro=<1|0>] [,shared=<1|0>] [,size=]). - See U(https://pve.proxmox.com/wiki/Linux_Container) for a full description. - This option is mutually exclusive with O(disk_volume). type: str disk_volume: description: - Specify a hash/dictionary of the C(rootfs) disk. - See U(https://pve.proxmox.com/wiki/Linux_Container#pct_mount_points) for a full description. - This option is mutually exclusive with O(storage) and O(disk). type: dict suboptions: storage: description: - O(disk_volume.storage) is the storage identifier of the storage to use for the C(rootfs). - Mutually exclusive with O(disk_volume.host_path). type: str volume: description: - O(disk_volume.volume) is the name of an existing volume. - If not defined, the module will check if one exists. If not, a new volume will be created. - If defined, the volume must exist under that name. - Required only if O(disk_volume.storage) is defined, and mutually exclusive with O(disk_volume.host_path). type: str size: description: - O(disk_volume.size) is the size of the storage to use. - The size is given in GiB. - Required only if O(disk_volume.storage) is defined, and mutually exclusive with O(disk_volume.host_path). type: int host_path: description: - O(disk_volume.host_path) defines a bind or device path on the PVE host to use for the C(rootfs). - Mutually exclusive with O(disk_volume.storage), O(disk_volume.volume), and O(disk_volume.size). type: path options: description: - O(disk_volume.options) is a dict of extra options. - The value of any given option must be a string, for example V("1"). type: dict cores: description: - Specify number of cores per socket. type: int cpus: description: - Number of allocated cpus for instance. type: int memory: description: - Memory size in MB for instance. type: int swap: description: - Swap memory size in MB for instance. type: int netif: description: - Specifies network interfaces for the container. As a hash/dictionary defining interfaces. type: dict features: description: - Specifies a list of features to be enabled. For valid options, see U(https://pve.proxmox.com/wiki/Linux_Container#pct_options). - Some features require the use of a privileged container. type: list elements: str startup: description: - Specifies the startup order of the container. - Use C(order=#) where C(#) is a non-negative number to define the general startup order. Shutdown in done with reverse ordering. - Use C(up=#) where C(#) is in seconds, to specify a delay to wait before the next VM is started. - Use C(down=#) where C(#) is in seconds, to specify a delay to wait before the next VM is stopped. type: list elements: str mounts: description: - Specifies additional mounts (separate disks) for the container. As a hash/dictionary defining mount points as strings. - This Option is mutually exclusive with O(mount_volumes). type: dict mount_volumes: description: - Specify additional mounts (separate disks) for the container. As a hash/dictionary defining mount points. - See U(https://pve.proxmox.com/wiki/Linux_Container#pct_mount_points) for a full description. - This Option is mutually exclusive with O(mounts). type: list elements: dict suboptions: id: description: - O(mount_volumes[].id) is the identifier of the mount point written as C(mp[n]). type: str required: true storage: description: - O(mount_volumes[].storage) is the storage identifier of the storage to use. - Mutually exclusive with O(mount_volumes[].host_path). type: str volume: description: - O(mount_volumes[].volume) is the name of an existing volume. - If not defined, the module will check if one exists. If not, a new volume will be created. - If defined, the volume must exist under that name. - Required only if O(mount_volumes[].storage) is defined and mutually exclusive with O(mount_volumes[].host_path). type: str size: description: - O(mount_volumes[].size) is the size of the storage to use. - The size is given in GiB. - Required only if O(mount_volumes[].storage) is defined and mutually exclusive with O(mount_volumes[].host_path). type: int host_path: description: - O(mount_volumes[].host_path) defines a bind or device path on the PVE host to use for the C(rootfs). - Mutually exclusive with O(mount_volumes[].storage), O(mount_volumes[].volume), and O(mount_volumes[].size). type: path mountpoint: description: - O(mount_volumes[].mountpoint) is the mount point of the volume. type: path required: true options: description: - O(mount_volumes[].options) is a dict of extra options. - The value of any given option must be a string, for example V("1"). type: dict ip_address: description: - Specifies the address the container will be assigned. type: str onboot: description: - Specifies whether a VM will be started during system bootup. type: bool storage: description: - Target storage. - This option is mutually exclusive with O(disk_volume) and O(mount_volumes). type: str default: 'local' ostype: description: - Specifies the C(ostype) of the LXC container. - If set to V(auto), no C(ostype) will be provided on instance creation. choices: ['auto', 'debian', 'devuan', 'ubuntu', 'centos', 'fedora', 'opensuse', 'archlinux', 'alpine', 'gentoo', 'nixos', 'unmanaged'] type: str default: 'auto' cpuunits: description: - CPU weight for a VM. type: int nameserver: description: - Sets DNS server IP address for a container. type: str searchdomain: description: - Sets DNS search domain for a container. type: str tags: description: - List of tags to apply to the container. - Tags must start with V([a-z0-9_]) followed by zero or more of the following characters V([a-z0-9_-+.]). - Tags are only available in Proxmox 7+. type: list elements: str timeout: description: - Timeout for operations. type: int default: 30 update: description: - If V(true), the container will be updated with new values. This only happens if O(state=present), O(force=false), and O(clone) is not specified. - If V(false), it will not be updated. - The default changed from V(false) to V(true) in community.proxmox 1.0.0. type: bool default: true force: description: - Forcing operations. - Can be used only with states V(present), V(stopped), V(restarted). - With O(state=present) force option allow to overwrite existing container. - With states V(stopped), V(restarted) allow to force stop instance. - When specifying O(force), O(update) must not be specified. type: bool default: false purge: description: - Remove container from all related configurations. - For example backup jobs, replication jobs, or HA. - Related ACLs and Firewall entries will always be removed. - Used with O(state=absent). type: bool default: false state: description: - Indicate desired state of the instance. type: str choices: ['present', 'started', 'absent', 'stopped', 'restarted', 'template'] default: present pubkey: description: - Public key to add to /root/.ssh/authorized_keys. This was added on Proxmox 4.2, it is ignored for earlier versions. type: str unprivileged: description: - Indicate if the container should be unprivileged. type: bool default: true description: description: - Specify the description for the container. Only used on the configuration web interface. - This is saved as a comment inside the configuration file. type: str hookscript: description: - Script that will be executed during various steps in the containers lifetime. type: str timezone: description: - Timezone used by the container, accepts values like V(Europe/Paris). - The special value V(host) configures the same timezone used by Proxmox host. type: str clone: description: - ID of the container to be cloned. - O(description), O(hostname), and O(pool) will be copied from the cloned container if not specified. - The type of clone created is defined by the O(clone_type) parameter. - This operator is only supported for Proxmox clusters that use LXC containerization (PVE version >= 4). type: int clone_type: description: - Type of the clone created. - V(full) creates a full clone, and O(storage) must be specified. - V(linked) creates a linked clone, and the cloned container must be a template container. - V(opportunistic) creates a linked clone if the cloned container is a template container, and a full clone if not. O(storage) may be specified, if not it will fall back to the default. type: str choices: ['full', 'linked', 'opportunistic'] default: opportunistic author: Sergei Antipov (@UnderGreen) seealso: - module: community.proxmox.proxmox_vm_info extends_documentation_fragment: - community.proxmox.proxmox.actiongroup_proxmox - community.proxmox.proxmox.documentation - community.proxmox.proxmox.selection - community.proxmox.attributes a - name: Create new container with minimal options community.proxmox.proxmox: vmid: 100 node: uk-mc02 api_user: root@pam api_password: 1q2w3e api_host: node1 password: 123456 hostname: example.org ostemplate: 'local:vztmpl/ubuntu-14.04-x86_64.tar.gz' - name: Create new container with minimal options specifying disk storage location and size community.proxmox.proxmox: vmid: 100 node: uk-mc02 api_user: root@pam api_password: 1q2w3e api_host: node1 password: 123456 hostname: example.org ostemplate: 'local:vztmpl/ubuntu-14.04-x86_64.tar.gz' disk: 'local-lvm:20' - name: Create new container with minimal options specifying disk storage location and size via disk_volume community.proxmox.proxmox: vmid: 100 node: uk-mc02 api_user: root@pam api_password: 1q2w3e api_host: node1 password: 123456 hostname: example.org ostemplate: 'local:vztmpl/ubuntu-14.04-x86_64.tar.gz' disk_volume: storage: local size: 20 - name: Create new container with hookscript and description community.proxmox.proxmox: vmid: 100 node: uk-mc02 api_user: root@pam api_password: 1q2w3e api_host: node1 password: 123456 hostname: example.org ostemplate: 'local:vztmpl/ubuntu-14.04-x86_64.tar.gz' hookscript: 'local:snippets/vm_hook.sh' description: created with ansible - name: Create new container automatically selecting the next available vmid. community.proxmox.proxmox: node: 'uk-mc02' api_user: 'root@pam' api_password: '1q2w3e' api_host: 'node1' password: '123456' hostname: 'example.org' ostemplate: 'local:vztmpl/ubuntu-14.04-x86_64.tar.gz' - name: Create new container with minimal options with force(it will rewrite existing container) community.proxmox.proxmox: vmid: 100 node: uk-mc02 api_user: root@pam api_password: 1q2w3e api_host: node1 password: 123456 hostname: example.org ostemplate: 'local:vztmpl/ubuntu-14.04-x86_64.tar.gz' force: true - name: Create new container with minimal options use environment PROXMOX_PASSWORD variable(you should export it before) community.proxmox.proxmox: vmid: 100 node: uk-mc02 api_user: root@pam api_host: node1 password: 123456 hostname: example.org ostemplate: 'local:vztmpl/ubuntu-14.04-x86_64.tar.gz' - name: Create new container with minimal options defining network interface with dhcp community.proxmox.proxmox: vmid: 100 node: uk-mc02 api_user: root@pam api_password: 1q2w3e api_host: node1 password: 123456 hostname: example.org ostemplate: 'local:vztmpl/ubuntu-14.04-x86_64.tar.gz' netif: net0: "name=eth0,ip=dhcp,ip6=dhcp,bridge=vmbr0" - name: Create new container with minimal options defining network interface with static ip community.proxmox.proxmox: vmid: 100 node: uk-mc02 api_user: root@pam api_password: 1q2w3e api_host: node1 password: 123456 hostname: example.org ostemplate: 'local:vztmpl/ubuntu-14.04-x86_64.tar.gz' netif: net0: "name=eth0,gw=192.168.0.1,ip=192.168.0.2/24,bridge=vmbr0" - name: Create new container with more options defining network interface with static ip4 and ip6 with vlan-tag and mtu community.proxmox.proxmox: vmid: 100 node: uk-mc02 api_user: root@pam api_password: 1q2w3e api_host: node1 password: 123456 hostname: example.org ostemplate: 'local:vztmpl/ubuntu-14.04-x86_64.tar.gz' netif: net0: "name=eth0,gw=192.168.0.1,ip=192.168.0.2/24,ip6=fe80::1227/64,gw6=fe80::1,bridge=vmbr0,firewall=1,tag=934,mtu=1500" - name: Create new container with minimal options defining a mount with 8GB community.proxmox.proxmox: vmid: 100 node: uk-mc02 api_user: root@pam api_password: 1q2w3e api_host: node1 password: 123456 hostname: example.org ostemplate: 'local:vztmpl/ubuntu-14.04-x86_64.tar.gz' mounts: mp0: "local:8,mp=/mnt/test/" - name: Create new container with minimal options defining a mount with 8GB using mount_volumes community.proxmox.proxmox: vmid: 100 node: uk-mc02 api_user: root@pam api_password: 1q2w3e api_host: node1 password: 123456 hostname: example.org ostemplate: 'local:vztmpl/ubuntu-14.04-x86_64.tar.gz' mount_volumes: - id: mp0 storage: local size: 8 mountpoint: /mnt/test - name: Create new container with minimal options defining a cpu core limit community.proxmox.proxmox: vmid: 100 node: uk-mc02 api_user: root@pam api_password: 1q2w3e api_host: node1 password: 123456 hostname: example.org ostemplate: 'local:vztmpl/ubuntu-14.04-x86_64.tar.gz' cores: 2 - name: Create new container with minimal options and same timezone as proxmox host community.proxmox.proxmox: vmid: 100 node: uk-mc02 api_user: root@pam api_password: 1q2w3e api_host: node1 password: 123456 hostname: example.org ostemplate: 'local:vztmpl/ubuntu-14.04-x86_64.tar.gz' timezone: host - name: Create a new container with nesting enabled and allows the use of CIFS/NFS inside the container. community.proxmox.proxmox: vmid: 100 node: uk-mc02 api_user: root@pam api_password: 1q2w3e api_host: node1 password: 123456 hostname: example.org ostemplate: 'local:vztmpl/ubuntu-14.04-x86_64.tar.gz' features: - nesting=1 - mount=cifs,nfs - name: > Create a linked clone of the template container with id 100. The newly created container with be a linked clone, because no storage parameter is defined community.proxmox.proxmox: vmid: 201 node: uk-mc02 api_user: root@pam api_password: 1q2w3e api_host: node1 clone: 100 hostname: clone.example.org - name: Create a full clone of the container with id 100 community.proxmox.proxmox: vmid: 201 node: uk-mc02 api_user: root@pam api_password: 1q2w3e api_host: node1 clone: 100 hostname: clone.example.org storage: local - name: Update container configuration community.proxmox.proxmox: vmid: 100 node: uk-mc02 api_user: root@pam api_password: 1q2w3e api_host: node1 netif: net0: "name=eth0,gw=192.168.0.1,ip=192.168.0.3/24,bridge=vmbr0" update: true - name: Start container community.proxmox.proxmox: vmid: 100 api_user: root@pam api_password: 1q2w3e api_host: node1 state: started - name: > Start container with mount. You should enter a 90-second timeout because servers with additional disks take longer to boot community.proxmox.proxmox: vmid: 100 api_user: root@pam api_password: 1q2w3e api_host: node1 state: started timeout: 90 - name: Stop container community.proxmox.proxmox: vmid: 100 api_user: root@pam api_password: 1q2w3e api_host: node1 state: stopped - name: Stop container with force community.proxmox.proxmox: vmid: 100 api_user: root@pam api_password: 1q2w3e api_host: node1 force: true state: stopped - name: Restart container(stopped or mounted container you can't restart) community.proxmox.proxmox: vmid: 100 api_user: root@pam api_password: 1q2w3e api_host: node1 state: restarted - name: Convert container to template community.proxmox.proxmox: vmid: 100 api_user: root@pam api_password: 1q2w3e api_host: node1 state: template - name: Convert container to template (stop container if running) community.proxmox.proxmox: vmid: 100 api_user: root@pam api_password: 1q2w3e api_host: node1 state: template force: true - name: Remove container community.proxmox.proxmox: vmid: 100 api_user: root@pam api_password: 1q2w3e api_host: node1 state: absent N) AnsibleModule to_native)ProxmoxAnsibleansible_to_proxmox_boolproxmox_auth_argument_spec) LooseVersionc4tdDidtdddtdtdtd d td td td dtdttd td tdtdtddgddigddtddtddtddtddtddtddtddttd dtd td tdtdtddtddgddigd d!td"td#gd$%d&td'd(tdd )d*tdd )d+td,-d.tdd/td0td1tdd23d4td'd3d5td'd3d6td'd3d7td8gd9%d:td d;td'd3dtd d?tdd@tdAgdB%dCtdd )S)ENvmidintF)typerequirednodepoolpasswordT)no_loghostname ostemplatediskstrr disk_volumedictpath)storagevolumesize host_pathoptionsrr r))r!r)r!r)r!r )rr"required_together required_bymutually_exclusivecorescpusmemoryswapnetifmounts mount_volumeslist)idrrr r! mountpointr")relementsr"r$r%r& ip_addressostypeauto) r4debiandevuanubuntucentosfedoraopensuse archlinuxalpinegentoonixos unmanaged)defaultchoicesonbootboolfeatures)rr1startuprlocal)r@cpuunits nameserver searchdomaintimeout)rr@updateforcepurgestatepresent)rPabsentstoppedstarted restartedtemplatepubkey unprivileged description hookscripttimezoneclone clone_type opportunistic)fulllinkedr]tags)rram/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/proxmox/plugins/modules/proxmox.pyget_proxmox_argsrd^sM i  uu -i  Vi Vi T" i   i  6 i u i %('u%F+&)  33-  i 67i 8u 9i :;i <u =i >?i @ Ai Bed3%('u%F+Vd;&) 33- ! Ci n6oi p  qi R Si T6E2Ui V&51Wi XW%Yi Z5![i \6]i ^V_i `%,ai b.ci d.ei f.gi h  ii ~i @vt4Ai Be$Ci DU#Ei F5!Gi HIi J#-P Ki Pv .Qi irbct}|jtt|ddddgfdgdgddggd  S) NrOrPrr)rOrP)r[rrLT) api_token_idapi_token_secret) api_passwordrf)rr))r[r)r[rL)rMrL)rr)rr)r,r-) argument_spec required_ifr$required_one_ofr&)r rLrdr) module_argss rcget_ansible_modulerms_,.K')* ! i&*!5 6 J  @@ ,    rbceZdZdddddZfdZdZdZdZd Zd Z d Z d Z d Z dZ dZdZdZdZdZdZdZdZdZd$dZdZdZdZdZdZdZd%dZd Zd!Z d"Z!d#Z"xZ#S)&ProxmoxLxcAnsiblez5.0z6.1z6.3)rr-r`rZctt| ||jt dkrdnd|_|j j|_y)Nz4.0openvzlxc)superro__init__versionr VZ_TYPEmoduleparams)selfrw __class__s rcrtzProxmoxLxcAnsible.__init__s? /7#'<<>L4G#GxU kk(( rbc |j|jjd}|jjd}|jjd}|s|s|jj d|dk(rb|j |||jjd|jjd|jjd  y|d k(rb|j |||jjd|jjd |jjd y|dk(rH|j|||jjd|jjd y|dk(rb|j|||jjd|jjd |jjd y|dk(rb|j|||jjd|jjd |jjd y|dk(rb|j|||jjd|jjd |jjd yy)NrOrr)Either VMID or hostname must be provided.msgrPrrLrM)rrLrMrQrJrN)rrJrNrS)rrJrR)rrJrMrTrU) check_supported_featuresrxgetrw fail_json lxc_present lxc_absent lxc_started lxc_stopped lxc_restartedlxc_to_template)ryrOrrs rcrunzProxmoxLxcAnsible.runsB %%' ({{v&;;??:.H KK ! !&Q ! R I    [[__V,{{x0kkoog.  h  OO[[__V,  2kkoog.  i    [[__V,  2   i    [[__V,  2kkoog.  k !   [[__V,  2kkoog.  j  [[__V,  2kkoog. ! !rbc|jjdd} |j||}|xs|djdd}|xs|d}| t d||ru|sr|j||}|j|||jjd|jjd |jjd |jjd |jjd |jjd |jjd|jjd|jjd|jjd|jjd|jjd|jjd|jjd|jjdt|jjd|jjd|jjd|jjd|jjd|jjd|jjd|d|z n8|s6|j||d!}|jjd|d"|z |j||d!}|jjd#|z|j|||jjd|jjd|jjd$|%y#t$rd}|xs|j }YxwxYw)&Nr[Fr//rzLArgument 'node' is None, but should be found from VMID/hostname or provided.r'r(rGrXrrrDrYrr2r)r,r-rHr+rBrIrEr*r`rZ)r'r(rGrXrrrDrYrr2r)r,r-rHr+rBrIrEr*r`rZTzVM %s has been updated.changedrr~namezVM %s already exists.zMVM %s already exists, but we don't update and instead forcefully recreate it.r)r clone_fromrrM)rxrget_lxc_resourcesplit LookupError get_nextvmid ValueErrorformat_vm_identifierupdate_lxc_instancer rw exit_jsondebugnew_lxc_instance)ryrrrrLrMrr identifiers rcrzProxmoxLxcAnsible.lxc_present2s ;;??7 # /F /''h7C33t9??3/3D&3v;D <^  ?e!66tXF ((++//'20![[__Z8 $  >0 $  >![[__Z8#{{|<![[__Z8#{{|<;;??84;;??84"&++///"B#{{|<++//'224;;??83LM!%!@ KKOOI600![[__Z8/)2 %% t1JZ1W&!66tS[I  %%!2IJ2V&224VEJ KK  _    ({{w/{{|4  m /C.4,,.D /s6N++O OcB |j||}|xsdj dd}|xsd}|j ||}|j||}|dk(r!|jj d|d |z|d k(r!|jj d|d |z|j|||||jj d |d |zy#t$r7|j||}|jj d|d|zY wxYw)NFzVM %s is already absent.rr/rrrrunningz*VM %s is running. Stop it before deletion.mountedz  " KK ! !@:M "   " KK ! !R "    tWe< t)9J)F  7 224BJ KK ! !D.HJ.W "  sC "s6{((s6{;  " KK ! !D.IJ.V "  dG4 t)9J)F  rbc|j||}|xs|djdd}|xs|d}|j||}|xs|d}|j||}|dk(r7|r|j |||n!|j j d|d|z |d k(r!|j j d|d |z |j|||||j j d |d |z y)Nr/rrrrrFzEVM %s is already stopped, but mounted. Use force option to umount it.rrRzVM %s is already stopped.TzVM %s stopped.)rrrrumount_lxc_instancerwrstop_lxc_instance ryrrrrJrMrrrrs rcrzProxmoxLxcAnsible.lxc_stoppeds##D(3/s4ys+B/*s6{..tX> "s6{((t4  "((xA %%!_ !&  " KK ! !D.IJ.V "  tT7E: t)9J)F  rbc|j||}|xs|djdd}|xs|d}|xs|d}|j||}|j||}|dvr!|jj d|d|z |j |||||j||||jj d |d |z y) Nr/rrrr)rRrFzVM %s is not running.rTzVM %s is restarted.)rrrrrwrrrrs rcrzProxmoxLxcAnsible.lxc_restarteds##D(3/s4ys+B/*s6{"s6{..tX> ((t4 / / KK ! !D.E .R "  tT7E: dG4 t)>)K  rbcH|j||}|xs|djdd}|xs|d}|xs|d}|j||}|j||r!|jj d|d|z|j ||}|d k(r|r|j||||||jj|} t| |j|jj|jj d |d |zy) Nr/rrrrFzVM %s is already a template.rrTzVM %s converted to template.)rrris_template_containerrwrr stop_instance proxmox_apinodesgetattrrvrUpost) ryrrrrJrMrrrr proxmox_nodes rcrz!ProxmoxLxcAnsible.lxc_to_templates%##D(3/s4ys+B/*s6{"s6{..tX>  % %dD 1 KK ! !2Z? "  ((t4  "u   tXtWe D''--d3 + dll+D1::??A t)G*)T  rbc (|jdk7r|jjd|jDcic] \}}| || }}}|j |j dgd|vr#dj |jd|d<d|vr#dj |jd|d<|j|||jdd|jd d}|j|||jd d|jd d}|j||j|d |vr|jd |d <d|vr |j|jdd|vrN|jd}|jtdk\r||d<n|jjd|jj|} t!| |j|j"j } i} |jD]w\} } | | vr| | | <t%| t&r8| | j)d}| j)d}|D] }||vs| | | <VXt'| t'| | k7ss| | | <y| s|jj+d|dt!| |j|j"j,d||d|ycc}}w)NrrzXUpdating LXC containers is only supported for LXC-enabled clusters in PVE 4.0 and above.r}r`rD,rErrr,r-r(cpulimitr+rV4.2ssh-public-keysB'pubkey' is not supported for PVE 4.1 and below. Ignoring keyword.Fz'Container config is already up to date.r)rrra)rvrwritems validate_tagsrjoinpopprocess_disk_keysprocess_mount_keysrLrur warnrrrconfig isinstancerrrput)ryrrkwargskv disk_updatesmounts_updatesrVrcurrent_configdiffargvaluecurrent_valuesrequested_values new_values rcrz%ProxmoxLxcAnsible.update_lxc_instances <<5 KK ! !n " $*<<>C41aQ]!Q$CC 6::fb12  !$&**Z*@!AF:    #I)> ?F9 --   JJvt $ JJ}d +  00   JJx & JJ -    l# n% V !'F!3F:  f  MM&**W- . v ZZ)F||~e!44,2()   X ''--d3 <t||##677!S  "" KK ! !D.W "  =+ dll+D188<< D $* GDs L Lc ~|j||}||j||||jjd|jjd|jjd||jjd|jjd |jj d|d||fz |L|j |||fid|jjdd |jjd d |jjd d |jjd d|jjdd |jjd d|jjdd|jjddt|d|jjdd|d|jjdd|jjdd|jjdd|jjdd|jjdd|jjddt|jjdd|jjdd|jjdd|jjdd|jjdd|jjdd|jjdd|jjdd|jjdd |jjd d!|jjd!d"t|jjd"|jj d|d#|d$| |jj|d%|z&y)'Nr\rJrXrr)r\rJrXrrrTzCloned VM %s from %drr'r(rGrrrDrMrYrr2r)r,r-rHr+rBr3rrVrIrEr*r`rZrWz Created VM  from template zEVM %s does not exist but neither clone nor ostemplate were specified!rr~) rclone_lxc_instancerxrrwrcreate_lxc_instancer r)ryrrrrrrMrs rcrz"ProxmoxLxcAnsible.new_lxc_instanceDs..tX>  !  # #;;??<8  2 KKOOM:![[__V,  2 $  KK ! !*j*-EE "   ! $D $ $!   2 !  kkoog. !  [[__V, ! 4! !KKOOM:! [[__V,! !KKOOM:! 4! .e4!  ;;??<8! "!  ;;??<8!  {{x0!! "{{x0#! $#kkooo>%! & ;;??<8'! (kkoog.)! */t{{x/HI+! ,{{x0-! .4/! 0[[__V,1! 2{{x03! 4"[[__^<5! 6  27! 8  29! :[[__V,;! <[[__V,=! >4?! @5T[[__^5TUA! D KK ! !8BJO "  W  rbc |jdd}|j|||s'|jj|d|d|d|d|j |||j d|j d }|j |||j d |j d }|j||j||jD cic] \} } |  | |  }} } d |vr#d j|j d |d <d|vr#d j|j d|d<|j|jdg|jdk(r:d|vr|j d|d<|j|j din0d |vr,|j d |jjdd|vrN|j d} |jtdk\r| |d<n|jjd|jddk(r|j d|j j#|} t%| |jj&d||d|} |j)||| |d|d|ycc} } w)N:rz ostemplate z does not exist on node z and storage .rrrr,r-rDrrEr`rrr(rGr+zH'mount_volumes' is not supported for non-LXC clusters. Ignoring keyword.rVrrrr3r4)rrz1Reached timeout while waiting for creation of VM rra)r content_checkrwrrrrrLrrrrrvrrur rrrcreatehandle_api_timeout)ryrrrrJrtemplate_storerrrrrVrtaskids rcrz%ProxmoxLxcAnsible.create_lxc_instances#))#.q1!!$ NC KK ! !t^5 "  --   JJv  JJ} %  00   JJx JJ '    l# n%$*<<>C41aQ]!Q$CC  !$&**Z*@!AF:    #I)> ?F9  6::fb12 <<5 %+ZZ%7z" MM&**Wb1 2&( ?+   ^ v ZZ)F||~e!44,2()   X ::h 6 ) JJx ''--d3 ;t||4;; * 06      Z !  KDs ( J:3J:c |jdk7r|jjd|jDcic] \}}| || }}}|j ||} | } gd} d|vr| rd} n#d|vr| s|jjdd |d k(r | s|jjdd n1|d k(r| s| j dn|d k(rd} | j di} t | | d <| D]} | |vs|| | | <|jj|}t||j|jjdd|i| }|j||||dycc}}w)NrrzHCloning is only supported for LXC-enabled clusters in PVE 4.0 and above.r})rrrXrTFzHClone target container is not a template, storage needs to be specified.rr~r_z@Cloning type 'linked' is only supported for template containers.r]r^newidz.Reached timeout while waiting for VM to clone. timeout_msgra) rvrwrrrappendr rrrr[rr)ryrrrr\rJrrrtarget_is_templatecreate_full_copyvalid_clone_parametersclone_parametersparamrrs rcrz$ProxmoxLxcAnsible.clone_lxc_instances <<5 KK ! !^ "  $*<<>C41aQ]!Q$CC!77jI11"E F "'9#  f $-? KK ! !^ "   !*< KK ! !V " ? *3E " ) )) 4 6 !#  " ) )) 4#:;K#L + 8E*0- ' 8''--d3 K4t||4Z@FFKK  *      H  SDs E; E;c|jj|}t||j|jj j }|j||||dy)Nz.Reached timeout while waiting for VM to start.r)rrrrvstatusstartrrryrrrJrrs rcrz$ProxmoxLxcAnsible.start_lxc_instancesf''--d3 4t||4T:AAGGLLN     H  rbci}|rd|d<|jj|}t||j|jj j di|}|j||||dy)N forceStopz-Reached timeout while waiting for VM to stop.rra)rrrrvrshutdownrr)ryrrrJrM stop_paramsrrs rcrz#ProxmoxLxcAnsible.stop_lxc_instances '(K $''--d3 O4t||4T:AAJJOO       G  rbc|jj|}t||j|jj j }|j||||dy)Nz5Reached timeout while waiting for VM to be unmounted.r)rrrrvrunmountrrrs rcrz%ProxmoxLxcAnsible.umount_lxc_instance%sf''--d3 4t||4T:AAIINNP     O  rbci}|rd|d<|jj|}t||jj|fi|}|j ||||dy)NrrNz3Reached timeout while waiting for VM to be removed.r)rrrrvdeleter)ryrrrJrN delete_paramsrrs rcrz%ProxmoxLxcAnsible.remove_lxc_instance1sn %&M' "''--d3 ;t||4;;DRMR     M  rbc||iSi}|'|jr||d<n|j|}||j||fddi|}|jdk7r|j d|d<|S)a$ Process disk keys and return a formatted disk volume with the `rootfs` key. Args: vmid (int): VM identifier. node (str): Node identifier. disk (str, optional): Disk key in the format 'storage:volume'. Defaults to None. disk_volume (Dict[str, Any], optional): Disk volume data. Defaults to None. Returns: Dict[str, str]: Formatted disk volume with the `rootfs` or `disk` key (depending on the `VZ_TYPE`), or an empty dict if no disk volume is specified. rootfskeyrrr)isdigitparse_disk_string build_volumervr)ryrrrr disk_dicts rcrz#ProxmoxLxcAnsible.process_disk_keysAs  I' <#55lC $$T%GY%G,%GH I "mr&9I ) +L$((.I***4U9U UJ   z * + rbc|jd}|Dcgc] }d|vrd|zn|}}ttd|}d}tj|}|j d}|j |}| td|f|j} | jD cic] \} } |  | |  } } } d| vrd| vr| d|d<| d|d<|Sd| vrd | vr| d|d<| d |d <|Sd | vr| d |d <|Scc}wcc} } w) a Parse a disk string and return a dictionary with the disk details. Args: disk_string (str): Disk string. Returns: Dict[str, Any]: Disk details. Note: Below are some example disk strings that this function MUST be able to parse: "acl=0,thin1:base-100-disk-1,size=8G" "thin1:10,backup=0" "local:20" "local-lvm:0.50" "tmp-dir:300/subvol-300-disk-0.subvol,acl=1,size=0T" "tmplog-dir:300/vm-300-disk-0.raw,mp=/var/log,mountoptions=noatime,size=32M" "volume=local-lvm:base-100-disk-1,size=20G" "/mnt/bindmounts/shared,mp=/shared" "volume=/dev/USB01,mp=/mnt/usb01" r=zvolume=c$|jdS)Nr)r)items rcz5ProxmoxLxcAnsible.parse_disk_string..sDJJsOrbaG(?x) ^ (?: (?: (?P[\w\-.]+): (?: (?P\d+\.?\d*)| (?P[^,\s]+) ) )| (?P[^,\s]+) ) $ rzInvalid volume string: %srr r!) rrmaprecompilermatchr groupdictr) ry disk_stringargsr disk_kwargsVOLUME_PATTERNpattern volume_stringr match_dictrrs rcrz#ProxmoxLxcAnsible.parse_disk_string~sc*  %GKKs3c> Cs:KK3;TBC   &**^,#1  m, =9=IJ J__& '1'7'7'9Ktq!Q]adK K  "x:'=%/ %:K "$.x$8K !*)* $:)=%/ %:K "",V"4K $#J &'1+'>K $ mL:LsD+ D6Dc t|tr t|}|t|r|dz }||j |||} | D cgc]} | d } } dj ||}|| vr.|j jddj ||d j ||| }n||jj|} |j|jd j|} |j| jd }d j ||| }n|d}n td||d|zz }||dj |z }| H|ddj#| j%Dcgc]\}}dj ||c}}zz }| rH|ddj#| j%Dcgc]\}}dj ||c}}zz }||iScc} w#t$rR| td |jdr%|j!d}dj ||}n tdYwxYwcc}}wcc}}w)aW Build a volume string for the specified VM. Args: vmid (str): The VM ID. node (str): The node where the VM resides. key (str): The key for the volume in the VM's config. storage (str, optional): The storage pool where the volume resides. Defaults to None. volume (str, optional): The name of the volume. Defaults to None. host_path (str, optional): The host path to mount. Defaults to None. size (str | int, optional): The size of the volume in GiB. Defaults to None. mountpoint (str, optional): The mountpoint for the volume. Defaults to None. options (Dict[str, Any], optional): Additional options for the volume. Defaults to None. **kwargs: Additional keyword arguments. Returns: Dict[str, str]: The built volume string in the format {'volume_key': 'volume_string'}. Note: Further documentation can be found in the proxmox-api documentation: https://pve.proxmox.com/wiki/Linux_Container#pct_mount_points Note: To build a valid volume string, we need ONE of the following: A volume name, storage name, and size Only a storage name and size (to create a new volume or assign the volume automatically) A host directory to mount into the container G)rvolidz{storage}:{volume})rrFz2Storage {storage} does not contain volume {volume}rz{storage}:{volume},size={size})rrr rrz9Size must be provided for storage-backed volume creation.z{storage}:{size}r#zvSize must be provided in GiB for storage-backed volume creation. Convert it to GiB or allocate a new storage manually.z]Could not build a valid volume string. One of volume, storage, or host_path must be provided.rz,mp={}z{0}={1})rrrisfloatget_storage_contentformatrwrrrrrrr Exceptionrendswithrstriprr)ryrrrrrr!r r0r"rstorage_contentvolvol_idsr vol_stringrrrs rcrzProxmoxLxcAnsible.build_volumes2 dC t9D   CKD  "66tW46PO/>?s7|?G?(///OEG# %%!LSS '%T&:@@TAJ ++11L "&&t,00:>>sC//488B=DD#FE & "Jo   # / )J  ! (//*5 5J   #4;MMODDAq!!!Q'D! J  #4:LLNCDAq!!!Q'C! JZ  }@4 <$S]]3';;s+D!3!:!:7QU!:!VJ$Q :E Ds& G:A#G?II#?AIIc@|s|s|jjd|r|j|}n|r|j|}d}|d|jk7r?|j ||}|jjd|d|jd|S)Nr|r}rrzThe specified VM z is not an r)rwrget_lxc_resource_by_idget_lxc_resource_by_hostnamervr)ryrrvmrs rcrz"ProxmoxLxcAnsible.get_lxc_resource0sH KK ! !&Q ! R ,,T2B 228>vFJJNNPQSRSTV  rbc|jj|}t||j|jj }|j ddS)z/Check if the specified container is a template.rUF)rrrrvrr)ryrtargetrrs rcrz'ProxmoxLxcAnsible.is_template_containersO''--d3 4t||4V<CCGGIzz*e,,rbc|jj|}|j|jj }t fd|DS)zFCheck if the specified ostemplate is present in the specified storage.c3.K|] }|dk(yw)rNra).0contentrs rc z2ProxmoxLxcAnsible.content_check..sRg77#z1Rs)rrrr;rany)ryrrrrstorage_contentss ` rcrzProxmoxLxcAnsible.content_checksK''--d3 '//?GGKKMRAQRRRrbctjd}|D]4}|j|r|jj d|zyy)z&Check if the specified tags are valid.z!^[a-zA-Z0-9_][a-zA-Z0-9_\-\+\.]*$z%s is not a valid tagr}FT)rrrrwr)ryr`re_tagtags rcrzProxmoxLxcAnsible.validate_tagssO@A C<<$ %%*AC*G%H rbc .|jjD]x\}}|jt|ks#||jj vs<|jj ddj|||jzy)NFzXFeature {option} is only supported in PVE {version}+, and you're using PVE {pve_version})optionru pve_versionr)MINIMUM_VERSIONSrrur rwrxrr)ryrCrus rcrz*ProxmoxLxcAnsible.check_supported_featuress#44::< OFG||~ W 55&DKKDVDV:V %%!ryy%wDLLNz& rb)NNNNNN)r)$__name__ __module__ __qualname__rErtrrrrrrrrrrrrrrrrrrrrrr r#rrrrrrr __classcell__)rzs@rcroros ) 9vE N  D $ : * 0K ZB HE N6 p   $   @:N``!D$ X# "- S rbroc@|y t|y#t$rYywxYw)NFT)floatr)rs rcrrs+ } e  s  ct}t|} |jy#t$r(}|j dt |zYd}~yd}~wwxYw)NzAn error occurred: %sr})rmrorrrr)rwproxmoxr*s rcmainrNsS  !F'GE E4y|CDDEs( AAA__main__) __future__rrrr __metaclass__ DOCUMENTATIONEXAMPLESrr2ansible.module_utils.basicr+ansible.module_utils.common.text.convertersrBansible_collections.community.proxmox.plugins.module_utils.proxmoxr r r Bansible_collections.community.proxmox.plugins.module_utils.versionr rdrmrorrNrFrarbrcrXs}A@ ^ @ c J  4A \jZ