The Ansible Modules for Dell APEX Cloud Platform for Microsoft Azure allow data center and IT administrators to use RedHat Ansible to automate and orchestrate the configuration and management of Dell APEX Cloud Platform for Microsoft Azure.
The capabilities of Ansible modules are gathering system information and performing Day1 Initialization. These tasks can be executed by running simple playbooks written in yaml syntax. The modules are written so that all the operations are idempotent, therefore making multiple identical requests has the same effect as making a single request.
Ansible modules for Dell APEX Cloud Platform for Microsoft Azure are supported by Dell EMC open source community, but not product support agreements, and are provided under the terms of the license attached to the source code. Dell EMC does not provide support for any source code modifications. For any Ansible module issues, questions or feedback, join the Dell EMC Automation community.
- Dell APEX Cloud Platform for Microsoft Azure
This table provides information about the software prerequisites for the Ansible Modules for Dell EMC VxRail.
| Ansible Modules | APEX Cloud Platform for Microsoft Azure version | Python version | Python library (ACP Ansible Azure Utility) version | Ansible Version |
|---|---|---|---|---|
| v1.0.0 | 01.01.00.00 | 3.8 | 1.0.0 | 2.13 |
- Please follow Dell APEX Cloud Platform for Microsoft Azure Ansible Utility installation instructions on Dell APEX Cloud Platform for Microsoft Azure Ansible Utility Documentation
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 executed.
- Auto Discovery Hosts Module
- System OS Provision Module
- Initialize LDAPS Certificate Module
- Cluster Deployment Module
- System Initialize Full Module
Install the python sdk named 'Dell APEX Cloud Platform for Microsoft Azure Ansible Utility'. It can be installed using pip, based on the appropriate python version.
-
Download the tar build and install the collection anywhere in your system, e.g.
ansible-galaxy collection install dellemc-apexcp_azure-1.0.0.tar.gz -p <install_path> -
Set the environment variable:
export ANSIBLE_COLLECTIONS_PATHS=$ANSIBLE_COLLECTIONS_PATHS:<install_path>
- In order to use any Ansible module, ensure that the importation of the proper FQCN (Fully Qualified Collection Name) must be embedded in the playbook. For example,
collections:
- dellemc.apexcp_azure - To generate Ansible documentation for a specific module, embed the FQCN before the module name. For example,
ansible-doc dellemc.apexcp_azure.dell_apexcp_azure_cluster_deployment
The Ansible server must be configured with Python library for Dell APEX Cloud Platform for Microsoft Azure Ansible Utility to run the Ansible playbooks. The Documents 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 needs to be configured before running the modules.