Skip to content

Commit 7b5841d

Browse files
Previnkumar-GPrevinkumar-G
committed
Release 1.5.0
1 parent de9d780 commit 7b5841d

37 files changed

+5984
-5401
lines changed

‎.github/CODEOWNERS

Lines changed: 5 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -7,16 +7,13 @@
77
# be requested for review when someone opens a pull request.
88
# order is alphabetical for easier maintenance.
99
#
10-
# Ananthu Kuttattu (ananthu-kuttattu)
11-
# Arindam Datta (dattaarindam)
12-
# DCS Krishna (dcsk)
10+
# Ananthu Kuttattu (kuttattz)
11+
# Bhavneet Sharma (Bhavneet-Sharma)
1312
# Jennifer John (Jennifer-John)
1413
# Meenakshi Dembi (meenakshidembi691)
15-
# Panigrahi Spandita (panigs7)
1614
# Pavan Mudunuri (Pavan-Mudunuri)
17-
# Prabhulinga Revur (prabhu-dell)
18-
# Prasad Raghavendra (prasar6)
19-
# Rajendra Indukuri (rajendraindukuri)
15+
# Previnkumar G (Previnkumar-G)
16+
# Trisha Datta (trisha-dell)
2017

2118
# for all files:
22-
* @ananthu-kuttattu @dattaarindam @dcsk @Jennifer-John @meenakshidembi691 @panigs7 @Pavan-Mudunuri @prabhu-dell @prasar6 @rajendraindukuri
19+
* @kuttattz @Bhavneet-Sharma @Jennifer-John @meenakshidembi691 @Pavan-Mudunuri @Previnkumar-G @trisha-dell

‎CHANGELOG.rst

Lines changed: 146 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,146 @@
1+
===========================
2+
Dellemc.Unity Change Log
3+
===========================
4+
5+
.. contents:: Topics
6+
7+
8+
v1.5.0
9+
======
10+
11+
Minor Changes
12+
-------------
13+
14+
- Updated modules to adhere with ansible community guidelines.
15+
16+
v1.4.1
17+
======
18+
19+
Minor Changes
20+
-------------
21+
22+
- Updated the execution environment related files.
23+
24+
v1.4.0
25+
======
26+
27+
Minor Changes
28+
-------------
29+
30+
- Added cifsserver module to support create, list and delete CIFS server.
31+
- Added execution environment manifest file to support building an execution environment with ansible-builder.
32+
- Added interface module to support create, list and delete interface.
33+
- Added nfsserver module to support create, list and delete NFS server.
34+
- Check mode is supported for Info.
35+
- Enhance nfs module to support advanced host management option.
36+
- Enhanced filesystem module to support create, modify and delete of filesystem replication.
37+
- Enhanced info module to list cifs server, nfs servers, ethernet port and file interface.
38+
- Enhanced nas server module to support create, modify and delete of nas server replication.
39+
40+
New Modules
41+
-----------
42+
43+
- dellemc.unity.cifsserver - Manage CIFS server on Unity storage system
44+
- dellemc.unity.interface - Manage Interfaces on Unity storage system
45+
- dellemc.unity.nfsserver - Manage NFS server on Unity storage system
46+
47+
v1.3.0
48+
======
49+
50+
Minor Changes
51+
-------------
52+
53+
- Added rotating file handler for logging.
54+
- Bugfix in volume module to retrieve details of non-thin volumes.
55+
- Enhance host module to support add/remove network address to/from a host.
56+
- Enhanced Info module to list disk groups.
57+
- Enhanced Storage Pool module to support listing of drive details of a pool
58+
- Enhanced Storage pool module to support creation of storage pool
59+
- Enhanced consistency group module to support enable/disable replication in consistency group
60+
- Enhanced host module to support both mapping and un-mapping of non-logged-in initiators to host.
61+
- Enhanced host module to support listing of network addresses, FC initiators, ISCSI initiators and allocated volumes of a host
62+
- Removed dellemc.unity prefix from module names.
63+
- Renamed gatherfacts module to info module
64+
65+
v1.2.1
66+
======
67+
68+
Minor Changes
69+
-------------
70+
71+
- Added dual licensing
72+
- Documentation updates
73+
- Fixed typo in galaxy.yml
74+
- Updated few samples in modules
75+
76+
v1.2.0
77+
======
78+
79+
Minor Changes
80+
-------------
81+
82+
- Added CRUD operations support for Quota tree.
83+
- Added CRUD operations support for User Quota on Filesystem/Quota tree.
84+
- Added support for Application tagging.
85+
- Consistency group module is enhanced to map/unmap hosts to/from a new or existing consistency group.
86+
- Filesystem module is enhanced to associate/dissociate snapshot schedule to/from a Filesystem.
87+
- Filesystem module is enhanced to update default quota configuration during create operation.
88+
- Gather facts module is enhanced to list User Quota and Quota tree components.
89+
- Volume module is enhanced to support map/unmap multiple hosts from a volume.
90+
91+
New Modules
92+
-----------
93+
94+
- dellemc.unity.tree_quota - Manage quota tree on the Unity storage system
95+
- dellemc.unity.user_quota - Manage user quota on the Unity storage system
96+
97+
v1.1.0
98+
======
99+
100+
Minor Changes
101+
-------------
102+
103+
- Added CRUD operations support for Filesystem snapshot.
104+
- Added CRUD operations support for Filesystem.
105+
- Added CRUD operations support for NFS export.
106+
- Added CRUD operations support for SMB share.
107+
- Added support to get/modify operations on NAS server.
108+
- Gather facts module is enhanced to list Filesystem snapshots, NAS servers, File systems, NFS exports, SMB shares.
109+
110+
New Modules
111+
-----------
112+
113+
- dellemc.unity.filesystem - Manage filesystem on Unity storage system
114+
- dellemc.unity.filesystem_snapshot - Manage filesystem snapshot on the Unity storage system
115+
- dellemc.unity.nasserver - Manage NAS servers on Unity storage system
116+
- dellemc.unity.nfs - Manage NFS export on Unity storage system
117+
- dellemc.unity.smbshare - Manage SMB shares on Unity storage system
118+
119+
v1.0.0
120+
======
121+
122+
Major Changes
123+
-------------
124+
125+
- Added CRUD operations support for Consistency group.
126+
- Added CRUD operations support for Volume.
127+
- Added CRUD operations support for a snapshot schedule.
128+
- Added support for CRUD operations on a host with FC/iSCSI initiators.
129+
- Added support for CRUD operations on a snapshot of a volume.
130+
- Added support for adding/removing volumes to/from a consistency group.
131+
- Added support to add/remove FC/iSCSI initiators to/from a host.
132+
- Added support to create a snapshot for a consistency group.
133+
- Added support to get/modify operations on storage pool.
134+
- Added support to map/unmap a host to/from a snapshot.
135+
- Gather facts module is enhanced to list volumes, consistency groups, FC initiators, iSCSI initiators, hosts, snapshot schedules.
136+
137+
New Modules
138+
-----------
139+
140+
- dellemc.unity.consistencygroup - Manage consistency groups on Unity storage system
141+
- dellemc.unity.host - Manage Host operations on Unity
142+
- dellemc.unity.info - Gathering information about Unity
143+
- dellemc.unity.snapshot - Manage snapshots on the Unity storage system
144+
- dellemc.unity.snapshotschedule - Manage snapshot schedules on Unity storage system
145+
- dellemc.unity.storagepool - Manage storage pool on Unity
146+
- dellemc.unity.volume - Manage volume on Unity storage system

‎README.md

Lines changed: 37 additions & 121 deletions
Original file line numberDiff line numberDiff line change
@@ -6,150 +6,66 @@ The capabilities of the Ansible modules are managing consistency groups, filesys
66

77
## Table of contents
88

9-
* [Code of conduct](https://github.com/dell/ansible-unity/blob/1.4.1/docs/CODE_OF_CONDUCT.md)
10-
* [Maintainer guide](https://github.com/dell/ansible-unity/blob/1.4.1/docs/MAINTAINER_GUIDE.md)
11-
* [Committer guide](https://github.com/dell/ansible-unity/blob/1.4.1/docs/COMMITTER_GUIDE.md)
12-
* [Contributing guide](https://github.com/dell/ansible-unity/blob/1.4.1/docs/CONTRIBUTING.md)
13-
* [Branching strategy](https://github.com/dell/ansible-unity/blob/1.4.1/docs/BRANCHING.md)
14-
* [List of adopters](https://github.com/dell/ansible-unity/blob/1.4.1/docs/ADOPTERS.md)
15-
* [Maintainers](https://github.com/dell/ansible-unity/blob/1.4.1/docs/MAINTAINERS.md)
16-
* [Support](https://github.com/dell/ansible-unity/blob/1.4.1/docs/SUPPORT.md)
9+
* [Code of conduct](https://github.com/dell/ansible-unity/blob/1.5.0/docs/CODE_OF_CONDUCT.md)
10+
* [Maintainer guide](https://github.com/dell/ansible-unity/blob/1.5.0/docs/MAINTAINER_GUIDE.md)
11+
* [Committer guide](https://github.com/dell/ansible-unity/blob/1.5.0/docs/COMMITTER_GUIDE.md)
12+
* [Contributing guide](https://github.com/dell/ansible-unity/blob/1.5.0/docs/CONTRIBUTING.md)
13+
* [Branching strategy](https://github.com/dell/ansible-unity/blob/1.5.0/docs/BRANCHING.md)
14+
* [List of adopters](https://github.com/dell/ansible-unity/blob/1.5.0/docs/ADOPTERS.md)
15+
* [Maintainers](https://github.com/dell/ansible-unity/blob/1.5.0/docs/MAINTAINERS.md)
16+
* [Support](https://github.com/dell/ansible-unity/blob/1.5.0/docs/SUPPORT.md)
1717
* [License](#license)
18-
* [Security](https://github.com/dell/ansible-unity/blob/1.4.1/docs/SECURITY.md)
18+
* [Security](https://github.com/dell/ansible-unity/blob/1.5.0/docs/SECURITY.md)
1919
* [Prerequisites](#prerequisites)
2020
* [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)
2222
* [Releasing, Maintenance and Deprecation](#releasing-maintenance-and-deprecation)
2323

2424
## 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.
2926

3027
## Supported Platforms
3128
* Dell Unity Arrays version 5.1, 5.2
3229

3330
## Prerequisites
3431
This table provides information about the software prerequisites for the Ansible Modules for Dell Unity.
3532

36-
| **Ansible Modules** | **Red Hat Enterprise Linux** | **Python version** | **Storops - Python SDK version** | **Ansible** |
37-
|---------------------|------------------------------|--------------------|----------------------------|-------------|
38-
| v1.4.1 | 8.4 <br> 8.5| 3.8 <br> 3.9 <br> 3.10 | 1.2.11 | 2.11 <br> 2.12 <br> 2.13|
33+
| **Ansible Modules** | **Python version** | **Storops - Python SDK version** | **Ansible** |
34+
|---------------------|--------------------|----------------------------------|-------------|
35+
| v1.5.0 | 3.9 <br> 3.10 <br> 3.11 | 1.2.11 | 2.12 <br> 2.13 <br> 2.14|
3936

4037
## Idempotency
4138
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.
4239

4340
## 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)
45-
* [Filesystem module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#file-system-module)
46-
* [Filesystem snapshot module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#filesystem-snapshot-module)
47-
* [Info module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#info-module)
48-
* [Host module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#host-module)
49-
* [CIFS server module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#cifs-server-module)
50-
* [NAS server module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#nas-server-module)
51-
* [NFS server module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#nfs-server-module)
52-
* [NFS export module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md##nfs-module)
53-
* [SMB share module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#smb-share-module)
54-
* [Interface module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#interface-module)
55-
* [Snapshot module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#snapshot-module)
56-
* [Snapshot schedule module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#snapshot-schedule-module)
57-
* [Storage pool module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#storage-pool-module)
58-
* [User quota module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#user-quota-module)
59-
* [Quota tree module ](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#quota-tree-module)
60-
* [Volume module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#volume-module)
61-
62-
## Installation of SDK
63-
* 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:
77-
78-
ansible-galaxy collection install dellemc.unity -p <install_path>
79-
80-
#### Offline Installation of Collections
81-
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:
82-
83-
ansible-galaxy collection install dellemc-unity-1.4.1.tar.gz -p <install_path>
84-
85-
2. Set the environment variable:
86-
87-
export ANSIBLE_COLLECTIONS_PATHS=$ANSIBLE_COLLECTIONS_PATHS:<install_path>
88-
89-
90-
## Using Collections
91-
92-
* 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:
115-
116-
export REQUESTS_CA_BUNDLE=/etc/pki/ca-trust/source/anchors/<<Certificate_Name>>
117-
* 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:
135-
136-
ansible-builder build --tag <tag_name> --container-runtime docker
137-
* After the image is built, run the container using:
138-
139-
docker run -it <tag_name> /bin/bash
140-
* Verify collection installation using command:
141-
142-
ansible-galaxy collection list
143-
* The playbook can be run on the container using:
144-
145-
docker run --rm -v $(pwd):/runner <tag_name> ansible-playbook info_tests.yml
41+
* [Consistency group module](https://github.com/dell/ansible-unity/blob/1.5.0/docs/Product%20Guide.md#consistency-group-module)
42+
* [Filesystem module](https://github.com/dell/ansible-unity/blob/1.5.0/docs/Product%20Guide.md#file-system-module)
43+
* [Filesystem snapshot module](https://github.com/dell/ansible-unity/blob/1.5.0/docs/Product%20Guide.md#filesystem-snapshot-module)
44+
* [Info module](https://github.com/dell/ansible-unity/blob/1.5.0/docs/Product%20Guide.md#info-module)
45+
* [Host module](https://github.com/dell/ansible-unity/blob/1.5.0/docs/Product%20Guide.md#host-module)
46+
* [CIFS server module](https://github.com/dell/ansible-unity/blob/1.5.0/docs/Product%20Guide.md#cifs-server-module)
47+
* [NAS server module](https://github.com/dell/ansible-unity/blob/1.5.0/docs/Product%20Guide.md#nas-server-module)
48+
* [NFS server module](https://github.com/dell/ansible-unity/blob/1.5.0/docs/Product%20Guide.md#nfs-server-module)
49+
* [NFS export module](https://github.com/dell/ansible-unity/blob/1.5.0/docs/Product%20Guide.md##nfs-module)
50+
* [SMB share module](https://github.com/dell/ansible-unity/blob/1.5.0/docs/Product%20Guide.md#smb-share-module)
51+
* [Interface module](https://github.com/dell/ansible-unity/blob/1.5.0/docs/Product%20Guide.md#interface-module)
52+
* [Snapshot module](https://github.com/dell/ansible-unity/blob/1.5.0/docs/Product%20Guide.md#snapshot-module)
53+
* [Snapshot schedule module](https://github.com/dell/ansible-unity/blob/1.5.0/docs/Product%20Guide.md#snapshot-schedule-module)
54+
* [Storage pool module](https://github.com/dell/ansible-unity/blob/1.5.0/docs/Product%20Guide.md#storage-pool-module)
55+
* [User quota module](https://github.com/dell/ansible-unity/blob/1.5.0/docs/Product%20Guide.md#user-quota-module)
56+
* [Quota tree module ](https://github.com/dell/ansible-unity/blob/1.5.0/docs/Product%20Guide.md#quota-tree-module)
57+
* [Volume module](https://github.com/dell/ansible-unity/blob/1.5.0/docs/Product%20Guide.md#volume-module)
58+
59+
## 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).
14662

14763
## Releasing, Maintenance and Deprecation
14864

14965
Ansible Modules for Dell Technnologies Unity follows [Semantic Versioning](https://semver.org/).
15066

15167
New version will be release regularly if significant changes (bug fix or new feature) are made in the collection.
15268

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).
15470

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

Comments
 (0)