Ansible Collection - cohesity.dataprotect

Overview

This project provides an Ansible Collection for interacting with the Cohesity DataPlatform.

This Ansible Collection can be used on Windows, Linux or MacOS leveraging Python.

It includes modules, tasks, and example plays useful for automating common tasks and orchestrating workflows in your environment.

This Ansible Collection leverages Cohesity REST API to interact with the Cohesity Cluster.

Installation

ansible-galaxy collection install cohesity.dataprotect

To use this collection, add the following to the top of your playbook:

collections:
  - cohesity.dataprotect

Requirements

• ansible-core version >= 2.16.0
• requests >= 2.31.0
• python version >= '3.6'
• cohesity_management_sdk >= 1.6.0

To install the requirements, run pip install -r requirement.txt

Table of contents

• Getting Started
• More samples playbooks
• Changelog
• Support (Red Hat Users)
• How can you contribute
• Suggestions and Feedback
• Disclaimer

Let's get started

• Documentation for Cohesity Ansible Collection.

Some samples to get you going 💡

• Refer playbooks folder to find more examples.

Changelog

See CHANGELOG.rst for a full list of changes by version.

Recent highlights:

• v1.4.5 — Added Oracle RAC cluster support (source_type, scan_vip_address / SCAN/VIP Address) across Oracle source, job, and restore modules; config-driven Oracle workflow playbooks; fixed missing Content-Type: application/json headers on REST API calls.
• v1.4.4 — Bumped requests minimum version to >=2.31.0 to address known security vulnerabilities; added Changelog and Support (Red Hat Users) sections to README.
• v1.4.3 — Fixed agent detection failing with "Cohesity Agent is partially installed" on systemd hosts where the SysV init script is not created by the installer.
• v1.4.2 — Bumped minimum Ansible-Core version to 2.16; fixed LiteralPath issue during Windows agent installation and collection failure issues on some Ansible versions.

Support (Red Hat Users)

This collection is part of Red Hat Ansible Certified Content and is entitled to support through the Ansible Automation Platform (AAP).

If you are an AAP subscriber, you can open a support case directly from Ansible Automation Hub:

1. Navigate to the collection page on Ansible Automation Hub.
2. Click the Create issue button to file a support ticket with Red Hat.

For issues or feature requests outside of an AAP subscription, use the GitHub issue tracker.

Contribute

• Refer our contribution guideline.

• Refer our contribution guideline.

Suggestions and Feedback

We would love to hear from you. Please send your suggestions and feedback to: support@cohesity.com

Code of Conduct

This collection follows the Ansible project's Code of Conduct.

License

GNU General Public License v3.0.

Disclaimer

The scripts, recipes, and integrations provided here are community-contributed or best-effort solutions from Cohesity engineering and ecosystem partners. These resources are not officially supported by Cohesity Support or Field teams. For production-grade use or enterprise implementation support, please contact Cohesity Professional Services or your account team.