VhEddlmZmZmZeZdZdZdZddl Z ddl m Z ddl m Z mZddlmZd Zd d gZgd ZGd deZdZedk(reyy))absolute_importdivisionprint_functiona module: lxd_profile short_description: Manage LXD profiles description: - Management of LXD profiles. author: "Hiroaki Nakamura (@hnakamur)" extends_documentation_fragment: - community.general.attributes attributes: check_mode: support: none diff_mode: support: none options: name: description: - Name of a profile. required: true type: str project: description: - Project of a profile. See U(https://documentation.ubuntu.com/lxd/en/latest/projects/). type: str required: false version_added: 4.8.0 description: description: - Description of the profile. type: str config: description: - 'The config for the instance (for example V({"limits.memory": "4GB"})).' - See U(https://documentation.ubuntu.com/lxd/en/latest/api/#/profiles/profile_get). - If the profile already exists and its C(config) value in metadata obtained from GET /1.0/profiles/ U(https://documentation.ubuntu.com/lxd/en/latest/api/#/profiles/profile_get) are different, then this module tries to apply the configurations U(https://documentation.ubuntu.com/lxd/en/latest/api/#/profiles/profile_put). - Not all config values are supported to apply the existing profile. Maybe you need to delete and recreate a profile. required: false type: dict devices: description: - 'The devices for the profile (for example V({"rootfs": {"path": "/dev/kvm", "type": "unix-char"})).' - See U(https://documentation.ubuntu.com/lxd/en/latest/api/#/profiles/profile_get). required: false type: dict new_name: description: - A new name of a profile. - If this parameter is specified a profile will be renamed to this name. - See U(https://documentation.ubuntu.com/lxd/en/latest/api/#/profiles/profile_post). required: false type: str merge_profile: description: - Merge the configuration of the present profile with the new desired configuration, instead of replacing it. required: false default: false type: bool version_added: 2.1.0 state: choices: - present - absent description: - Define the state of a profile. required: false default: present type: str url: description: - The unix domain socket path or the https URL for the LXD server. required: false default: unix:/var/lib/lxd/unix.socket type: str snap_url: description: - The unix domain socket path when LXD is installed by snap package manager. required: false default: unix:/var/snap/lxd/common/lxd/unix.socket type: str client_key: description: - The client certificate key file path. - If not specified, it defaults to C($HOME/.config/lxc/client.key). required: false aliases: [key_file] type: path client_cert: description: - The client certificate file path. - If not specified, it defaults to C($HOME/.config/lxc/client.crt). required: false aliases: [cert_file] type: path trust_password: description: - The client trusted password. - 'You need to set this password on the LXD server before running this module using the following command: C(lxc config set core.trust_password ). See U(https://www.stgraber.org/2016/04/18/lxd-api-direct-interaction/).' - If O(trust_password) is set, this module send a request for authentication before sending any requests. required: false type: str notes: - Profiles must have a unique name. If you attempt to create a profile with a name that already existed in the users namespace the module will simply return as "unchanged". a # An example for creating a profile - hosts: localhost connection: local tasks: - name: Create a profile community.general.lxd_profile: name: macvlan state: present config: {} description: my macvlan profile devices: eth0: nictype: macvlan parent: br0 type: nic # An example for creating a profile in project mytestproject - hosts: localhost connection: local tasks: - name: Create a profile community.general.lxd_profile: name: testprofile project: mytestproject state: present config: {} description: test profile in project mytestproject devices: {} # An example for creating a profile via http connection - hosts: localhost connection: local tasks: - name: Create macvlan profile community.general.lxd_profile: url: https://127.0.0.1:8443 # These client_cert and client_key values are equal to the default values. # client_cert: "{{ lookup('env', 'HOME') }}/.config/lxc/client.crt" # client_key: "{{ lookup('env', 'HOME') }}/.config/lxc/client.key" trust_password: mypassword name: macvlan state: present config: {} description: my macvlan profile devices: eth0: nictype: macvlan parent: br0 type: nic # An example for modify/merge a profile - hosts: localhost connection: local tasks: - name: Merge a profile community.general.lxd_profile: merge_profile: true name: macvlan state: present config: {} description: my macvlan profile devices: eth0: nictype: macvlan parent: br0 type: nic # An example for deleting a profile - hosts: localhost connection: local tasks: - name: Delete a profile community.general.lxd_profile: name: macvlan state: absent # An example for renaming a profile - hosts: localhost connection: local tasks: - name: Rename a profile community.general.lxd_profile: name: macvlan new_name: macvlan2 state: present a old_state: description: The old state of the profile. returned: success type: str sample: "absent" logs: description: The logs of requests and responses. returned: when ansible-playbook is invoked with -vvvv. type: list sample: "(too long to be placed here)" actions: description: List of actions performed for the profile. returned: success type: list sample: ["create"] N) AnsibleModule) LXDClientLXDClientException) urlencodezunix:/var/lib/lxd/unix.socketpresentabsent)config descriptiondevicescpeZdZdZdZdZedZdZdZ dZ dZ d Z d Z d Zd Zd ZdZdZy)LXDProfileManagementc@||_|jjd|_|jjd|_|j |jjd|_|jjj dd|_|jjj d|_|j'djtjd|_|jjj d |_ |j'd jtjd|_ |jjd k\|_ |jjd tk7r|jjd |_ntj"j%|jjd j'ddr|jjd |_n|jjd |_ t/|j |j|j|j|_|jjj dd|_g|_y#t($r0}|jj+|j,Yd}~d}~wwxYw#t2$r0}|jj+|j,Yd}~d}~wwxYw)zManagement of LXC profiles via Ansible. :param module: Processed Ansible Module. :type module: ``object`` nameprojectstatenew_nameN client_keyz{0}/.config/lxc/client.keyHOME client_certz{0}/.config/lxc/client.crturlsnap_urlzunix:)msg)key_file cert_filedebugtrust_password)moduleparamsrr _build_configrgetrrformatosenvironr _verbosityr ANSIBLE_LXD_DEFAULT_URLrpathexistsreplace Exception fail_jsonrrclientrr!actions)selfr"es q/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/general/plugins/modules/lxd_profile.py__init__zLXDProfileManagement.__init__sJ  KK&&v. {{)))4  [[''0  **..z4@  **..|< == 8?? 6@RSDM++// > >> !9@@FASTDN[[++q0  -{{!!%(,CC;;--e4 2 2: > F FwPR ST;;--j9;;--e4 -#4==DNNjjDK #kk00445EtL  - KK ! !aee ! , , -" - KK ! !aee ! , , -s16CJ(9rPOSTcreate) rr&r rAr copyrr0rBr1appendr2rr s r4rNz$LXDProfileManagement._create_profileHss <<""3 $t||2L(MNC!!#v vsF+ H%r:c^dj|j}|jr/dj|tt |j}d|j i}|j jd|||jjd|j |_y)Nr<r=r>rrVrename) r&rrr rArr0rBr1rYrZs r4rOz$LXDProfileManagement._rename_profileQs|!((3 <<""3 $t||2L(MNC$--( vsF+ H%MM r:c||jvry|jdj|d}|j||k7S)NFmetadata)r old_profile_jsonr%)r2key old_configss r4_needs_to_change_profile_configz4LXDProfileManagement._needs_to_change_profile_configZsB dkk !++J7;;CF {{3;..r:cp|jdxs$|jdxs|jdS)Nr r r)rbrSs r4rPz4LXDProfileManagement._needs_to_apply_profile_configs`s;  0 0 : <  0 0 ? <  0 0 ; r:c|jD]?\}}t|tr%|j|i}|j ||;|||<A|S)a`Merge Dictionaries Get a list of filehandle numbers from logger to be handed to DaemonContext.files_preserve Args: dict(source): source dict dict(destination): destination dict Kwargs: None Raises: None Returns: dict(destination): merged dict)items isinstancerA setdefault _merge_dicts)r2source destinationr`valuenodes r4rhz!LXDProfileManagement._merge_dictsgs[!,,. )JC%&"--c26!!%.#( C  )r:cdD]0}||vr|j|d|||||<&|d|||<2|j|j|S)aE merge profile Merge Configuration of the present profile and the new desired configitems Args: dict(config): Dict with the old config in 'metadata' and new config in 'config' Kwargs: None Raises: None Returns: dict(config): new config)r r rrused_byr^)rhr )r2r items r4 _merge_configz"LXDProfileManagement._merge_configslL 8Dv~#00 1CD1I6RV<Xt %j1$7t  8   f55r:cT|jjD] \}}|||< |S)a rebuild profile Rebuild the Profile by the configuration provided in the play. Existing configurations are discarded. This is the default behavior. Args: dict(config): Dict with the old config in 'metadata' and new config in 'config' Kwargs: None Raises: None Returns: dict(config): new config)r re)r2r kvs r4_generate_new_configz)LXDProfileManagement._generate_new_configs2 KK%%' DAqF1I  r:c|jj}|jjdr|j |}n|j |}dj |j}|jr/dj |tt|j}|jjd|||jjdy)a Selection of the procedure: rebuild or merge The standard behavior is that all information not contained in the play is discarded. If "merge_profile" is provides in the play and "True", then existing configurations from the profile and new ones defined are merged. Args: None Kwargs: None Raises: None Returns: None merge_profiler<r=r>PUTapply_profile_configsN)r_rXr"r#rprtr&rrr rAr0rBr1rY)r2r rs r4rQz+LXDProfileManagement._apply_profile_configss"&&++- ;;  o .''/F..v6F"((3 <<""3 $t||2L(MNC uc6* 34r:cdj|j}|jr/dj|tt |j}|j j d||jjdy)Nr<r=r>DELETEdelete) r&rrr rAr0rBr1rYrCs r4rRz$LXDProfileManagement._delete_profilesa!((3 <<""3 $t||2L(MNC x% H%r:c |j%|jj|j|j|_|j |j|_|jt|jdkD}||j |jd}|jjr|jj|d<|jjdi|y#t$r}t|jdkD}|j||jd}|jjr|j d|d<|jj"di|Yd}~yd}~wwxYw)zRun the main method.Nr)rLrMr1logs)rrLr1rH)r!r0 authenticaterDr_rJrMrTlenr1r r}r" exit_jsonrrkwargsr/)r2 state_changed result_jsonr3 fail_paramss r4runzLXDProfileManagement.runs9 1"". (()<)<=$($:$:$ansible_collections.community.general.plugins.module_utils.lxdrr+ansible.module_utils.six.moves.urllib.parser r*rr7objectrrrrHr:r4rsA@ i VV p $ 4hA:x  w16w1t6r zFr: