VhtddlmZmZmZeZdZdZdZddl m Z ddl m Z m Z dZdZd Zd ZGd d eZd Zedk(reyy))absolute_importdivisionprint_functiona\ module: manageiq_provider short_description: Management of provider in ManageIQ extends_documentation_fragment: - community.general.manageiq - community.general.attributes author: Daniel Korn (@dkorn) description: - The manageiq_provider module supports adding, updating, and deleting provider in ManageIQ. attributes: check_mode: support: none diff_mode: support: none options: state: type: str description: - V(absent) - provider should not exist, - V(present) - provider should be present, - V(refresh) - provider will be refreshed. choices: ['absent', 'present', 'refresh'] default: 'present' name: type: str description: The provider's name. required: true type: type: str description: The provider's type. choices: ['Openshift', 'Amazon', 'oVirt', 'VMware', 'Azure', 'Director', 'OpenStack', 'GCE'] zone: type: str description: The ManageIQ zone name that will manage the provider. default: 'default' provider_region: type: str description: The provider region name to connect to (for example AWS region for Amazon). host_default_vnc_port_start: type: str description: The first port in the host VNC range. host_default_vnc_port_end: type: str description: The last port in the host VNC range. subscription: type: str description: Microsoft Azure subscription ID. project: type: str description: Google Compute Engine Project ID. azure_tenant_id: type: str description: Tenant ID. defaults to None. aliases: [keystone_v3_domain_id] tenant_mapping_enabled: type: bool default: false description: Whether to enable mapping of existing tenants. api_version: type: str description: The OpenStack Keystone API version. choices: ['v2', 'v3'] provider: description: Default endpoint connection information, required if state is true. type: dict suboptions: hostname: type: str description: The provider's API hostname. required: true port: type: int description: The provider's API port. userid: type: str description: Provider's API endpoint authentication userid. password: type: str description: Provider's API endpoint authentication password. auth_key: type: str description: Provider's API endpoint authentication bearer token. validate_certs: description: Whether SSL certificates should be verified for HTTPS requests (deprecated). type: bool default: true aliases: [verify_ssl] security_protocol: type: str description: How SSL certificates should be used for HTTPS requests. choices: ['ssl-with-validation', 'ssl-with-validation-custom-ca', 'ssl-without-validation', 'non-ssl'] certificate_authority: type: str description: The CA bundle string with custom certificates. path: type: str description: - TODO needs documentation. project: type: str description: - TODO needs documentation. role: type: str description: - TODO needs documentation. subscription: type: str description: - TODO needs documentation. uid_ems: type: str description: - TODO needs documentation. metrics: description: Metrics endpoint connection information. type: dict suboptions: hostname: type: str description: The provider's API hostname. required: true port: type: int description: The provider's API port. userid: type: str description: Provider's API endpoint authentication userid. password: type: str description: Provider's API endpoint authentication password. auth_key: type: str description: Provider's API endpoint authentication bearer token. validate_certs: description: Whether SSL certificates should be verified for HTTPS requests (deprecated). type: bool default: true aliases: [verify_ssl] security_protocol: type: str choices: ['ssl-with-validation', 'ssl-with-validation-custom-ca', 'ssl-without-validation', 'non-ssl'] description: How SSL certificates should be used for HTTPS requests. certificate_authority: type: str description: The CA bundle string with custom certificates. path: type: str description: Database name for oVirt metrics. Defaults to V(ovirt_engine_history). project: type: str description: - TODO needs documentation. role: type: str description: - TODO needs documentation. subscription: type: str description: - TODO needs documentation. uid_ems: type: str description: - TODO needs documentation. alerts: description: Alerts endpoint connection information. type: dict suboptions: hostname: type: str description: The provider's API hostname. required: true port: type: int description: The provider's API port. userid: type: str description: Provider's API endpoint authentication userid. defaults to None. password: type: str description: Provider's API endpoint authentication password. defaults to None. auth_key: type: str description: Provider's API endpoint authentication bearer token. defaults to None. validate_certs: type: bool description: Whether SSL certificates should be verified for HTTPS requests (deprecated). defaults to True. default: true aliases: [verify_ssl] security_protocol: type: str choices: ['ssl-with-validation', 'ssl-with-validation-custom-ca', 'ssl-without-validation', 'non-ssl'] description: How SSL certificates should be used for HTTPS requests. defaults to None. certificate_authority: type: str description: The CA bundle string with custom certificates. defaults to None. path: type: str description: - TODO needs documentation. project: type: str description: - TODO needs documentation. role: type: str description: - TODO needs documentation. subscription: type: str description: - TODO needs documentation. uid_ems: type: str description: - TODO needs documentation. ssh_keypair: description: SSH key pair used for SSH connections to all hosts in this provider. type: dict suboptions: hostname: type: str description: Director hostname. required: true userid: type: str description: SSH username. auth_key: type: str description: SSH private key. validate_certs: description: - Whether certificates should be verified for connections. type: bool default: true aliases: [verify_ssl] security_protocol: type: str choices: ['ssl-with-validation', 'ssl-with-validation-custom-ca', 'ssl-without-validation', 'non-ssl'] description: - TODO needs documentation. certificate_authority: type: str description: - TODO needs documentation. password: type: str description: - TODO needs documentation. path: type: str description: - TODO needs documentation. project: type: str description: - TODO needs documentation. role: type: str description: - TODO needs documentation. subscription: type: str description: - TODO needs documentation. uid_ems: type: str description: - TODO needs documentation. port: type: int description: - TODO needs documentation. a - name: Create a new provider in ManageIQ ('Hawkular' metrics) community.general.manageiq_provider: name: 'EngLab' type: 'OpenShift' state: 'present' provider: auth_key: 'topSecret' hostname: 'example.com' port: 8443 validate_certs: true security_protocol: 'ssl-with-validation-custom-ca' certificate_authority: | -----BEGIN CERTIFICATE----- FAKECERTsdKgAwI... -----END CERTIFICATE----- metrics: auth_key: 'topSecret' role: 'hawkular' hostname: 'example.com' port: 443 validate_certs: true security_protocol: 'ssl-with-validation-custom-ca' certificate_authority: | -----BEGIN CERTIFICATE----- FAKECERTsdKgAwI... -----END CERTIFICATE----- manageiq_connection: url: 'https://127.0.0.1:80' username: 'admin' password: 'password' validate_certs: true - name: Update an existing provider named 'EngLab' (defaults to 'Prometheus' metrics) community.general.manageiq_provider: name: 'EngLab' type: 'Openshift' state: 'present' provider: auth_key: 'topSecret' hostname: 'next.example.com' port: 8443 validate_certs: true security_protocol: 'ssl-with-validation-custom-ca' certificate_authority: | -----BEGIN CERTIFICATE----- FAKECERTsdKgAwI... -----END CERTIFICATE----- metrics: auth_key: 'topSecret' hostname: 'next.example.com' port: 443 validate_certs: true security_protocol: 'ssl-with-validation-custom-ca' certificate_authority: | -----BEGIN CERTIFICATE----- FAKECERTsdKgAwI... -----END CERTIFICATE----- manageiq_connection: url: 'https://127.0.0.1' username: 'admin' password: 'password' validate_certs: true - name: Delete a provider in ManageIQ community.general.manageiq_provider: name: 'EngLab' type: 'Openshift' state: 'absent' manageiq_connection: url: 'https://127.0.0.1' username: 'admin' password: 'password' validate_certs: true - name: Create a new Amazon provider in ManageIQ using token authentication community.general.manageiq_provider: name: 'EngAmazon' type: 'Amazon' state: 'present' provider: hostname: 'amazon.example.com' userid: 'hello' password: 'world' manageiq_connection: url: 'https://127.0.0.1' token: 'VeryLongToken' validate_certs: true - name: Create a new oVirt provider in ManageIQ community.general.manageiq_provider: name: 'RHEV' type: 'oVirt' state: 'present' provider: hostname: 'rhev01.example.com' userid: 'admin@internal' password: 'password' validate_certs: true certificate_authority: | -----BEGIN CERTIFICATE----- FAKECERTsdKgAwI... -----END CERTIFICATE----- metrics: hostname: 'metrics.example.com' path: 'ovirt_engine_history' userid: 'user_id_metrics' password: 'password_metrics' validate_certs: true certificate_authority: | -----BEGIN CERTIFICATE----- FAKECERTsdKgAwI... -----END CERTIFICATE----- manageiq_connection: url: 'https://127.0.0.1' username: 'admin' password: 'password' validate_certs: true - name: Create a new VMware provider in ManageIQ community.general.manageiq_provider: name: 'EngVMware' type: 'VMware' state: 'present' provider: hostname: 'vcenter.example.com' host_default_vnc_port_start: 5800 host_default_vnc_port_end: 5801 userid: 'root' password: 'password' manageiq_connection: url: 'https://127.0.0.1' token: 'VeryLongToken' validate_certs: true - name: Create a new Azure provider in ManageIQ community.general.manageiq_provider: name: 'EngAzure' type: 'Azure' provider_region: 'northeurope' subscription: 'e272bd74-f661-484f-b223-88dd128a4049' azure_tenant_id: 'e272bd74-f661-484f-b223-88dd128a4048' state: 'present' provider: hostname: 'azure.example.com' userid: 'e272bd74-f661-484f-b223-88dd128a4049' password: 'password' manageiq_connection: url: 'https://cf-6af0.rhpds.opentlc.com' username: 'admin' password: 'password' validate_certs: true - name: Create a new OpenStack Director provider in ManageIQ with rsa keypair community.general.manageiq_provider: name: 'EngDirector' type: 'Director' api_version: 'v3' state: 'present' provider: hostname: 'director.example.com' userid: 'admin' password: 'password' security_protocol: 'ssl-with-validation' validate_certs: 'true' certificate_authority: | -----BEGIN CERTIFICATE----- FAKECERTsdKgAwI... -----END CERTIFICATE----- ssh_keypair: hostname: director.example.com userid: heat-admin auth_key: 'SecretSSHPrivateKey' - name: Create a new OpenStack provider in ManageIQ with amqp metrics community.general.manageiq_provider: name: 'EngOpenStack' type: 'OpenStack' api_version: 'v3' state: 'present' provider_region: 'europe' tenant_mapping_enabled: 'False' keystone_v3_domain_id: 'mydomain' provider: hostname: 'openstack.example.com' userid: 'admin' password: 'password' security_protocol: 'ssl-with-validation' validate_certs: 'true' certificate_authority: | -----BEGIN CERTIFICATE----- FAKECERTsdKgAwI... -----END CERTIFICATE----- metrics: role: amqp hostname: 'amqp.example.com' security_protocol: 'non-ssl' port: 5666 userid: admin password: password - name: Create a new GCE provider in ManageIQ community.general.manageiq_provider: name: 'EngGoogle' type: 'GCE' provider_region: 'europe-west1' project: 'project1' state: 'present' provider: hostname: 'gce.example.com' auth_key: 'google_json_key' validate_certs: 'false'  ) AnsibleModule)ManageIQmanageiq_argument_specc ttdddddtdtd dd td td tddtdtdS)Nz0ManageIQ::Providers::Openshift::ContainerManagerbearerdefault prometheusprometheus_alerts) class_nameauthtype default_role metrics_role alerts_rolez)ManageIQ::Providers::Amazon::CloudManager)rz)ManageIQ::Providers::Redhat::InfraManagermetrics)rrrz)ManageIQ::Providers::Vmware::InfraManagerz(ManageIQ::Providers::Azure::CloudManagerz,ManageIQ::Providers::Openstack::InfraManager ssh_keypair)rssh_keypair_rolez,ManageIQ::Providers::Openstack::CloudManagerz)ManageIQ::Providers::Google::CloudManager) OpenshiftAmazonoVirtVMwareAzureDirector OpenStackGCEdictw/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/general/plugins/modules/manageiq_provider.pysupported_providersr$s I"%+  B B"" B A E* E  B ;  r"c ttdttdttdttdtdS)Nr )typeoptionsF)r&r'no_log)providerralertsr)r endpoint_argument_specr!r"r#endpoint_list_specr,)sI 6+A+CD&*@*BC)?)ABf.D.FuU  r"c(tttdtdtdddgttgd ttd td td ttt S) NTrequiredint)r&bool verify_ssl)r r&aliases)zssl-with-validationzssl-with-validation-custom-cazssl-without-validationznon-sslchoices)r() rolehostnameportvalidate_certscertificate_authoritysecurity_protocoluseridpasswordauth_key subscriptionprojectuid_emspathrr!r"r#r+r+2sr  Vt$ u Dv ~N"f vT"T"& V) r"ct|tr|Dcgc] }t|c}St|tr0|j Dcic]\}}| |t|c}}S|Scc}wcc}}w)zP Remove null entries from a hash Returns: a hash without nulls ) isinstancelist delete_nullsr items)hikvs r#rFrFKsb !T)*+A Q++!T/0wwyJtq!AM<?"JJ H ,JsA, A1A1cFeZdZdZdZdZdZdZdZdZ dZ d Z d Z y ) ManageIQProviderzK Object to execute provider management operations in manageiq. c||_|jj|_|jj|_|jj|_y)N)manageiqmoduleapi_urlclient)selfrOs r#__init__zManageIQProvider.__init__^s<  mm** }},, mm** r"ctjDcgc]\}}|d|k(s|}}}t|dk(r|dSycc}}w)zK Convert class_name to type Returns: the type rrN)r$rGlen)rSrrJrKouts r#class_name_to_typez#ManageIQProvider.class_name_to_typeesP 1288:\TQa oQ[>[q\\ s8q=q6M ]s AAc|jjd|}|s|jjd|z|dS)z Search for zone id by zone name. Returns: the zone id, or send a module Fail signal if zone not found. zonesnamez"zone %s does not exist in manageiqmsgid)rOfind_collection_resource_byrP fail_json)rSr]zones r#zone_idzManageIQProvider.zone_idqsL }}88t8L KK ! !8DA " CDzr"c<|jjd|S)zx Search for provider object by name. Returns: the provider, or None if provider not found. providersr\)rOra)rSr]s r#r)zManageIQProvider.provider~s }}8848PPr"c g}tj}tj|i}|jd}|jd}|D]}|j|}|s|jdxs|j|dzd} | dk(r|jdxs| } n| } |j | |jd|jdd d g|jd d |jd |jd|jdd| |jd|jd|jdxs|dd|S)z Build "connection_configurations" objects from requested endpoints provided by user Returns: the user requested provider endpoints list r)r>r6_roler rr7r8rrVr9Tr;r:rB)r6r7r8r2r;r:rBr<r=)rr<r=r>)endpointauthentication)r,keysr$getappend) rS provider_type endpointsconnection_configurations endpoint_keysprovider_defaultsridefault_auth_key endpoint_keyr6rs r#build_connection_configurationsz0ManageIQProvider.build_connection_configurationssk%'!*,113 /155mRH==,#<< 3* L }}\2H||F+g/@/D/D\T[E[]f/g9$044Z@HDH#H*00 $$,LL$< ( V 4'(!fX\\:JD-Q&R-5\\:M-N19>U1V ( V 4!%-"*,,x"8$,LL$<$,LL$<$P@P '2 :)(r"c  |jd|d}|jj|d}td d  S#t$r8}|jj d|ddt |Yd }~Ld }~wwxYw) z| Deletes a provider from manageiq. Returns: a short message describing the operation executed. /providers/r`deleteactionzfailed to delete provider r]: r^NTmessagechangedr_rQrRpost ExceptionrPrbstrr )rSr)urlresultes r#delete_providerz ManageIQProvider.delete_providers  g'+||Xd^DC[[%%c(%;FDfY&788 g KK ! !HU[L\^abc^d&e ! f f gs1A B .A??Bc b|jd|d}t|d|i||||| | | | |  }t|} |jj |d|}td d |dd S#t $r8}|j jd|ddt| Yd }~Rd }~wwxYw)zy Edit a provider from manageiq. Returns: a short message describing the operation executed. rwr`) r]rcprovider_regionrphost_default_vnc_port_starthost_default_vnc_port_endr?r@rAtenant_mapping_enabled api_versionedit)rzresourcezfailed to update provider r]r{r^NTz"successfully updated the provider r}) rQr rFrRrrrPrbr)rSr)r]rnrordrrrr?r@rArrrrrrs r# edit_providerzManageIQProvider.edit_providers$(<<$@+&/(C&?%#9#  * ) g[[%%c&8%LF>Fv>NPVWY Y g KK ! !HU[L\^abc^d&e ! f f gsA-- B.6.B))B.c pt|d|i||||| | | | | } t| } d|jz}|jj|fdt |di| }td d |dd  S#t $r5}|jjd|dt|Yd }~Od }~wwxYw)z| Creates the provider in manageiq. Returns: a short message describing the operation executed. r`) r]rcrrrr?r@rArrrpz %s/providersr&rzfailed to create provider r{r^NTz"successfully created the provider resultsr}) r rFrQrRrr$rrPrbr)rSr]rnrordrrrr?r@rArrrrrrs r#create_providerz ManageIQProvider.create_providers+(C&?%#9#&/   ) [ DLL1C%T[[%%co0C0Em0TUa0bofnoF>BF9DUVX X [ KK ! !DRUVWRX&Y ! Z Z [s?#E?$. $2499;< = M/12+-. # i* . i& *,+,G H F == D f%IMM&)MMMMmm$56O"(--0M"N & .I J==0Lmm-.GmmI&G#]]+CD-- .K MM' "EH(2 ))$/H  (88BH=FHH   '// :G M-@@&AQRM  $ $ . .> / @  3 5 : : < <  $ $ . .7=I / K   Z ()II-YfgI (66x}V_ahjy7RTm7CWgWmoz|H )88}iY`bq9TVo9EwPWYoq|~H   (004@H=FHHF x r"__main__N) __future__rrrr& __metaclass__ DOCUMENTATIONEXAMPLESRETURNansible.module_utils.basicrCansible_collections.community.general.plugins.module_utils.manageiqrr r$r,r+rFobjectrMrrr!r"r#rssA@ U nY v 5p!H2  G1vG1Tk!\ zFr"