Skip to content

Commit df89e82

Browse files
Merge pull request #49 from kuttattz/main
Release v2.0.0
2 parents 6b84f9b + 38c9525 commit df89e82

32 files changed

+1097
-1099
lines changed

.github/workflows/ansible-test.yml

+52-65
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,8 @@ name: CI
22

33
on:
44
push:
5-
branches: [ main ]
5+
branches: [main]
66
pull_request:
7-
branches: [ main ]
87
schedule:
98
- cron: '0 3 * * *'
109

@@ -15,15 +14,15 @@ jobs:
1514
strategy:
1615
fail-fast: false
1716
matrix:
18-
ansible-version: [stable-2.13]
17+
ansible-version: [stable-2.14, stable-2.15, stable-2.16, devel]
1918
steps:
2019
- name: Check out code
21-
uses: actions/checkout@v2
20+
uses: actions/checkout@v3
2221

23-
- name: Set up Python 3.9
24-
uses: actions/setup-python@v1
22+
- name: Set up Python 3.11
23+
uses: actions/setup-python@v4
2524
with:
26-
python-version: 3.9
25+
python-version: 3.11
2726

2827
- name: Install ansible (${{ matrix.ansible-version }})
2928
run: pip install https://github.com/ansible/ansible/archive/${{ matrix.ansible-version }}.tar.gz --disable-pip-version-check
@@ -39,86 +38,68 @@ jobs:
3938

4039
###
4140
# Unit tests (OPTIONAL)
42-
#
41+
#
4342
# https://docs.ansible.com/ansible/latest/dev_guide/testing_units.html
4443

4544
unit:
46-
name: Unit Tests
45+
name: Unit Tests (Ⓐ${{ matrix.ansible }} with ${{ matrix.python }} python)
4746
needs: [build]
4847
runs-on: ubuntu-latest
4948
strategy:
5049
fail-fast: false
5150
matrix:
52-
python-version: ["3.9", "3.10", "3.11"]
53-
ansible-version: [stable-2.13, stable-2.14, stable-2.15]
51+
python: ['3.9', '3.10', '3.11']
52+
ansible:
53+
- stable-2.14
54+
- stable-2.15
55+
- stable-2.16
56+
- devel
5457
exclude:
55-
# Python 3.11 is supported only from ansible-core 2.14 onwards
56-
- python-version: "3.11"
57-
ansible-version: stable-2.13
58+
- ansible: stable-2.16
59+
python: '3.9'
60+
- ansible: devel
61+
python: '3.9'
5862

5963
steps:
60-
- name: Set up Python ${{ matrix.python-version }}
61-
uses: actions/setup-python@v1
64+
- name: Perform unit testing with ansible-test
65+
uses: ansible-community/ansible-test-gh-action@release/v1
6266
with:
63-
python-version: ${{ matrix.python-version }}
64-
65-
- name: Install ansible (${{ matrix.ansible-version }}) version
66-
run: pip install https://github.com/ansible/ansible/archive/${{ matrix.ansible-version }}.tar.gz --disable-pip-version-check
67-
68-
- name: Download migrated collection artifacts
69-
uses: actions/download-artifact@v1
70-
with:
71-
name: collection
72-
path: .cache/collection-tarballs
73-
74-
- name: Setup Unit test Pre-requisites
75-
run: |
76-
ansible-galaxy collection install .cache/collection-tarballs/*.tar.gz
77-
if [ -f /home/runner/.ansible/collections/ansible_collections/dellemc/unity/tests/requirements.txt ]; then pip install -r /home/runner/.ansible/collections/ansible_collections/dellemc/unity/tests/requirements.txt; fi
78-
- name: Run Unit tests using ansible-test
79-
run: ansible-test units -v --color --python ${{ matrix.python-version }} --coverage
80-
working-directory: /home/runner/.ansible/collections/ansible_collections/dellemc/unity
67+
testing-type: units
68+
coverage: always
69+
ansible-core-version: ${{ matrix.ansible }}
70+
target-python-version: ${{ matrix.python }}
8171

8272
###
8373
# Sanity tests (REQUIRED)
8474
#
8575
# https://docs.ansible.com/ansible/latest/dev_guide/testing_sanity.html
8676

8777
sanity:
88-
name: Sanity Tests
89-
runs-on: ubuntu-latest
78+
name: Sanity (Ⓐ${{ matrix.ansible }} with ${{ matrix.python }} python)
9079
needs: [build]
9180
strategy:
92-
fail-fast: false
9381
matrix:
94-
ansible-version: [stable-2.13, stable-2.14, stable-2.15]
95-
82+
python: ['3.9', '3.10', '3.11']
83+
ansible:
84+
- stable-2.14
85+
- stable-2.15
86+
- stable-2.16
87+
- devel
88+
exclude:
89+
- ansible: stable-2.16
90+
python: '3.9'
91+
- ansible: devel
92+
python: '3.9'
93+
runs-on: ubuntu-latest
9694
steps:
97-
- name: Set up Python 3.9
98-
uses: actions/setup-python@v1
99-
with:
100-
# it is just required to run that once as "ansible-test sanity" in the docker image
101-
# will run on all python versions it supports.
102-
python-version: 3.9
103-
104-
- name: Install ansible (${{ matrix.ansible-version }}) version
105-
run: pip install https://github.com/ansible/ansible/archive/${{ matrix.ansible-version }}.tar.gz --disable-pip-version-check
106-
107-
- name: Download migrated collection artifacts
108-
uses: actions/download-artifact@v1
95+
- name: Perform sanity testing
96+
uses: ansible-community/ansible-test-gh-action@release/v1
10997
with:
110-
name: collection
111-
path: .cache/collection-tarballs
112-
113-
- name: Setup Sanity test Pre-requisites
114-
run: ansible-galaxy collection install .cache/collection-tarballs/*.tar.gz
115-
116-
# run ansible-test sanity inside of Docker.
117-
# The docker container has all the pinned dependencies that are required
118-
# and all python versions ansible supports.
119-
- name: Run sanity tests
120-
run: ansible-test sanity --docker -v --color
121-
working-directory: /home/runner/.ansible/collections/ansible_collections/dellemc/unity
98+
ansible-core-version: ${{ matrix.ansible }}
99+
target-python-version: ${{ matrix.python }}
100+
testing-type: sanity
101+
pull-request-change-detection: true
102+
coverage: never
122103

123104
lint:
124105
name: Ansible lint
@@ -128,7 +109,13 @@ jobs:
128109
fail-fast: false
129110
matrix:
130111
python-version: ["3.9", "3.10", "3.11"]
131-
ansible-version: [stable-2.13, stable-2.14, stable-2.15]
112+
ansible-version: [stable-2.14, stable-2.15, stable-2.16, devel]
113+
exclude:
114+
# Ansible-core 2.16 is supported only from Python 3.10 onwards
115+
- python-version: "3.9"
116+
ansible-version: stable-2.16
117+
- python-version: '3.9'
118+
ansible-version: devel
132119

133120
steps:
134121
# Important: This sets up your GITHUB_WORKSPACE environment variable
@@ -138,7 +125,7 @@ jobs:
138125
fetch-depth: 0 # needed for progressive mode to work
139126

140127
- name: Set up Python ${{ matrix.python-version }}
141-
uses: actions/setup-python@v1
128+
uses: actions/setup-python@v4
142129
with:
143130
python-version: ${{ matrix.python-version }}
144131

CHANGELOG.rst

+8
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,14 @@ Dellemc.Unity Change Log
55
.. contents:: Topics
66

77

8+
v2.0.0
9+
======
10+
11+
Major Changes
12+
-------------
13+
14+
- Adding support for Unity Puffin v5.4.
15+
816
v1.7.1
917
======
1018

README.md

+32-32
Original file line numberDiff line numberDiff line change
@@ -6,67 +6,67 @@ 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.7.1/docs/CODE_OF_CONDUCT.md)
10-
* [Maintainer guide](https://github.com/dell/ansible-unity/blob/1.7.1/docs/MAINTAINER_GUIDE.md)
11-
* [Committer guide](https://github.com/dell/ansible-unity/blob/1.7.1/docs/COMMITTER_GUIDE.md)
12-
* [Contributing guide](https://github.com/dell/ansible-unity/blob/1.7.1/docs/CONTRIBUTING.md)
13-
* [Branching strategy](https://github.com/dell/ansible-unity/blob/1.7.1/docs/BRANCHING.md)
14-
* [List of adopters](https://github.com/dell/ansible-unity/blob/1.7.1/docs/ADOPTERS.md)
15-
* [Maintainers](https://github.com/dell/ansible-unity/blob/1.7.1/docs/MAINTAINERS.md)
16-
* [Support](https://github.com/dell/ansible-unity/blob/1.7.1/docs/SUPPORT.md)
9+
* [Code of conduct](https://github.com/dell/ansible-unity/blob/2.0.0/docs/CODE_OF_CONDUCT.md)
10+
* [Maintainer guide](https://github.com/dell/ansible-unity/blob/2.0.0/docs/MAINTAINER_GUIDE.md)
11+
* [Committer guide](https://github.com/dell/ansible-unity/blob/2.0.0/docs/COMMITTER_GUIDE.md)
12+
* [Contributing guide](https://github.com/dell/ansible-unity/blob/2.0.0/docs/CONTRIBUTING.md)
13+
* [Branching strategy](https://github.com/dell/ansible-unity/blob/2.0.0/docs/BRANCHING.md)
14+
* [List of adopters](https://github.com/dell/ansible-unity/blob/2.0.0/docs/ADOPTERS.md)
15+
* [Maintainers](https://github.com/dell/ansible-unity/blob/2.0.0/docs/MAINTAINERS.md)
16+
* [Support](https://github.com/dell/ansible-unity/blob/2.0.0/docs/SUPPORT.md)
1717
* [License](#license)
18-
* [Security](https://github.com/dell/ansible-unity/blob/1.7.1/docs/SECURITY.md)
18+
* [Security](https://github.com/dell/ansible-unity/blob/2.0.0/docs/SECURITY.md)
1919
* [Prerequisites](#prerequisites)
2020
* [List of Ansible modules for Dell Unity](#list-of-ansible-modules-for-dell-unity)
2121
* [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.7.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.7.1/MODULE-LICENSE) for the full terms.
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/2.0.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/2.0.0/MODULE-LICENSE) for the full terms.
2626

2727
## Supported Platforms
28-
* Dell Unity Arrays version 5.1, 5.2, 5.3
28+
* Dell Unity Arrays version 5.2, 5.3, 5.4
2929

3030
## Prerequisites
3131
This table provides information about the software prerequisites for the Ansible Modules for Dell Unity.
3232

3333
| **Ansible Modules** | **Python version** | **Storops - Python SDK version** | **Ansible** |
3434
|---------------------|--------------------|----------------------------------|-------------|
35-
| v1.7.1 | 3.9 <br> 3.10 <br> 3.11 | 1.2.11 | 2.13 <br> 2.14 <br> 2.15|
35+
| v2.0.0 | 3.9 <br> 3.10 <br> 3.11 | 1.2.11 | 2.14 <br> 2.15 <br> 2.16|
3636

3737
## Idempotency
3838
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.
3939

4040
## List of Ansible Modules for Dell Unity
41-
* [Consistency group module](https://github.com/dell/ansible-unity/blob/1.7.1/docs/modules/consistencygroup.rst)
42-
* [Filesystem module](https://github.com/dell/ansible-unity/blob/1.7.1/docs/modules/filesystem.rst)
43-
* [Filesystem snapshot module](https://github.com/dell/ansible-unity/blob/1.7.1/docs/modules/filesystem_snapshot.rst)
44-
* [Info module](https://github.com/dell/ansible-unity/blob/1.7.1/docs/modules/info.rst)
45-
* [Host module](https://github.com/dell/ansible-unity/blob/1.7.1/docs/modules/host.rst)
46-
* [CIFS server module](https://github.com/dell/ansible-unity/blob/1.7.1/docs/modules/cifsserver.rst)
47-
* [NAS server module](https://github.com/dell/ansible-unity/blob/1.7.1/docs/modules/nasserver.rst)
48-
* [NFS server module](https://github.com/dell/ansible-unity/blob/1.7.1/docs/modules/nfsserver.rst)
49-
* [NFS export module](https://github.com/dell/ansible-unity/blob/1.7.1/docs/modules/nfs.rst)
50-
* [SMB share module](https://github.com/dell/ansible-unity/blob/1.7.1/docs/modules/smbshare.rst)
51-
* [Interface module](https://github.com/dell/ansible-unity/blob/1.7.1/docs/modules/interface.rst)
52-
* [Snapshot module](https://github.com/dell/ansible-unity/blob/1.7.1/docs/modules/snapshot.rst)
53-
* [Snapshot schedule module](https://github.com/dell/ansible-unity/blob/1.7.1/docs/modules/snapshotschedule.rst)
54-
* [Storage pool module](https://github.com/dell/ansible-unity/blob/1.7.1/docs/modules/storagepool.rst)
55-
* [User quota module](https://github.com/dell/ansible-unity/blob/1.7.1/docs/modules/user_quota.rste)
56-
* [Quota tree module ](https://github.com/dell/ansible-unity/blob/1.7.1/docs/modules/tree_quota.rst)
57-
* [Volume module](https://github.com/dell/ansible-unity/blob/1.7.1/docs/modules/volume.rst)
58-
* [Replication session module](https://github.com/dell/ansible-unity/blob/1.7.1/docs/modules/replication_session.rst)
41+
* [Consistency group module](https://github.com/dell/ansible-unity/blob/2.0.0/docs/modules/consistencygroup.rst)
42+
* [Filesystem module](https://github.com/dell/ansible-unity/blob/2.0.0/docs/modules/filesystem.rst)
43+
* [Filesystem snapshot module](https://github.com/dell/ansible-unity/blob/2.0.0/docs/modules/filesystem_snapshot.rst)
44+
* [Info module](https://github.com/dell/ansible-unity/blob/2.0.0/docs/modules/info.rst)
45+
* [Host module](https://github.com/dell/ansible-unity/blob/2.0.0/docs/modules/host.rst)
46+
* [CIFS server module](https://github.com/dell/ansible-unity/blob/2.0.0/docs/modules/cifsserver.rst)
47+
* [NAS server module](https://github.com/dell/ansible-unity/blob/2.0.0/docs/modules/nasserver.rst)
48+
* [NFS server module](https://github.com/dell/ansible-unity/blob/2.0.0/docs/modules/nfsserver.rst)
49+
* [NFS export module](https://github.com/dell/ansible-unity/blob/2.0.0/docs/modules/nfs.rst)
50+
* [SMB share module](https://github.com/dell/ansible-unity/blob/2.0.0/docs/modules/smbshare.rst)
51+
* [Interface module](https://github.com/dell/ansible-unity/blob/2.0.0/docs/modules/interface.rst)
52+
* [Snapshot module](https://github.com/dell/ansible-unity/blob/2.0.0/docs/modules/snapshot.rst)
53+
* [Snapshot schedule module](https://github.com/dell/ansible-unity/blob/2.0.0/docs/modules/snapshotschedule.rst)
54+
* [Storage pool module](https://github.com/dell/ansible-unity/blob/2.0.0/docs/modules/storagepool.rst)
55+
* [User quota module](https://github.com/dell/ansible-unity/blob/2.0.0/docs/modules/user_quota.rste)
56+
* [Quota tree module ](https://github.com/dell/ansible-unity/blob/2.0.0/docs/modules/tree_quota.rst)
57+
* [Volume module](https://github.com/dell/ansible-unity/blob/2.0.0/docs/modules/volume.rst)
58+
* [Replication session module](https://github.com/dell/ansible-unity/blob/2.0.0/docs/modules/replication_session.rst)
5959

6060
## Installation and execution of Ansible modules for Dell Unity
6161

62-
The installation and execution steps of Ansible modules for Dell Unity can be found [here](https://github.com/dell/ansible-unity/blob/1.7.1/docs/INSTALLATION.md).
62+
The installation and execution steps of Ansible modules for Dell Unity can be found [here](https://github.com/dell/ansible-unity/blob/2.0.0/docs/INSTALLATION.md).
6363

6464
## Releasing, Maintenance and Deprecation
6565

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

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

70-
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.7.1/docs/BRANCHING.md).
70+
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/2.0.0/docs/BRANCHING.md).
7171

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

changelogs/.plugin-cache.yaml

+1-1
Original file line numberDiff line numberDiff line change
@@ -106,4 +106,4 @@ plugins:
106106
strategy: {}
107107
test: {}
108108
vars: {}
109-
version: 1.7.1
109+
version: 2.0.0

changelogs/changelog.yaml

+5
Original file line numberDiff line numberDiff line change
@@ -174,3 +174,8 @@ releases:
174174
minor_changes:
175175
- Patch update to fix import errors in utils file.
176176
release_date: '2023-07-31'
177+
2.0.0:
178+
changes:
179+
major_changes:
180+
- Adding support for Unity Puffin v5.4.
181+
release_date: '2024-03-29'

codecov.yml

+3
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
---
2+
fixes:
3+
- "/ansible_collections/dellemc/unity/::"

docs/CONTRIBUTING.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ You may obtain a copy of the License at
1010

1111
# How to contribute
1212

13-
Become one of the contributors to this project! We thrive to build a welcoming and open community for anyone who wants to use the project or contribute to it. There are just a few small guidelines you need to follow. To help us create a safe and positive community experience for all, we require all participants to adhere to the [Code of Conduct](https://github.com/dell/ansible-unity/blob/1.7.1/docs/CODE_OF_CONDUCT.md).
13+
Become one of the contributors to this project! We thrive to build a welcoming and open community for anyone who wants to use the project or contribute to it. There are just a few small guidelines you need to follow. To help us create a safe and positive community experience for all, we require all participants to adhere to the [Code of Conduct](https://github.com/dell/ansible-unity/blob/2.0.0/docs/CODE_OF_CONDUCT.md).
1414

1515
## Table of contents
1616

@@ -76,7 +76,7 @@ Triage helps ensure that issues resolve quickly by:
7676

7777
If you don't have the knowledge or time to code, consider helping with _issue triage_. The Ansible modules for Dell Unity community will thank you for saving them time by spending some of yours.
7878

79-
Read more about the ways you can [Triage issues](https://github.com/dell/ansible-unity/blob/1.7.1/docs/ISSUE_TRIAGE.md).
79+
Read more about the ways you can [Triage issues](https://github.com/dell/ansible-unity/blob/2.0.0/docs/ISSUE_TRIAGE.md).
8080

8181
## Your first contribution
8282

@@ -89,7 +89,7 @@ When you're ready to contribute, it's time to create a pull request.
8989

9090
## Branching
9191

92-
* [Branching Strategy for Ansible modules for Dell Unity](https://github.com/dell/ansible-unity/blob/1.7.1/docs/BRANCHING.md)
92+
* [Branching Strategy for Ansible modules for Dell Unity](https://github.com/dell/ansible-unity/blob/2.0.0/docs/BRANCHING.md)
9393

9494
## Signing your commits
9595

@@ -144,7 +144,7 @@ Make sure that the title for your pull request uses the same format as the subje
144144

145145
### Quality gates for pull requests
146146

147-
GitHub Actions are used to enforce quality gates when a pull request is created or when any commit is made to the pull request. These GitHub Actions enforce our minimum code quality requirement for any code that get checked into the repository. If any of the quality gates fail, it is expected that the contributor will look into the check log, understand the problem and resolve the issue. If help is needed, please feel free to reach out the maintainers of the project for [support](https://github.com/dell/ansible-unity/blob/1.7.1/docs/SUPPORT.md).
147+
GitHub Actions are used to enforce quality gates when a pull request is created or when any commit is made to the pull request. These GitHub Actions enforce our minimum code quality requirement for any code that get checked into the repository. If any of the quality gates fail, it is expected that the contributor will look into the check log, understand the problem and resolve the issue. If help is needed, please feel free to reach out the maintainers of the project for [support](https://github.com/dell/ansible-unity/blob/2.0.0/docs/SUPPORT.md).
148148

149149
#### Code sanitization
150150

0 commit comments

Comments
 (0)