An open API service indexing awesome lists of open source software.

https://github.com/alexkross/cisco_ftd_cli

Cisco FTD for network_cli Ansible collection
https://github.com/alexkross/cisco_ftd_cli

ansible ansible-galaxy cisco cisco-device cisco-firepower

Last synced: 3 months ago
JSON representation

Cisco FTD for network_cli Ansible collection

Awesome Lists containing this project

README

          

# CISCO_FTD Ansible Collection

## WARNING: TESTED/USED ONLY FOR ``show running-config``, STATUS BETA

## ToDo: module for diagcli_command (``system support diagnostic-cli`` mode).

This Ansible collection includes ``ftd`` terminal and cliconf plugins that allow you to use it as ``ansible_network_os`` under ``network_cli`` connection.

This collection has been tested against Cisco FTD version 7.0.1

## Ansible version compatibility

This collection has been tested against following Ansible versions: **>=2.14.2**.

## Requirements

Nothing special.

### Using alexkross.cisco_ftd_cli collection in your playbooks

With the collection installed just call ansible.netcommon.cli_command module targeting a FTD device.

```yaml
---
- name: Show running configuration
cli_command:
command: show running-config
register: reg
- debug: var=reg.stdout
```

For obvious reasons ``cli_config`` is unsupported on a FTD gear managed under FMC (TDB: backup as the only supported option). You can try other collections instead, [fmc_collections by amotolani](https://github.com/amotolani/fmc_collections) for example.

### See Also:
* [Ansible Using collections](https://docs.ansible.com/ansible/latest/user_guide/collections_using.html) for more details.

## Contributing to this collection
We are seeking contributions to help improve this collection. If you find problems, or a way to make it better, please open an issue or create a PR against the [cisco_ftd_cli collection repository](https://github.com/alexkross/cisco_ftd_cli/).

### Code of Conduct
This collection follows the Ansible project's
[Code of Conduct](https://docs.ansible.com/ansible/latest/community/code_of_conduct.html).
Please read and familiarize yourself with this document.

## More information

- [Ansible User guide](https://docs.ansible.com/ansible/latest/user_guide/index.html)
- [Ansible network resources](https://docs.ansible.com/ansible/latest/network/getting_started/network_resources.html)
- [Ansible Collection overview](https://github.com/fmc_collections/overview)
- [Ansible Developer guide](https://docs.ansible.com/ansible/latest/dev_guide/index.html)
- [Ansible Developing network plugins](https://docs.ansible.com/ansible/latest/network/dev_guide/developing_plugins_network.html)
- [Cisco Firepower Threat Defence Notes](https://github.com/willrabarber/Networking/wiki/Cisco-Firepower-Threat-Defence-Notes)
- [Ansible code of conduct](https://docs.ansible.com/ansible/latest/community/code_of_conduct.html)

## Licensing

GNU General Public License v3.0 or later.

See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) to see the full text.