The nutanix.ansible repository is the official Nutanix Ansible collection designed to automate Nutanix Cloud Platform operations. Written primarily in Python, it provides Ansible modules and playbooks that enable infrastructure teams to manage Nutanix environments through infrastructure-as-code practices. The collection is built on Nutanix v4 APIs and SDKs and requires ansible-core version 2.16.0 or higher, along with specific Python dependencies listed in the project's requirements.txt file.
The repository has demonstrated significant activity and engagement within the Nutanix and Ansible communities.
Version 2.5.0 represents a major update introducing substantial new functionality and improvements. The release adds support for Network Functions, Entity Groups for microsegmentation, Security Policy Rules listing, IAM Entities, and Virtual Switches, all built on v4 SDKs. Major improvements include configurable read timeout functionality across all v4 modules to handle slow Prism Central responses, Service Account API key authentication support via X-Ntnx-Api-Key headers, HTTP and HTTPS proxy support with authentication capabilities, and enhanced handling of invalid characters in inventory plugin group names. The collection also updated its CI/CD pipeline to Python 3.12 for compatibility with Ansible Core 2.16 and introduced a dedicated BaseModulev4 class to streamline v4-specific parameters.
The collection's design philosophy emphasizes simplicity, making it easy to use and develop. It supports comprehensive Nutanix infrastructure management including virtualization, cluster deployment, networking, security policies, identity and access management, and licensing operations.
An important deprecation notice indicates that legacy modules based on v0.8, v1, v2, and v3 APIs will be deprecated starting with a release planned for Q4-CY2026. Nutanix actively encourages users to migrate to the latest v2 versions marked with the _v2 suffix, which leverage v4 APIs and SDKs for enhanced capabilities and modern innovations. The collection is Red Hat Ansible Certified Content and entitled to support through the Ansible Automation Platform, with community support available through the Ansible Forum for users obtaining the collection from Galaxy or GitHub. Documentation includes required permissions guidance for Ansible service accounts and deprecation notices for modules like Karbon that are no longer supported on Prism Central 7.3 and later.
