Skip to content

Commit

Permalink
Merge pull request #38 from dell/RTS_v3.0.0
Browse files Browse the repository at this point in the history
Added the changes for RTS_v3.0.0
  • Loading branch information
Bhavneet-Sharma authored Nov 29, 2023
2 parents 07ab615 + b9c66bc commit 1928d98
Show file tree
Hide file tree
Showing 85 changed files with 3,055 additions and 368 deletions.
5 changes: 0 additions & 5 deletions .ansible-lint
Original file line number Diff line number Diff line change
@@ -1,7 +1,2 @@
exclude_paths:
- changelogs/
- .github/
- meta/
- roles/capacity_role/defaults/
- roles/capacity_role/vars/
- roles/capacity_role/tasks/
46 changes: 28 additions & 18 deletions .github/workflows/ansible-test.yml
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@ name: CI

on:
push:
branches: [main]
branches: [ main ]
pull_request:
branches: [main]
branches: [ main ]
schedule:
- cron: '0 3 * * *'

Expand All @@ -15,15 +15,15 @@ jobs:
strategy:
fail-fast: false
matrix:
ansible-version: [stable-2.13]
ansible-version: [stable-2.14]
steps:
- name: Check out code
uses: actions/checkout@v2
uses: actions/checkout@v3

- name: Set up Python 3.9
uses: actions/setup-python@v1
- name: Set up Python 3.11
uses: actions/setup-python@v4
with:
python-version: 3.9
python-version: 3.11

- name: Install ansible (${{ matrix.ansible-version }})
run: pip install https://github.com/ansible/ansible/archive/${{ matrix.ansible-version }}.tar.gz --disable-pip-version-check
Expand All @@ -50,15 +50,16 @@ jobs:
fail-fast: false
matrix:
python-version: ["3.9", "3.10", "3.11"]
ansible-version: [stable-2.13, stable-2.14, stable-2.15]
ansible-version: [stable-2.14, stable-2.15, stable-2.16]
exclude:
# Python 3.11 is supported only from ansible-core 2.14 onwards
- python-version: "3.11"
ansible-version: stable-2.13
# Ansible-core 2.16 is supported only from Python 3.10 onwards
- python-version: "3.9"
ansible-version: stable-2.16


steps:
- name: Set up Python ${{ matrix.python-version }}
uses: actions/setup-python@v1
uses: actions/setup-python@v4
with:
python-version: ${{ matrix.python-version }}

Expand Down Expand Up @@ -92,15 +93,20 @@ jobs:
strategy:
fail-fast: false
matrix:
ansible-version: [stable-2.13, stable-2.14, stable-2.15]
python-version: ["3.9", "3.10", "3.11"]
ansible-version: [stable-2.14, stable-2.15, stable-2.16]
exclude:
# Ansible-core 2.16 is supported only from Python 3.10 onwards
- python-version: "3.9"
ansible-version: stable-2.16

steps:
- name: Set up Python 3.9
uses: actions/setup-python@v1
- name: Set up Python 3.11
uses: actions/setup-python@v4
with:
# it is just required to run that once as "ansible-test sanity" in the docker image
# will run on all python versions it supports.
python-version: 3.9
python-version: 3.11

- name: Install ansible (${{ matrix.ansible-version }}) version
run: pip install https://github.com/ansible/ansible/archive/${{ matrix.ansible-version }}.tar.gz --disable-pip-version-check
Expand Down Expand Up @@ -129,7 +135,11 @@ jobs:
fail-fast: false
matrix:
python-version: ["3.9", "3.10", "3.11"]
ansible-version: [stable-2.13, stable-2.14, stable-2.15]
ansible-version: [stable-2.14, stable-2.15, stable-2.16]
exclude:
# Ansible-core 2.16 is supported only from Python 3.10 onwards
- python-version: "3.9"
ansible-version: stable-2.16

steps:
# Important: This sets up your GITHUB_WORKSPACE environment variable
Expand All @@ -139,7 +149,7 @@ jobs:
fetch-depth: 0 # needed for progressive mode to work

- name: Set up Python ${{ matrix.python-version }}
uses: actions/setup-python@v1
uses: actions/setup-python@v4
with:
python-version: ${{ matrix.python-version }}

Expand Down
14 changes: 14 additions & 0 deletions CHANGELOG.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,20 @@ Dellemc.Powermax Change Logs

.. contents:: Topics

v3.0.0
======

Major Changes
-------------

- Added support for PowerMax Laurel.

Minor Changes
-------------

- Added bug fix for SRDF module.
- Added support for connection timeout for all modules.

v2.2.1
======

Expand Down
62 changes: 31 additions & 31 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,15 +6,15 @@ The capabilities of Ansible modules are managing volumes, storage groups, ports,

## Table of contents

* [Code of conduct](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/CODE_OF_CONDUCT.md)
* [Maintainer guide](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/MAINTAINER_GUIDE.md)
* [Committer guide](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/COMMITTER_GUIDE.md)
* [Contributing guide](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/CONTRIBUTING.md)
* [Branching strategy](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/BRANCHING.md)
* [List of adopters](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/ADOPTERS.md)
* [Maintainers](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/MAINTAINERS.md)
* [Support](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/SUPPORT.md)
* [Security](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/SECURITY.md)
* [Code of conduct](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/CODE_OF_CONDUCT.md)
* [Maintainer guide](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/MAINTAINER_GUIDE.md)
* [Committer guide](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/COMMITTER_GUIDE.md)
* [Contributing guide](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/CONTRIBUTING.md)
* [Branching strategy](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/BRANCHING.md)
* [List of adopters](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/ADOPTERS.md)
* [Maintainers](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/MAINTAINERS.md)
* [Support](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/SUPPORT.md)
* [Security](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/SECURITY.md)
* [License](#license)
* [Supported platforms](#supported-platforms)
* [Prerequisites](#prerequisites)
Expand All @@ -23,45 +23,45 @@ The capabilities of Ansible modules are managing volumes, storage groups, ports,
* [Maintanence](#maintanence)

## License
Ansible collection for PowerMax is released and licensed under the GPL-3.0 license. See [LICENSE](https://github.com/dell/ansible-powermax/blob/2.2.1/LICENSE) for the full terms. Ansible modules and modules utilities that are part of the Ansible collection for PowerMax are released and licensed under the Apache 2.0 license. See [MODULE-LICENSE](https://github.com/dell/ansible-powermax/blob/2.2.1/MODULE-LICENSE) for the full terms.
Ansible collection for PowerMax is released and licensed under the GPL-3.0 license. See [LICENSE](https://github.com/dell/ansible-powermax/blob/3.0.0/LICENSE) for the full terms. Ansible modules and modules utilities that are part of the Ansible collection for PowerMax are released and licensed under the Apache 2.0 license. See [MODULE-LICENSE](https://github.com/dell/ansible-powermax/blob/3.0.0/MODULE-LICENSE) for the full terms.

## Supported platforms
Dell PowerMax and VMAX All Flash arrays support Unisphere version 9.1 and later.
Dell PowerMax and VMAX All Flash arrays support Unisphere version 9.2 and later.

## Prerequisites
This table provides information about the software prerequisites for the Ansible Modules for Dell PowerMax.

| **Ansible modules** | **Unisphere version** | **PowerMaxOS** | **Python version** | **Python library version** | **Ansible** |
|---------------------|-----------------------|----------------|-------------------------------|----------------------------|--------------------------|
| v2.2.1 | 9.1 <br> 9.2 <br> 10.0 | 5978.444.444 <br> 5978.669.669 <br> 5978.711.711 <br> 6079.xxx.xxx | 3.9.x <br> 3.10.x <br> 3.11.x | 9.1.x.x <br> 9.2.x.x <br> 10.0.x.x | 2.13 <br> 2.1 4<br> 2.15 |
| v3.0.0 | 9.2 <br> 10.0 <br> 10.1 | 5978.444.444 <br> 5978.669.669 <br> 5978.711.711 <br> 6079.xxx.xxx | 3.9.x <br> 3.10.x <br> 3.11.x | 9.2.x.x <br> 10.0.x.x <br> 10.1.x.x | 2.14 <br> 2.15<br> 2.16 |

* Follow PyU4V installation instructions on [PyU4V Documentation](https://pyu4v.readthedocs.io/)

## Idempotency
The modules are written in such a way that all requests are idempotent and hence fault-tolerant. This means that the result of a successfully performed request is independent of the number of times it is performed.

## List of Ansible modules for Dell PowerMax
* [Volume module](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/modules/volume.rst)
* [Host module](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/modules/host.rst)
* [Host Group module](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/modules/hostgroup.rst)
* [Snapshot module](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/modules/snapshot.rst)
* [Masking View module](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/modules/maskingview.rst)
* [Port module](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/modules/port.rst)
* [Port Group module](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/modules/portgroup.rst)
* [Storage Group module](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/modules/storagegroup.rst)
* [Info module](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/modules/info.rst)
* [SRDF module](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/modules/srdf.rst)
* [RDF Group module](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/modules/rdfgroup.rst)
* [Metro DR module](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/modules/metrodr.rst)
* [Job module](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/modules/job.rst)
* [Snapshot Policy module](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/modules/snapshotpolicy.rst)
* [Storage Pool module](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/modules/storagepool.rst)
* [Process Storage Pool module](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/modules/process_storage_pool_dict.rst)
* [Initiator module](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/modules/initiator.rst)
* [Intelligent Volume Placement](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/modules/capacity_role.rst)
* [Volume module](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/modules/volume.rst)
* [Host module](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/modules/host.rst)
* [Host Group module](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/modules/hostgroup.rst)
* [Snapshot module](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/modules/snapshot.rst)
* [Masking View module](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/modules/maskingview.rst)
* [Port module](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/modules/port.rst)
* [Port Group module](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/modules/portgroup.rst)
* [Storage Group module](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/modules/storagegroup.rst)
* [Info module](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/modules/info.rst)
* [SRDF module](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/modules/srdf.rst)
* [RDF Group module](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/modules/rdfgroup.rst)
* [Metro DR module](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/modules/metrodr.rst)
* [Job module](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/modules/job.rst)
* [Snapshot Policy module](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/modules/snapshotpolicy.rst)
* [Storage Pool module](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/modules/storagepool.rst)
* [Process Storage Pool module](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/modules/process_storage_pool_dict.rst)
* [Initiator module](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/modules/initiator.rst)
* [Intelligent Volume Placement](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/modules/capacity_role.rst)

## Installation and execution of Ansible modules for Dell PowerMax
The installation and execution steps of Ansible modules for Dell PowerMax can be found [here](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/INSTALLATION.md).
The installation and execution steps of Ansible modules for Dell PowerMax can be found [here](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/INSTALLATION.md).

## Maintenance
Ansible modules for Dell Technologies PowerMax deprecation cycle is aligned with [Ansible](https://docs.ansible.com/ansible/latest/dev_guide/module_lifecycle.html).
2 changes: 1 addition & 1 deletion changelogs/.plugin-cache.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -102,4 +102,4 @@ plugins:
shell: {}
strategy: {}
vars: {}
version: 2.1.1
version: 3.0.0
8 changes: 8 additions & 0 deletions changelogs/changelog.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -171,3 +171,11 @@ releases:
- Added support for masking_view_name for listing masking view connections
through info module.
release_date: '2023-10-31'
3.0.0:
changes:
major_changes:
- Added support for PowerMax Laurel.
minor_changes:
- Added bug fix for SRDF module.
- Added support for connection timeout for all modules.
release_date: '2023-11-30'
8 changes: 4 additions & 4 deletions docs/CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ You may obtain a copy of the License at

# How to contribute

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-powermax/blob/2.2.1/docs/CODE_OF_CONDUCT.md).
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-powermax/blob/3.0.0/docs/CODE_OF_CONDUCT.md).

## Table of contents

Expand Down Expand Up @@ -76,7 +76,7 @@ Triage helps resolve issues quickly by:

If you do not have the knowledge or time to code, consider helping with _issue triage_. The Ansible modules for Dell PowerMax community thanks you for saving them time by spending some of yours.

Read more about the ways you can [Triage issues](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/ISSUE_TRIAGE.md).
Read more about the ways you can [Triage issues](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/ISSUE_TRIAGE.md).

## Your first contribution

Expand All @@ -90,7 +90,7 @@ When you are ready to contribute, it is time to create a pull request.
For information about branching, see
## Branching

* [Branching Strategy for Ansible modules for Dell PowerMax](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/BRANCHING.md)
* [Branching Strategy for Ansible modules for Dell PowerMax](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/BRANCHING.md)

## Signing your commits

Expand Down Expand Up @@ -145,7 +145,7 @@ Ensure that the title for your pull request uses the same format as the subject

### Quality gates for pull requests

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 investigate the check log, understand the problem, and resolve the issue. If help is needed, reach out to the maintainers of the project for [support](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/SUPPORT.md).
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 investigate the check log, understand the problem, and resolve the issue. If help is needed, reach out to the maintainers of the project for [support](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/SUPPORT.md).

#### Code sanitization

Expand Down
4 changes: 2 additions & 2 deletions docs/INSTALLATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ Depending on which PowerMax Unisphere version is being used, follow this procedu

2. Use this command to install the collection anywhere in your system:

ansible-galaxy collection install dellemc-powermax-2.2.1.tar.gz -p <install_path>
ansible-galaxy collection install dellemc-powermax-3.0.0.tar.gz -p <install_path>

3. Set the environment variable:

Expand All @@ -67,7 +67,7 @@ Depending on which PowerMax Unisphere version is being used, follow this procedu

## Running Ansible modules

The Ansible server must be configured with Python library for Unisphere to run the Ansible playbooks. The [Documents](https://github.com/dell/ansible-powermax/blob/2.2.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.
The Ansible server must be configured with Python library for Unisphere to run the Ansible playbooks. The [Documents](https://github.com/dell/ansible-powermax/blob/3.0.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.

## SSL certificate validation

Expand Down
4 changes: 2 additions & 2 deletions docs/ISSUE_TRIAGE.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,9 +41,9 @@ This section describes the various issue templates and the expected content.

Bug reports should explain what happened, what was expected and how to reproduce it. Additionally, any applicable material about the reported problem that may give a complete picture of what happened such as screenshots, outputs, and environment related information:

- Ansible Version: [e.g. 2.13]
- Ansible Version: [e.g. 2.14]
- Python Version [e.g. 3.10]
- Ansible modules for Dell PowerMax Version: [e.g. 2.2.1]
- Ansible modules for Dell PowerMax Version: [e.g. 3.0.0]
- PowerMax SDK version: [e.g. PyU4V 10.0.0.16]
- Any other additional information...

Expand Down
2 changes: 1 addition & 1 deletion docs/MAINTAINER_GUIDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ If a candidate is approved, a Maintainer contacts the candidate to invite them t
## Maintainer policies

* Lead by example
* Follow the [Code of Conduct](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/CODE_OF_CONDUCT.md) and the guidelines in the [Contributing](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/CONTRIBUTING.md) and [Committer](https://github.com/dell/ansible-powermax/blob/2.2.1/docs/COMMITTER_GUIDE.md) guides
* Follow the [Code of Conduct](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/CODE_OF_CONDUCT.md) and the guidelines in the [Contributing](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/CONTRIBUTING.md) and [Committer](https://github.com/dell/ansible-powermax/blob/3.0.0/docs/COMMITTER_GUIDE.md) guides
* Promote a friendly and collaborative environment within our community
* Be actively engaged in discussions, answering questions, updating defects, and reviewing pull requests
* Criticize code, not people. Ideally, tell the contributor a better way to do what they need achieve.
Expand Down
Loading

0 comments on commit 1928d98

Please sign in to comment.