Skip to content

Latest commit

 

History

History
30 lines (16 loc) · 2.1 KB

README.md

File metadata and controls

30 lines (16 loc) · 2.1 KB

Introduction

This fork of munki-facts gathers sensor names & values before running any additional facts modules. For items that need live data, rather than what the hub has cached from the last sensor run, you can provide fact modules to overwrite the value. It (currently?) has the path to WS1's ManagedInstalls directory hard-coded.

* This is using the default path to MacAdmins Python in the shebang. Because WS1 puts their Python framework for munki inside Application Support, we can't use it there.

Sensor values that are valid json strings should be added to the ConditionalItems.plist with native data types. Otherwise, the values will be strings.

Although I haven't tested it, and it's probably irrelevant and pointless, this version should work as the original did in a straight Munki environment.

munki_facts.py is an "admin-provided conditions" script for Munki as described here.

munki_facts.py is designed to be modular, allowing more 'facts' to be easily added without duplicating all of the code required to insert the facts into the ConditionalItems.plist.

Python modules that generate one or more facts live in the 'facts' subdirectory. They must have a 'fact()' function that returns a dictionary of keys and values.

Several sample fact modules are included.

Usage

munki_facts.py and the facts directory should be installed in /usr/local/munki/conditions. munki_facts.py must be marked as executable.

Munki will run munki_facts.py and insert any facts it generates into the dictionary of items that are used in manifest conditional_items predicates and in installable_condition items in pkginfo files.

Any additional fact modules (that you create or obtain from others) should be copied into the /usr/local/munki/conditions/facts directory.

More facts

See https://github.com/munki/munki-facts/wiki/Community-Facts