mirror of
				https://github.com/ansible-collections/community.general.git
				synced 2025-10-26 05:50:36 -07:00 
			
		
		
		
	
		
			Some checks are pending
		
		
	
	EOL CI / EOL Sanity (Ⓐ2.17) (push) Waiting to run
				
			EOL CI / EOL Units (Ⓐ2.17+py3.10) (push) Waiting to run
				
			EOL CI / EOL Units (Ⓐ2.17+py3.12) (push) Waiting to run
				
			EOL CI / EOL Units (Ⓐ2.17+py3.7) (push) Waiting to run
				
			EOL CI / EOL I (Ⓐ2.17+alpine319+py:azp/posix/1/) (push) Waiting to run
				
			EOL CI / EOL I (Ⓐ2.17+alpine319+py:azp/posix/2/) (push) Waiting to run
				
			EOL CI / EOL I (Ⓐ2.17+alpine319+py:azp/posix/3/) (push) Waiting to run
				
			EOL CI / EOL I (Ⓐ2.17+fedora39+py:azp/posix/1/) (push) Waiting to run
				
			EOL CI / EOL I (Ⓐ2.17+fedora39+py:azp/posix/2/) (push) Waiting to run
				
			EOL CI / EOL I (Ⓐ2.17+fedora39+py:azp/posix/3/) (push) Waiting to run
				
			EOL CI / EOL I (Ⓐ2.17+ubuntu2004+py:azp/posix/1/) (push) Waiting to run
				
			EOL CI / EOL I (Ⓐ2.17+ubuntu2004+py:azp/posix/2/) (push) Waiting to run
				
			EOL CI / EOL I (Ⓐ2.17+ubuntu2004+py:azp/posix/3/) (push) Waiting to run
				
			nox / Run extra sanity tests (push) Waiting to run
				
			* Adjust all __future__ imports: for i in $(grep -REl "__future__.*absolute_import" plugins/ tests/); do sed -e 's/from __future__ import .*/from __future__ import annotations/g' -i $i; done * Remove all UTF-8 encoding specifications for Python source files: for i in $(grep -REl '[-][*]- coding: utf-8 -[*]-' plugins/ tests/); do sed -e '/^# -\*- coding: utf-8 -\*-/d' -i $i; done * Remove __metaclass__ = type: for i in $(grep -REl '__metaclass__ = type' plugins/ tests/); do sed -e '/^__metaclass__ = type/d' -i $i; done
		
			
				
	
	
		
			124 lines
		
	
	
	
		
			3.1 KiB
		
	
	
	
		
			Python
		
	
	
	
	
	
			
		
		
	
	
			124 lines
		
	
	
	
		
			3.1 KiB
		
	
	
	
		
			Python
		
	
	
	
	
	
| #!/usr/bin/python
 | |
| 
 | |
| # Copyright (C) 2018 IBM CORPORATION
 | |
| # Author(s): Tzur Eliyahu <tzure@il.ibm.com>
 | |
| #
 | |
| # GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt)
 | |
| # SPDX-License-Identifier: GPL-3.0-or-later
 | |
| 
 | |
| from __future__ import annotations
 | |
| 
 | |
| DOCUMENTATION = r"""
 | |
| module: ibm_sa_host
 | |
| short_description: Adds hosts to or removes them from IBM Spectrum Accelerate Family storage systems
 | |
| 
 | |
| description:
 | |
|   - This module adds hosts to or removes them from IBM Spectrum Accelerate Family storage systems.
 | |
| attributes:
 | |
|   check_mode:
 | |
|     support: none
 | |
|   diff_mode:
 | |
|     support: none
 | |
| 
 | |
| options:
 | |
|   host:
 | |
|     description:
 | |
|       - Host name.
 | |
|     required: true
 | |
|     type: str
 | |
|   state:
 | |
|     description:
 | |
|       - Host state.
 | |
|     default: "present"
 | |
|     choices: ["present", "absent"]
 | |
|     type: str
 | |
|   cluster:
 | |
|     description:
 | |
|       - The name of the cluster to include the host.
 | |
|     required: false
 | |
|     type: str
 | |
|   domain:
 | |
|     description:
 | |
|       - The domains the cluster is attached to. To include more than one domain, separate domain names with commas. To include
 | |
|         all existing domains, use an asterisk (V(*)).
 | |
|     required: false
 | |
|     type: str
 | |
|   iscsi_chap_name:
 | |
|     description:
 | |
|       - The host's CHAP name identifier.
 | |
|     required: false
 | |
|     type: str
 | |
|   iscsi_chap_secret:
 | |
|     description:
 | |
|       - The password of the initiator used to authenticate to the system when CHAP is enable.
 | |
|     required: false
 | |
|     type: str
 | |
| 
 | |
| extends_documentation_fragment:
 | |
|   - community.general.ibm_storage
 | |
|   - community.general.attributes
 | |
| 
 | |
| author:
 | |
|   - Tzur Eliyahu (@tzure)
 | |
| """
 | |
| 
 | |
| EXAMPLES = r"""
 | |
| - name: Define new host.
 | |
|   community.general.ibm_sa_host:
 | |
|     host: host_name
 | |
|     state: present
 | |
|     username: admin
 | |
|     password: secret
 | |
|     endpoints: hostdev-system
 | |
| 
 | |
| - name: Delete host.
 | |
|   community.general.ibm_sa_host:
 | |
|     host: host_name
 | |
|     state: absent
 | |
|     username: admin
 | |
|     password: secret
 | |
|     endpoints: hostdev-system
 | |
| """
 | |
| RETURN = r"""
 | |
| """
 | |
| 
 | |
| from ansible.module_utils.basic import AnsibleModule
 | |
| from ansible_collections.community.general.plugins.module_utils.ibm_sa_utils import execute_pyxcli_command, \
 | |
|     connect_ssl, spectrum_accelerate_spec, is_pyxcli_installed
 | |
| 
 | |
| 
 | |
| def main():
 | |
|     argument_spec = spectrum_accelerate_spec()
 | |
|     argument_spec.update(
 | |
|         dict(
 | |
|             state=dict(default='present', choices=['present', 'absent']),
 | |
|             host=dict(required=True),
 | |
|             cluster=dict(),
 | |
|             domain=dict(),
 | |
|             iscsi_chap_name=dict(),
 | |
|             iscsi_chap_secret=dict(no_log=True),
 | |
|         )
 | |
|     )
 | |
| 
 | |
|     module = AnsibleModule(argument_spec)
 | |
| 
 | |
|     is_pyxcli_installed(module)
 | |
| 
 | |
|     xcli_client = connect_ssl(module)
 | |
|     host = xcli_client.cmd.host_list(
 | |
|         host=module.params['host']).as_single_element
 | |
|     state = module.params['state']
 | |
| 
 | |
|     state_changed = False
 | |
|     if state == 'present' and not host:
 | |
|         state_changed = execute_pyxcli_command(
 | |
|             module, 'host_define', xcli_client)
 | |
|     elif state == 'absent' and host:
 | |
|         state_changed = execute_pyxcli_command(
 | |
|             module, 'host_delete', xcli_client)
 | |
| 
 | |
|     module.exit_json(changed=state_changed)
 | |
| 
 | |
| 
 | |
| if __name__ == '__main__':
 | |
|     main()
 |