1
0
Fork 0
mirror of https://github.com/ansible-collections/community.general.git synced 2024-09-14 20:13:21 +02:00
community.general/docs/docsite/rst/dev_guide
Bojan Vitnik b0cc240665 New module: xenserver_guest - manages XenServer VMs (#41041)
* XenServer related modules - initial commit

 - New module_util: xenserver. Contains common module arguments, functions
   and classes useful for future XenServer related modules.
 - New module_docs_fragment: xenserver. Describes common module arguments.
 - New module: xenserver_guest. Supports VM deployment, reconfiguration,
   removal, detection of changes, state management, fact gathering and
   Ansible check mode. Module is fully documented.
 - Updated: developing_module_utilities.rst.
 - Module params, workflow and some functions are based on or taken from
   vmware_guest module.

* Implemented support for configuring custom VM params in xenserver_guest module

* Compatibility fixes and documentation update

 - xenserver module_util: implemented support for XenAPI.py version older
   than 7.2.
 - xenserver module_util: PEP8 fixes.
 - xenserver module_util: Added missing imports.
 - xenserver module_util: Copyright notice fixes.
 - xenserver_guest module: updated module documentation with notes regarding
   module requirements and compatibility.
 - xenserver_guest module: bumped version_added to 2.7.
 - xenserver_guest module: minor fixes.

* VM power state management refactoring, subargument specs in xenserver_guest module, other fixes

 - VM power state management code moved from xenserver_guest module to xenserver
   module_util (set_vm_power_state function).
 - Code for waiting for VM IP address moved from xenserver_guest module to
   xenserver module_util (wait_for_vm_ip_address function).
 - xenserver module_util: implemented get_object_ref function to clean up
   a lot of repeated code in xenserver_guest module.
 - xenserver module_util: added additional aliases 'host' and 'pool' for
   'hostname' common module argument. They are more in line with what
   XenServer users are familiar with.
 - xenserver module_util: minor fixes.
 - xenserver_guest module: removed VM state management other than 'present',
   'absent' and 'poweredon'. Other states are to be managed by separate module.
 - xenserver_guest module: added subargument specs and cleaned up custom code
   for subargument validation.
 - xenserver_guest module: reorganized code for disk and network reconfiguation
   to minimize code duplication.
 - xenserver_guest module: renamed 'cdrom.iso' module argument to
   'cdrom.iso_name', avoids cryptic error message when parameter is
   missing.
 - xenserver_guest module: documentation update.
 - xenserver_guest module: changes in error messages.
 - xenserver_guest module: minor fixes.

* Implemented guest OS network parameter configuration and other

 - xenserver module_util: moved code for validating MAC addresses from
   xenserver_guest module and implemented a range of functions for validating
   IP addresses and related entities and converting prefixes to netmasks and
   vice versa.
 - xenserver module_util: updated fact gathering code to support guest OS
   network parameters.
 - xenserver module_util: added docstrings.
 - xenserver module_util: minor changes.
 - xenserver_guest module: implemented support for guest OS network parameter
   configuration.
 - xenserver_guest module: changed CD-ROM handling code.
 - xenserver_guest module: changed so that user friendly version of changes
   list is always returned in module result.
 - xenserver_guest module: error message changes.
 - xenserver_guest module: added docstrings.
 - xenserver_guest module: documentation update.
 - xenserver_guest module: minor changes and fixes.

* Various fixes and code cleanup

 - xenserver module_util: implemented get_xenserver_version function.
 - xenserver module_util: moved customization agent detection code to
   gather_vm_params function. customization_agent variable is now part of
   vm_params. An exception in customization agent detection code that prevented
   deployment of new VMs is also fixed.
 - xenserver module_util: added support for alternative VM state names with
   dash and underscore in set_power_state function.
 - xenserver_guest module: removed customization agent detection code
   as it is now implemented in xenserver module_util.
 - xenserver_guest module: fixed a bug in xenserver_data update code that
   occured when "networks.mac" was not specified in module params and
   other fixes.
 - xenserver_guest module: some code cleanup.
 - xenserver_guest module: bumped version_added to 2.8.
2018-11-19 01:50:20 -05:00
..
shared_snippets rewrite of the developer guide, part 1 (#45179) 2018-09-07 08:57:36 -05:00
style_guide Add docs about contributing to docs (#46481) 2018-10-24 11:14:01 -04:00
testing/sanity Support skip of platforms by version in tests. (#48826) 2018-11-16 16:38:47 -08:00
debugging.rst adds stub API docs in a single file (#46663) 2018-10-11 10:15:24 -04:00
developing_api.rst Fix spelling (#47692) 2018-10-28 15:55:41 -05:00
developing_core.rst rewrite of the developer guide, part 1 (#45179) 2018-09-07 08:57:36 -05:00
developing_inventory.rst add more consistent extension matching for inventory plugins (#46786) 2018-10-11 11:06:52 -05:00
developing_locally.rst Fixing typo in developing_locally.rst (#48535) 2018-11-12 08:21:58 +01:00
developing_module_utilities.rst New module: xenserver_guest - manages XenServer VMs (#41041) 2018-11-19 01:50:20 -05:00
developing_modules.rst rewrite of the developer guide, part 1 (#45179) 2018-09-07 08:57:36 -05:00
developing_modules_best_practices.rst Tidy up Contributors Docs (#47619) 2018-10-28 17:11:40 -05:00
developing_modules_checklist.rst Tidy up Contributors Docs (#47619) 2018-10-28 17:11:40 -05:00
developing_modules_documenting.rst Add docs about contributing to docs (#46481) 2018-10-24 11:14:01 -04:00
developing_modules_general.rst Add docs about contributing to docs (#46481) 2018-10-24 11:14:01 -04:00
developing_modules_general_aci.rst Update developing_modules_general_aci.rst 2018-09-21 23:52:51 +02:00
developing_modules_general_windows.rst Added basic equivalent to PowerShell modules (#44705) 2018-11-07 10:53:17 +10:00
developing_modules_in_groups.rst rewrite of the developer guide, part 1 (#45179) 2018-09-07 08:57:36 -05:00
developing_plugins.rst rewrite of the developer guide, part 1 (#45179) 2018-09-07 08:57:36 -05:00
developing_program_flow_modules.rst rewrite of the developer guide, part 1 (#45179) 2018-09-07 08:57:36 -05:00
developing_python_3.rst adds stub API docs in a single file (#46663) 2018-10-11 10:15:24 -04:00
developing_rebasing.rst rewrite of the developer guide, part 1 (#45179) 2018-09-07 08:57:36 -05:00
index.rst Restore license agreement (#45809) 2018-09-18 14:47:22 -05:00
Makefile consolidated docs 2017-01-06 09:16:59 -05:00
module_lifecycle.rst rewrite of the developer guide, part 1 (#45179) 2018-09-07 08:57:36 -05:00
overview_architecture.rst rewrite of the developer guide, part 1 (#45179) 2018-09-07 08:57:36 -05:00
testing.rst rewrite of the developer guide, part 1 (#45179) 2018-09-07 08:57:36 -05:00
testing_compile.rst Remove more docs build errors (#45364) 2018-09-11 17:51:47 +01:00
testing_documentation.rst Add docs about contributing to docs (#46481) 2018-10-24 11:14:01 -04:00
testing_httptester.rst Remove more docs build errors (#45364) 2018-09-11 17:51:47 +01:00
testing_integration.rst restores legacy testing file (#46095) 2018-09-25 08:52:47 -04:00
testing_integration_legacy.rst restores legacy testing file (#46095) 2018-09-25 08:52:47 -04:00
testing_pep8.rst Remove more docs build errors (#45364) 2018-09-11 17:51:47 +01:00
testing_running_locally.rst Remove more docs build errors (#45364) 2018-09-11 17:51:47 +01:00
testing_sanity.rst Remove more docs build errors (#45364) 2018-09-11 17:51:47 +01:00
testing_units.rst Remove more docs build errors (#45364) 2018-09-11 17:51:47 +01:00
testing_units_modules.rst Remove more docs build errors (#45364) 2018-09-11 17:51:47 +01:00
testing_validate-modules.rst Remove more docs build errors (#45364) 2018-09-11 17:51:47 +01:00