VhddlmZmZmZeZdZdZddlZddl Z ddl m Z ddl m Z ddlmZmZmZddlmZd Zd ZGd d eZd ZdZedk(reyy))absolute_importdivisionprint_functionaa. 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). - Since community.general 4.0.0 on, there are no more default values. attributes: check_mode: support: none diff_mode: support: none action_group: version_added: 9.0.0 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 version_added: 9.2.0 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 version_added: 2.0.0 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 version_added: 8.5.0 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 version_added: 9.2.0 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' version_added: 8.1.0 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 version_added: 6.2.0 timeout: description: - Timeout for operations. type: int default: 30 update: description: - If V(true), the container will be updated with new values. - The current default value of V(false) is deprecated and should will change to V(true) in community.general 11.0.0. Please set O(update) explicitly to V(false) or V(true) to avoid surprises and get rid of the deprecation warning. type: bool version_added: 8.1.0 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. 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 version_added: 2.3.0 state: description: - Indicate desired state of the instance. - V(template) was added in community.general 8.1.0. 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. - The default change to V(true) in community.general 7.0.0. It used to be V(false) before. 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 version_added: '0.2.0' hookscript: description: - Script that will be executed during various steps in the containers lifetime. type: str version_added: '0.2.0' 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 version_added: '7.1.0' 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 version_added: 4.3.0 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 version_added: 4.3.0 author: Sergei Antipov (@UnderGreen) seealso: - module: community.general.proxmox_vm_info extends_documentation_fragment: - community.general.proxmox.actiongroup_proxmox - community.general.proxmox.documentation - community.general.proxmox.selection - community.general.attributes a - name: Create new container with minimal options community.general.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.general.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.general.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.general.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.general.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.general.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.general.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.general.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.general.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.general.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.general.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.general.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.general.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.general.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.general.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.general.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.general.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.general.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.general.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.general.proxmox: vmid: 100 api_user: root@pam api_password: 1q2w3e api_host: node1 state: started timeout: 90 - name: Stop container community.general.proxmox: vmid: 100 api_user: root@pam api_password: 1q2w3e api_host: node1 state: stopped - name: Stop container with force community.general.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.general.proxmox: vmid: 100 api_user: root@pam api_password: 1q2w3e api_host: node1 state: restarted - name: Convert container to template community.general.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.general.proxmox: vmid: 100 api_user: root@pam api_password: 1q2w3e api_host: node1 state: template force: true - name: Remove container community.general.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) LooseVersionc2tdDidtdddtdtdtd 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'd5td'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/general/plugins/modules/proxmox.pyget_proxmox_argsrdmsK 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)rOrPr[rrLT) api_token_idapi_token_secret) api_passwordrg)rr)rf)rr)rr)r,r-) argument_spec required_ifr$required_one_ofr&)r rLrdr) module_argss rcget_ansible_modulerns_,.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)superrp__init__versionr VZ_TYPEmoduleparams)selfrx __class__s rcruzProxmoxLxcAnsible.__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_featuresrygetrx fail_json lxc_present lxc_absent lxc_started lxc_stopped lxc_restartedlxc_to_template)rzrOrrs 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 |j||}|xs|djdd}|xs|d}| t d|| |j j ddd d }|rr|j||}|j|||jjd |jjd |jjd |jjd|jjd|jjd|jjd|jjd|jjd|jjd|jjd|jjd|jjd|jjd|jjdt|jjd|jjd|jjd|jjd|jjd|jjd |j jd!|d"|z#n8|s6|j||d$}|j jd |d%|z#|j||d$}|j jd&|z|j|||jjd|jjd'|jjd(|)y#t$rd}|xs|j}YwxYw)*Nr//rzLArgument 'node' is None, but should be found from VMID/hostname or provided.zjThe default value of false for 'update' has been deprecated and will be changed to true in version 11.0.0.z11.0.0zcommunity.general)rrvcollection_nameFr'r(rGrXrrrDrYrr2r)r,r-rHr+rBrIrEr*r`rZ)r'r(rGrXrrrDrYrr2r)r,r-rHr+rBrIrEr*r`rZTzVM %s has been updated.changedrrnamezVM %s already exists.zMVM %s already exists, but we don't update and instead forcefully recreate it.r[r)r clone_fromrrM)get_lxc_resourcesplit LookupError get_nextvmid ValueErrorrx deprecateformat_vm_identifierupdate_lxc_instanceryrr exit_jsondebugnew_lxc_instance)rzrrrrLrMrs identifiers rcrzProxmoxLxcAnsible.lxc_present?s% /''h7C33t9??3/3D&3v;D <^  ?~ %%E$$7& !66tXF ((++//'20![[__Z8 $  >0 $  >![[__Z8#{{|<![[__Z8#{{|<;;??84;;??84"&++///"B#{{|<++//'224;;??83LM!%!@ KKOOI600![[__Z8/)2 %% t1JZ1W&!66tS[I  %%!2IJ2V&224VEJ KK  _    ({{w/{{|4   /C.4,,.D /s6N--OOcB |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_instancerxrstop_lxc_instance rzrrrrJrMrsrrs 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.)rrrrrxrrrrs 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_containerrxrr stop_instance proxmox_apinodesgetattrrwrUpost) rzrrrrJrMrsrr 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)NrszXUpdating 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)rwrxritems validate_tagsrjoinpopprocess_disk_keysprocess_mount_keysrLrvr warnrrrconfig isinstancerrrput)rzrrkwargskv disk_updatesmounts_updatesrVrcurrent_configdiffargvaluecurrent_valuesrequested_values new_values rcrz%ProxmoxLxcAnsible.update_lxc_instance s <<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_instanceryrrxrcreate_lxc_instancer r)rzrrrrrrMrs rcrz"ProxmoxLxcAnsible.new_lxc_instanceWs..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`rsr(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_checkrxrrrrrLrrrrrwrrvr rrrcreatehandle_api_timeout)rzrrrrJrtemplate_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)NrszHCloning 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.rrr_z@Cloning type 'linked' is only supported for template containers.r]r^newidz.Reached timeout while waiting for VM to clone. timeout_msgra) rwrxrrrappendr rrrr[rr)rzrrrr\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)rrrrwstatusstartrrrzrrrJrrs 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)rrrrwrshutdownrr)rzrrrJrM stop_paramsrrs rcrz#ProxmoxLxcAnsible.stop_lxc_instance&s '(K $''--d3 O4t||4T:AAJJOO       G  rbc|jj|}t||j|jj j }|j||||dy)Nz5Reached timeout while waiting for VM to be unmounted.r)rrrrwrunmountrrrs rcrz%ProxmoxLxcAnsible.umount_lxc_instance8sf''--d3 4t||4T:AAIINNP     O  rbci}|rd|d<|jj|}t||jj|fi|}|j ||||dy)NrrNz3Reached timeout while waiting for VM to be removed.r)rrrrwdeleter)rzrrrJrN delete_paramsrrs rcrz%ProxmoxLxcAnsible.remove_lxc_instanceDsn %&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. rootfskeyrsr)isdigitparse_disk_string build_volumerwr)rzrrrr disk_dicts rcrz#ProxmoxLxcAnsible.process_disk_keysTs  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) rz disk_stringargsr disk_kwargsVOLUME_PATTERNpattern volume_stringr  match_dictrrs rcrz#ProxmoxLxcAnsible.parse_disk_stringsc*  %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_contentformatrxrrrrsrr Exceptionrendswithrstriprr)rzrrrrrr!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)rxrget_lxc_resource_by_idget_lxc_resource_by_hostnamerwr)rzrrvmrs rcrz"ProxmoxLxcAnsible.get_lxc_resourceCsH KK ! !&Q ! R ,,T2B 228>vFJJNNPQSRSTV  rbc|jj|}t||j|jj }|j ddS)z/Check if the specified container is a template.rUF)rrrrwrr)rzrtargetrrs 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)rzrrrrstorage_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)rr r rxr)rzr`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})optionrv pve_versionr)MINIMUM_VERSIONSrrvr rxryrr)rzrFrvs rcrz*ProxmoxLxcAnsible.check_supported_featuress#44::< OFG||~ W 55&DKKDVDV:V %%!ryy%wDLLNz& rb)NNNNNN)r)$__name__ __module__ __qualname__rHrurrrrrrrrrrrrrrrrrrrrr"r#r&rrrrrrr __classcell__)r{s@rcrprps ) 9vK Z  D $ : * 0K ZB HE N6 p   $   @:N``!D$ X# "- S rbrpc@|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~)rnrprrrr)rxproxmoxr-s rcmainrQsS  !F'GE E4y|CDDEs( AAA__main__) __future__rrrr __metaclass__ DOCUMENTATIONEXAMPLESrr5ansible.module_utils.basicr+ansible.module_utils.common.text.convertersrBansible_collections.community.general.plugins.module_utils.proxmoxr r r Bansible_collections.community.general.plugins.module_utils.versionr rdrnrprrQrIrarbrcr[s}A@ m ^ c J  4A \jZ8}}@E zFrb