Skip to content

Latest commit

 

History

History
42 lines (33 loc) · 2.47 KB

README.md

File metadata and controls

42 lines (33 loc) · 2.47 KB

ansible-fact

Table of Contents

  1. Table of Contents
  2. About
  3. Available Modules
  4. Module Documentation
  5. Contributions
    1. Guidelines
  6. Author(s)

About

The concept of this project is to perform Infrastructure-as-Code in Reverse (i.e. iacir - pronounced: aya sir).

ansible-fact consists of a collection of Ansible fact collectors to be able to generate structured data and harvest system configurations. The goal is to be able to automatically collect all aspects of a system's configuration through modules.

Available Modules

Module Name Description Test Playbook
scan_cron Collects all cron data from a system and converts to structured data scan_cron.yml
scan_processes Collects currently running processes from a system and converts to structured data scan_processes.yml
scan_sudoers Collects all sudoers configurations and converts to structured data scan_sudoers.yml
scan_user_group Collects all local user and group data from /etc/shadow, /etc/gshadow, /etc/passwd, and /etc/group, and merges into structured data. scan_user_group.yml

Module Documentation

All module documentation can be found in each respective module, as with any Ansible module.

Contributions

Please feel free to openly contribute to this project. All code will be reviewed prior to merging.

Guidelines

  • Please perform all development and pull requests against the dev branch of this repository.
  • If a particular fact collector can apply to many different Operating Systems, please try and accommodate all Operating System implementations in an attempt to keep this project platform agnostic.
  • Please include a test playbook in the test directory.
  • Please place your modules in the library directory.
  • Please document your code and modules thoroughly via comments and by following Ansible's Module Development Documentation.

Author(s)

Andrew J. Huffman