Skip to content

README.md

Latest commit

 

History

History
79 lines (56 loc) · 2.51 KB

README.md

File metadata and controls

79 lines (56 loc) · 2.51 KB
Raw

Adfinis facts Collection for Ansible

Collection for custom Adfinis ansible facts plugins

Included content

  • timer_facts: slightly modified service_facts plugin to support timer units
  • apt_sources_facts: Gather facts about configured sources for Debian's APT. Supports both the sources.list and the deb822 formats.
  • tlsref_facts: gather recommended TLS configuration from tlsref.org (formerly ssl-config.mozilla.org) and register it as a fact.

Using this collection

Usage examples for the individual fact plugins included:

timer_facts

- name: Populate timer facts
  adfinis.facts.timer_facts:

- name: Print timer facts
  ansible.builtin.debug:
    var: ansible_facts.timers

apt_sources_facts

- name: Populate apt sources facts
  adfinis.facts.apt_sources_facts:

- name: Print apt sources facts
  ansible.builtin.debug:
    var: ansible_facts.apt_sources

tlsref_facts

- name: Gather the TLSRef reference configuration
  adfinis.facts.tlsref_facts:
    version: "6.0"

- name: Print the list of TLS ciphers in the intermediate configuration
  ansible.builtin.debug:
    var: ansible_facts.tlsref.configurations.intermediate.ciphers.openssl

Installing the Collection from Ansible Galaxy

Before using this collection, you need to install it with the Ansible Galaxy command-line tool:

ansible-galaxy collection install adfinis.facts

You can also include it in a requirements.yml file and install it with ansible-galaxy collection install -r requirements.yml, using the format:

---
collections:
  - name: adfinis.facts

Note that if you install the collection from Ansible Galaxy, it will not be upgraded automatically when you upgrade the ansible package. To upgrade the collection to the latest available version, run the following command:

ansible-galaxy collection install adfinis.facts

You can also install a specific version of the collection, for example, if you need to downgrade when something is broken in the latest version (please report an issue in this repository). Use the following syntax to install version 0.1.0:

ansible-galaxy collection install adfinis.facts:==0.1.0

See Ansible Using collections for more details.

Contributing to this collection

Once you have done some work, please test the collection locally using molecule. To install it locally, use ansible-galaxy collection build and install the resulting tar.gz file.