Skip to content

dell/ansible-acp-azure

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Ansible Modules for Dell APEX Cloud Platform for Microsoft Azure

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.

Support

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.

Supported Platforms

  • Dell APEX Cloud Platform for Microsoft Azure

Prerequisites

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

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 executed.

List of Ansible Modules for Dell APEX Cloud Platform for Microsoft Azure

Installation of SDK

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.

Installing Collections

  • 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>
    

Using Collections

  • 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

Running Ansible Modules

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.