Skip to content

Commit

Permalink
Merge pull request #22 from dell/RTSv1.4.1
Browse files Browse the repository at this point in the history
Release version 1.4.1
  • Loading branch information
Jennifer-John authored Sep 22, 2022
2 parents 3f5334f + e1724e3 commit 6e435cb
Show file tree
Hide file tree
Showing 25 changed files with 59 additions and 63 deletions.
4 changes: 4 additions & 0 deletions ChangeLog.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,8 @@
# ansible-unity Change Log

## Version 1.4.1 - released on 27/09/22
- Updated the execution environment related files.

## Version 1.4.0 - released on 28/06/22
- Added execution environment manifest file to support building an execution environment with ansible-builder.
- Added cifsserver module to support create, list and delete CIFS server.
Expand Down
44 changes: 22 additions & 22 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ The Ansible Modules for Dell Technologies (Dell) Unity allow Data Center and IT
The capabilities of the Ansible modules are managing consistency groups, filesystem, filesystem snapshots, CIFS server, NAS server, NFS server, NFS export, SMB share, interface, hosts, snapshots, snapshot schedules, storage pools, user quotas, quota trees and volumes. Capabilities also include gathering facts from the array. The options available for each are list, show, create, modify and delete. These tasks can be executed by running simple playbooks written in yaml syntax. The modules are written so that all the operations are idempotent, so making multiple identical requests has the same effect as making a single request.

## License
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.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.4.0/MODULE-LICENSE) for the full terms.
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.

## Support
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).
Expand All @@ -18,29 +18,29 @@ This table provides information about the software prerequisites for the Ansible

| **Ansible Modules** | **Red Hat Enterprise Linux** | **Python version** | **Python library version** | **Ansible** |
|---------------------|------------------------------|--------------------|----------------------------|-------------|
| v1.4.0 | 8.4 <br> 8.5| 3.8 <br> 3.9 <br> 3.10 | 1.2.11 | 2.11 <br> 2.12 <br> 2.13|
| 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|

## Idempotency
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.

## List of Ansible Modules for Dell Unity
* [Consistency group module](https://github.com/dell/ansible-unity/blob/1.4.0/docs/Product%20Guide.md#consistency-group-module)
* [Filesystem module](https://github.com/dell/ansible-unity/blob/1.4.0/docs/Product%20Guide.md#file-system-module)
* [Filesystem snapshot module](https://github.com/dell/ansible-unity/blob/1.4.0/docs/Product%20Guide.md#filesystem-snapshot-module)
* [Info module](https://github.com/dell/ansible-unity/blob/1.4.0/docs/Product%20Guide.md#info-module)
* [Host module](https://github.com/dell/ansible-unity/blob/1.4.0/docs/Product%20Guide.md#host-module)
* [CIFS server module](https://github.com/dell/ansible-unity/blob/1.4.0/docs/Product%20Guide.md#cifs-server-module)
* [NAS server module](https://github.com/dell/ansible-unity/blob/1.4.0/docs/Product%20Guide.md#nas-server-module)
* [NFS server module](https://github.com/dell/ansible-unity/blob/1.4.0/docs/Product%20Guide.md#nfs-server-module)
* [NFS export module](https://github.com/dell/ansible-unity/blob/1.4.0/docs/Product%20Guide.md##nfs-module)
* [SMB share module](https://github.com/dell/ansible-unity/blob/1.4.0/docs/Product%20Guide.md#smb-share-module)
* [Interface module](https://github.com/dell/ansible-unity/blob/1.4.0/docs/Product%20Guide.md#interface-module)
* [Snapshot module](https://github.com/dell/ansible-unity/blob/1.4.0/docs/Product%20Guide.md#snapshot-module)
* [Snapshot schedule module](https://github.com/dell/ansible-unity/blob/1.4.0/docs/Product%20Guide.md#snapshot-schedule-module)
* [Storage pool module](https://github.com/dell/ansible-unity/blob/1.4.0/docs/Product%20Guide.md#storage-pool-module)
* [User quota module](https://github.com/dell/ansible-unity/blob/1.4.0/docs/Product%20Guide.md#user-quota-module)
* [Quota tree module ](https://github.com/dell/ansible-unity/blob/1.4.0/docs/Product%20Guide.md#quota-tree-module)
* [Volume module](https://github.com/dell/ansible-unity/blob/1.4.0/docs/Product%20Guide.md#volume-module)
* [Consistency group module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#consistency-group-module)
* [Filesystem module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#file-system-module)
* [Filesystem snapshot module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#filesystem-snapshot-module)
* [Info module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#info-module)
* [Host module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#host-module)
* [CIFS server module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#cifs-server-module)
* [NAS server module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#nas-server-module)
* [NFS server module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#nfs-server-module)
* [NFS export module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md##nfs-module)
* [SMB share module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#smb-share-module)
* [Interface module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#interface-module)
* [Snapshot module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#snapshot-module)
* [Snapshot schedule module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#snapshot-schedule-module)
* [Storage pool module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#storage-pool-module)
* [User quota module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#user-quota-module)
* [Quota tree module ](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#quota-tree-module)
* [Volume module](https://github.com/dell/ansible-unity/blob/1.4.1/docs/Product%20Guide.md#volume-module)

## Installation of SDK
* Install python sdk named 'storops'. It can be installed using pip, based on appropriate python version.
Expand All @@ -63,7 +63,7 @@ The modules are written in such a way that all requests are idempotent and hence
#### Offline Installation of Collections
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:

ansible-galaxy collection install dellemc-unity-1.4.0.tar.gz -p <install_path>
ansible-galaxy collection install dellemc-unity-1.4.1.tar.gz -p <install_path>

2. Set the environment variable:

Expand All @@ -89,7 +89,7 @@ The modules are written in such a way that all requests are idempotent and hence
ansible-doc dellemc.unity.info

## Running Ansible Modules
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.0/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.
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.

## SSL Certificate Validation

Expand All @@ -114,7 +114,7 @@ Ansible can also be installed in a container environment. Ansible Builder provid
* Install the ansible builder package using:

pip3 install ansible-builder
* Create the execution environment using:
* Ensure the execution-environment.yml is at the root of collection and create the execution environment using:

ansible-builder build --tag <tag_name> --container-runtime docker
* After the image is built, run the container using:
Expand Down
2 changes: 1 addition & 1 deletion docs/Product Guide.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# Ansible Modules for Dell Technologies Unity
## Product Guide 1.4.0
## Product Guide 1.4.1
© 2022 Dell Inc. or its subsidiaries. All rights reserved. Dell and other trademarks are trademarks of Dell Inc. or its subsidiaries. Other trademarks may be trademarks of their respective owners.

--------------
Expand Down
20 changes: 6 additions & 14 deletions docs/Release Notes.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
**Ansible Modules for Dell Technologies Unity**
=========================================
### Release Notes 1.4.0
### Release Notes 1.4.1

> © 2022 Dell Inc. or its subsidiaries. All rights reserved. Dell
> and other trademarks are trademarks of Dell Inc. or its
Expand All @@ -26,9 +26,9 @@ The table in this section lists the revision history of this document.

Table 1. Revision history

| Revision | Date | Description |
|----------|-----------|-----------------------------------------------------------|
| 01 | June 2022 | Current release of Ansible Modules for Dell Unity 1.4.0 |
| Revision | Date | Description |
|----------|----------------|---------------------------------------------------------|
| 01 | September 2022 | Current release of Ansible Modules for Dell Unity 1.4.1 |

Product Description
-------------------
Expand All @@ -38,15 +38,7 @@ New features & enhancements
---------------------------
This release has the following changes -

- Added execution environment manifest file to support building an execution environment with ansible-builder.
- Added cifsserver module to support create, list and delete CIFS server.
- Added nfsserver module to support create, list and delete NFS server.
- Added interface module to support create, list and delete interface.
- Enhance nfs module to support advanced host management option.
- Enhanced info module to list cifs server, nfs servers, ethernet port and file interface.
- Enhanced nas server module to support create, modify and delete of nas server replication.
- Enhanced filesystem module to support create, modify and delete of filesystem replication.
- Check mode is supported for Info.
- Updated the execution environment related files.

Known issues
------------
Expand Down Expand Up @@ -77,7 +69,7 @@ for Unity GitHub](https://github.com/dell/ansible-unity/) page.

Documentation
-------------
The documentation is available on [Ansible Modules for Unity GitHub](https://github.com/dell/ansible-unity/tree/1.4.0/docs)
The documentation is available on [Ansible Modules for Unity GitHub](https://github.com/dell/ansible-unity/tree/1.4.1/docs)
page. It includes the following:
- README
- Release Notes (this document)
Expand Down
8 changes: 4 additions & 4 deletions galaxy.yml
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ namespace: dellemc
name: unity

# The version of the collection. Must be compatible with semantic versioning
version: 1.4.0
version: 1.4.1

# The path to the Markdown (.md) readme file. This path is relative to the root of the collection
readme: README.md
Expand Down Expand Up @@ -47,13 +47,13 @@ tags: [storage]
dependencies: {}

# The URL of the originating SCM repository
repository: https://github.com/dell/ansible-unity/tree/1.4.0
repository: https://github.com/dell/ansible-unity/tree/1.4.1

# The URL to any online docs
documentation: https://github.com/dell/ansible-unity/tree/1.4.0/docs
documentation: https://github.com/dell/ansible-unity/tree/1.4.1/docs

# The URL to the homepage of the collection/project
homepage: https://github.com/dell/ansible-unity/tree/1.4.0
homepage: https://github.com/dell/ansible-unity/tree/1.4.1

# The URL to the collection issue tracker
issues: https://www.dell.com/community/Automation/bd-p/Automation
Expand Down
4 changes: 2 additions & 2 deletions meta/execution-environment.yml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
version: 1
dependencies:
galaxy: ../requirements.yml
python: ../requirements.txt
galaxy: requirements.yml
python: requirements.txt
2 changes: 1 addition & 1 deletion plugins/modules/cifsserver.py
Original file line number Diff line number Diff line change
Expand Up @@ -280,7 +280,7 @@

UNITY_SDK_VERSION_CHECK = utils.storops_version_check()

application_type = "Ansible/1.4.0"
application_type = "Ansible/1.4.1"


class CIFSServer(object):
Expand Down
2 changes: 1 addition & 1 deletion plugins/modules/consistencygroup.py
Original file line number Diff line number Diff line change
Expand Up @@ -454,7 +454,7 @@

UNITY_SDK_VERSION_CHECK = utils.storops_version_check()

application_type = "Ansible/1.4.0"
application_type = "Ansible/1.4.1"


class ConsistencyGroup(object):
Expand Down
2 changes: 1 addition & 1 deletion plugins/modules/filesystem.py
Original file line number Diff line number Diff line change
Expand Up @@ -715,7 +715,7 @@

UNITY_SDK_VERSION_CHECK = utils.storops_version_check()

application_type = "Ansible/1.4.0"
application_type = "Ansible/1.4.1"


class Filesystem(object):
Expand Down
2 changes: 1 addition & 1 deletion plugins/modules/filesystem_snapshot.py
Original file line number Diff line number Diff line change
Expand Up @@ -271,7 +271,7 @@
HAS_UNITY_SDK = utils.get_unity_sdk()
UNITY_SDK_VERSION_CHECK = utils.storops_version_check()

application_type = "Ansible/1.4.0"
application_type = "Ansible/1.4.1"


class FilesystemSnapshot(object):
Expand Down
2 changes: 1 addition & 1 deletion plugins/modules/host.py
Original file line number Diff line number Diff line change
Expand Up @@ -285,7 +285,7 @@
HAS_UNITY_SDK = utils.get_unity_sdk()
UNITY_SDK_VERSION_CHECK = utils.storops_version_check()

application_type = "Ansible/1.4.0"
application_type = "Ansible/1.4.1"


class Host(object):
Expand Down
2 changes: 1 addition & 1 deletion plugins/modules/info.py
Original file line number Diff line number Diff line change
Expand Up @@ -598,7 +598,7 @@
HAS_UNITY_SDK = utils.get_unity_sdk()
UNITY_SDK_VERSION_CHECK = utils.storops_version_check()

application_type = "Ansible/1.4.0"
application_type = "Ansible/1.4.1"


class Info(object):
Expand Down
2 changes: 1 addition & 1 deletion plugins/modules/interface.py
Original file line number Diff line number Diff line change
Expand Up @@ -231,7 +231,7 @@

UNITY_SDK_VERSION_CHECK = utils.storops_version_check()

application_type = "Ansible/1.4.0"
application_type = "Ansible/1.4.1"


class Interface(object):
Expand Down
2 changes: 1 addition & 1 deletion plugins/modules/nasserver.py
Original file line number Diff line number Diff line change
Expand Up @@ -483,7 +483,7 @@
HAS_UNITY_SDK = utils.get_unity_sdk()
UNITY_SDK_VERSION_CHECK = utils.storops_version_check()

application_type = "Ansible/1.4.0"
application_type = "Ansible/1.4.1"


class NASServer(object):
Expand Down
2 changes: 1 addition & 1 deletion plugins/modules/nfs.py
Original file line number Diff line number Diff line change
Expand Up @@ -659,7 +659,7 @@
HOST_STATE_LIST = ['present-in-export', 'absent-in-export']
STATE_LIST = ['present', 'absent']

application_type = "Ansible/1.4.0"
application_type = "Ansible/1.4.1"


class NFS(object):
Expand Down
2 changes: 1 addition & 1 deletion plugins/modules/nfsserver.py
Original file line number Diff line number Diff line change
Expand Up @@ -213,7 +213,7 @@

UNITY_SDK_VERSION_CHECK = utils.storops_version_check()

application_type = "Ansible/1.4.0"
application_type = "Ansible/1.4.1"


class NFSServer(object):
Expand Down
2 changes: 1 addition & 1 deletion plugins/modules/smbshare.py
Original file line number Diff line number Diff line change
Expand Up @@ -292,7 +292,7 @@
HAS_UNITY_SDK = utils.get_unity_sdk()
UNITY_SDK_VERSION_CHECK = utils.storops_version_check()

application_type = "Ansible/1.4.0"
application_type = "Ansible/1.4.1"


class SMBShare(object):
Expand Down
2 changes: 1 addition & 1 deletion plugins/modules/snapshot.py
Original file line number Diff line number Diff line change
Expand Up @@ -233,7 +233,7 @@
HAS_UNITY_SDK = utils.get_unity_sdk()
UNITY_SDK_VERSION_CHECK = utils.storops_version_check()

application_type = "Ansible/1.4.0"
application_type = "Ansible/1.4.1"


class Snapshot(object):
Expand Down
2 changes: 1 addition & 1 deletion plugins/modules/snapshotschedule.py
Original file line number Diff line number Diff line change
Expand Up @@ -359,7 +359,7 @@

UNITY_SDK_VERSION_CHECK = utils.storops_version_check()

application_type = "Ansible/1.4.0"
application_type = "Ansible/1.4.1"


class SnapshotSchedule(object):
Expand Down
2 changes: 1 addition & 1 deletion plugins/modules/storagepool.py
Original file line number Diff line number Diff line change
Expand Up @@ -317,7 +317,7 @@
UNITY_SDK_VERSION_CHECK = UNITY_SDK_VERSION['supported_version']
UNITY_SDK_VERSION_ERROR = UNITY_SDK_VERSION['unsupported_version_message']

application_type = "Ansible/1.4.0"
application_type = "Ansible/1.4.1"


class StoragePool(object):
Expand Down
2 changes: 1 addition & 1 deletion plugins/modules/tree_quota.py
Original file line number Diff line number Diff line change
Expand Up @@ -259,7 +259,7 @@

UNITY_SDK_VERSION_CHECK = utils.storops_version_check()

application_type = "Ansible/1.4.0"
application_type = "Ansible/1.4.1"


class QuotaTree(object):
Expand Down
2 changes: 1 addition & 1 deletion plugins/modules/user_quota.py
Original file line number Diff line number Diff line change
Expand Up @@ -399,7 +399,7 @@

UNITY_SDK_VERSION_CHECK = utils.storops_version_check()

application_type = "Ansible/1.4.0"
application_type = "Ansible/1.4.1"


class UserQuota(object):
Expand Down
2 changes: 1 addition & 1 deletion plugins/modules/volume.py
Original file line number Diff line number Diff line change
Expand Up @@ -315,7 +315,7 @@

UNITY_SDK_VERSION_CHECK = utils.storops_version_check()

application_type = "Ansible/1.4.0"
application_type = "Ansible/1.4.1"


def is_none_or_empty_string(param):
Expand Down
2 changes: 1 addition & 1 deletion tests/sanity/ignore-2.13.txt
Original file line number Diff line number Diff line change
Expand Up @@ -16,4 +16,4 @@ plugins/modules/cifsserver.py validate-modules:missing-gplv3-license
plugins/modules/nfsserver.py validate-modules:missing-gplv3-license
plugins/modules/host.py import-2.7
plugins/modules/interface.py import-2.7
plugins/modules/interface.py validate-modules:missing-gplv3-license
plugins/modules/interface.py validate-modules:missing-gplv3-license
4 changes: 2 additions & 2 deletions tests/unit/plugins/modules/test_nfs.py
Original file line number Diff line number Diff line change
Expand Up @@ -131,7 +131,7 @@ def test_host_access_nfs_share_subnet_negative(self, nfs_module_mock):
'nfs_export_name': "nfsshare_dummy_name",
'filesystem_id': "fs_id_1",
'adv_host_mgmt_enabled': False,
'read_only_root_hosts': [{'subnet': "10.255.2.1"}],
'read_only_root_hosts': [{'subnet': "1x.x.x.x"}],
'host_state': 'present-in-export',
'state': 'present'
})
Expand All @@ -147,7 +147,7 @@ def test_host_access_nfs_share_advhostmngmt_negative(self, nfs_module_mock):
self.get_module_args.update({
'nfs_export_name': "nfsshare_dummy_name",
'filesystem_id': "fs_id_1",
'read_only_root_hosts': [{'subnet': "10.255.2.1/10"}],
'read_only_root_hosts': [{'subnet': "1x.x.x.x/10"}],
'host_state': 'present-in-export',
'state': 'present'
})
Expand Down

0 comments on commit 6e435cb

Please sign in to comment.