ciscodevnet/ftd-ansible repository overview

⁠FTD Ansible

A Docker image with a collection of Ansible modules that automate configuration management and execution of operational tasks on Cisco Firepower Threat Defense (FTD) devices using FTD REST API.

Please, check FTD Ansible docs on DevNet⁠ for the detailed user documentation.

⁠Overview

The image contains additional four Ansible modules:

• ftd_configuration.py⁠ - manages device configuration via REST API. The module configures virtual and physical devices by sending HTTPS calls formatted according to the REST API specification;
• ftd_file_download.py⁠ - downloads files from FTD devices via HTTPS protocol;
• ftd_file_upload.py⁠ - uploads files to FTD devices via HTTPS protocol;
• ftd_install.py⁠ - installs FTD images on hardware devices. The module performs a complete reimage of the Firepower system by downloading the new software image and installing it.

⁠Running playbooks in Docker

1. Pull the image:

   docker pull ciscodevnet/ftd-ansible
   

   Copy

2. Create an inventory file that tells Ansible what devices to run the tasks on;

3. Run the playbook in Docker mounting playbook folder to /ftd-ansible/playbooks and inventory file to /etc/ansible/hosts:

   docker run -v $(pwd)/samples:/ftd-ansible/playbooks -v $(pwd)/inventory/sample_hosts:/etc/ansible/hosts ciscodevnet/ftd-ansible playbooks/test_playbook.yml
   

   Copy