You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
*[List of Ansible modules for Dell Unity](#list-of-ansible-modules-for-dell-unity)
21
-
*[Installation](#installing-collections)
21
+
*[Installation and execution of Ansible modules for Dell Unity](#installation-and-execution-of-ansible-modules-for-dell-unity)
22
22
*[Releasing, Maintenance and Deprecation](#releasing-maintenance-and-deprecation)
23
23
24
24
## License
25
-
The Ansible collection for Unity is released and licensed under the GPL-3.0 license. See [LICENSE](https://github.com/dell/ansible-unity/blob/1.4.1/LICENSE) for the full terms. Ansible modules and module utilities that are part of the Ansible collection for Unity are released and licensed under the Apache 2.0 license. See [MODULE-LICENSE](https://github.com/dell/ansible-unity/blob/1.4.1/MODULE-LICENSE) for the full terms.
26
-
27
-
## Support
28
-
The Ansible collection for Unity is supported by Dell and is provided under the terms of the license attached to the collection. Please see the [LICENSE](#license) section for the full terms. Dell does not provide any support for the source code modifications. For any Ansible modules issues, questions or feedback, join the [Dell Automation Community](https://www.dell.com/community/Automation/bd-p/Automation).
25
+
The Ansible collection for Unity is released and licensed under the GPL-3.0 license. See [LICENSE](https://github.com/dell/ansible-unity/blob/1.5.0/LICENSE) for the full terms. Ansible modules and module utilities that are part of the Ansible collection for Unity are released and licensed under the Apache 2.0 license. See [MODULE-LICENSE](https://github.com/dell/ansible-unity/blob/1.5.0/MODULE-LICENSE) for the full terms.
29
26
30
27
## Supported Platforms
31
28
* Dell Unity Arrays version 5.1, 5.2
32
29
33
30
## Prerequisites
34
31
This table provides information about the software prerequisites for the Ansible Modules for Dell Unity.
35
32
36
-
|**Ansible Modules**|**Red Hat Enterprise Linux**|**Python version**|**Storops - Python SDK version**|**Ansible**|
The modules are written in such a way that all requests are idempotent and hence fault-tolerant. It essentially means that the result of a successfully performed request is independent of the number of times it is executed.
42
39
43
40
## List of Ansible Modules for Dell Unity
44
-
*[Consistency group module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#consistency-group-module)
* Install python sdk named 'storops'. It can be installed using pip, based on appropriate python version.
64
-
65
-
pip install storops
66
-
67
-
## Building Collections
68
-
* Use this command to build the collection from source code:
69
-
70
-
ansible-galaxy collection build
71
-
72
-
For more details on how to build a tar ball, please refer: [Building the collection](https://docs.ansible.com/ansible/latest/dev_guide/developing_collections_distributing.html#building-your-collection-tarball)
73
-
74
-
## Installing Collections
75
-
#### Online Installation of Collections
76
-
1. Use the following command to install the latest collection hosted in galaxy:
1. Download the latest tar build from any of the available distribution channel [Ansible Galaxy](https://galaxy.ansible.com/dellemc/unity) /[Automation Hub](https://console.redhat.com/ansible/automation-hub/repo/published/dellemc/unity) and use the following command to install the collection anywhere in your system:
* In order to use any Ansible module, ensure that the importing of proper FQCN (Fully Qualified Collection Name) must be embedded in the playbook.
93
-
Refer to the following example:
94
-
95
-
collections:
96
-
- dellemc.unity
97
-
98
-
* In order to use an installed collection specific to the task use a proper FQCN (Fully Qualified Collection Name). Refer to the following example:
99
-
100
-
tasks:
101
-
- name: Get Volume details
102
-
dellemc.unity.volume
103
-
104
-
* For generating Ansible documentation for a specific module, embed the FQCN before the module name. Refer to the following example:
105
-
106
-
ansible-doc dellemc.unity.info
107
-
108
-
## Running Ansible Modules
109
-
The Ansible server must be configured with Python library for Unity to run the Ansible playbooks. The [Documents](https://github.com/dell/ansible-unity/tree/1.4.1/docs) provide information on different Ansible modules along with their functions and syntax. The parameters table in the Product Guide provides information on various parameters which need to be configured before running the modules.
110
-
111
-
## SSL Certificate Validation
112
-
113
-
* Copy the CA certificate to the "/etc/pki/ca-trust/source/anchors" path of the host by any external means.
114
-
* Set the "REQUESTS_CA_BUNDLE" environment variable to the path of the SSL certificate using the command:
* Import the SSL certificate to host using the command:
118
-
119
-
update-ca-trust extract
120
-
* If "TLS CA certificate bundle error" occurs, then follow these steps:
121
-
122
-
cd /etc/pki/tls/certs/
123
-
openssl x509 -in ca-bundle.crt -text -noout
124
-
125
-
## Results
126
-
Each module returns the updated state and details of the entity. For example, if you are using the Volume module, all calls will return the updated details of the volume. Sample result is shown in each module's documentation.
127
-
128
-
## Ansible Execution Environment
129
-
130
-
Ansible can also be installed in a container environment. Ansible Builder provides the ability to create reproducible, self-contained environments as container images that can be run as Ansible execution environments.
131
-
* Install the ansible builder package using:
132
-
133
-
pip3 install ansible-builder
134
-
* Ensure the execution-environment.yml is at the root of collection and create the execution environment using:
## Installation and execution of Ansible modules for Dell Unity
60
+
61
+
The installation and execution steps of Ansible modules for Dell Unity can be found [here](https://github.com/dell/ansible-unity/blob/1.5.0/docs/INSTALLATION.md).
146
62
147
63
## Releasing, Maintenance and Deprecation
148
64
149
65
Ansible Modules for Dell Technnologies Unity follows [Semantic Versioning](https://semver.org/).
150
66
151
67
New version will be release regularly if significant changes (bug fix or new feature) are made in the collection.
152
68
153
-
Released code versions are located on "release" branches with names of the form "release-x.y.z" where x.y.z corresponds to the version number. More information on branching strategy followed can be found [here](https://github.com/dell/ansible-unity/blob/1.4.1/docs/BRANCHING.md).
69
+
Released code versions are located on "release" branches with names of the form "release-x.y.z" where x.y.z corresponds to the version number. More information on branching strategy followed can be found [here](https://github.com/dell/ansible-unity/blob/1.5.0/docs/BRANCHING.md).
154
70
155
-
Ansible Modules for Dell Technologies Unity deprecation cycle is aligned with that of [Ansible](https://docs.ansible.com/ansible/latest/dev_guide/module_lifecycle.html).
71
+
Ansible Modules for Dell Technologies Unity deprecation cycle is aligned with that of [Ansible](https://docs.ansible.com/ansible/latest/dev_guide/module_lifecycle.html).
0 commit comments