#!/usr/bin/python # Copyright: (c) 2023, Adora Laura Kalb # GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt) from __future__ import (absolute_import, division, print_function) __metaclass__ = type DOCUMENTATION = r''' --- module: build_axfr_list short_description: builds list of IPs for AXFR allow list # If this is part of a collection, you need to use semantic versioning, # i.e. the version is of the form "2.5.0" and not "2.4". version_added: "0.0.1" description: This is my longer description explaining my test module. options: key: description: This is the dictionary key to use for building the list. required: true type: str group: description: This is the user group that we use to get the relevant hosts. required: true type: str # Specify this value according to your collection # in format of namespace.collection.doc_fragment_name # extends_documentation_fragment: # - my_namespace.my_collection.my_doc_fragment_name author: - Adora Kalb (@lauralani) ''' EXAMPLES = r''' # Pass in a message - name: Test with a message my_namespace.my_collection.my_test: name: hello world # pass in a message and have changed true - name: Test with a message and changed output my_namespace.my_collection.my_test: name: hello world new: true # fail the module - name: Test failure of the module my_namespace.my_collection.my_test: name: fail me ''' RETURN = r''' # These are examples of possible return values, and in general should use other names for return values. original_message: description: The original name param that was passed in. type: str returned: always sample: 'hello world' message: description: The output message that the test module generates. type: str returned: always sample: 'goodbye' ''' from ansible.module_utils.basic import AnsibleModule def run_module(): # define available arguments/parameters a user can pass to the module module_args = dict( key=dict(type='str', required=True), group=dict(type='str', required=True), hostvars=dict(type='dict', required=True), hosts=dict(type='list', required=True) ) # seed the result dict in the object # we primarily care about changed and state # changed is if this module effectively modified the target # state will include any data that you want your module to pass back # for consumption, for example, in a subsequent task result = dict( changed=False, axfr_list=[] ) # the AnsibleModule object will be our abstraction working with Ansible # this includes instantiation, a couple of common attr would be the # args/params passed to the execution, as well as if the module # supports check mode module = AnsibleModule( argument_spec=module_args, supports_check_mode=False # TODO ) # if the user is working with this module in only check mode we do not # want to make any changes to the environment, just return the current # state with no modifications # TODO #if module.check_mode: # module.exit_json(**result) # manipulate or modify the state as needed (this is going to be the # part where your module will do what it needs to do) host_ips = [] for hostname in module.params['hosts']: axfr_ip = module.params['hostvars'][hostname][module.params['key']] host_ips.append(axfr_ip) result['axfr_list'] = host_ips # in the event of a successful module execution, you will want to # simple AnsibleModule.exit_json(), passing the key/value results module.exit_json(**result) def main(): run_module() if __name__ == '__main__': main()