# ansible-dnac

**Repository Path**: mirrors_CiscoDevNet/ansible-dnac

## Basic Information

- **Project Name**: ansible-dnac
- **Description**: Ansible Collection for automating operations using Cisco DNA Center
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: devel
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-10-22
- **Last Updated**: 2026-04-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ansible-dnac

The `ansible-dnac` project provides an Ansible collection for automating tasks
of the Cisco DNA Center server.  It provides a set of plugins and roles for
perfoming tasks against the DNA Center server.

Note: This collection is not compatible with versions of Ansible before 2.8


## Requirements

* Ansible 2.8 or later
* Cisco Intent API 1.2 or later


## Contributing

Contributions are strongly encourged from the Cisco DevNet community.  To 
contribute to this collection simply fork the project in Github, create a new
feature and/or bugfix branch, make your changes and submit a pull request.


## Running from source

This collection can be run from the source checkout.  To install the 
collection issue the following command:

```make install```

This command will install the collection to the local users Ansible collections
path at ```~/.ansible/collections/ansible_collections/ciscodevnet/ansible_dnac```

To uninstall the collection issue the command:

```make uninstall```

Once the collection is installed, you can use it in a playbook by specifying 
the full namespace path to the module, plugin and/or role. 

```
---
- hosts: dnac
  gather_facts: no

  tasks:
    - name: add devices to inventory
      ciscodevnet.ansible_dnac.devices:
        config:
          - address: 1.2.3.4
            username: ansible
            password: ansible
            snmp_ro_community: public
            snmp_rw_community: private
          - address: 5.6.7.8
            username: ansible
            password: ansible
            snmp_ro_community: public
            snmp_rw_communit
      state: present
```


## License

GPLv3


## Contributors

* Peter Sprygada (privateip) <psprygad@redhat.com>