Adam BaaliandRachael Shaw
632c9c645e
The glob/ `paths:` feature was added across PRs #40799 (scripts, configuration_profiles) and #41141 (labels, policies, reports) but the customer-facing YAML reference at `docs/Configuration/yaml-files.md` was never updated to document it. This adds documentation for: - New `path:` vs `paths:` reference section explaining the difference between singular (literal file) and plural (glob pattern) - Characters to avoid in filenames when using `path:` (`*`, `?`, `[`, `{`) - `scripts` section: `paths:` support with `.sh`/`.ps1` filter note - `apple_settings`/`windows_settings` section: `path:` vs `paths:` wit examples - `android_settings` section: `paths:` support note - `labels`, `policies`, `reports` sections: `paths:` support notes - `paths:` glob examples added to the controls YAML example for both scripts, apple_settings, and windows_settings Discovered via customer-sonet whose Windows profile filenames use brackets as a CSP naming convention (e.g. `[AllowSpotlightCollection].xml`), which are rejected by `path:` validation as glob metacharacters. See related bug report for the false positive on literal filenames. https://github.com/fleetdm/fleet/issues/43598 <!-- Add the related story/sub-task/bug number, like Resolves #123, or remove if NA --> **Related issue:** Resolves #43598 Co-authored-by: Rachael Shaw <r@rachael.wtf>
Fleet documentation
Welcome to the documentation for Fleet, the lightweight management platform for laptops and servers.
You can also read the Fleet docs over at https://fleetdm.com/docs.
Using Fleet
Resources for using the Fleet UI, fleetctl CLI, and Fleet REST API.
Deploying
Resources for installing Fleet's infrastructure dependencies, configuring Fleet, deploying osquery to hosts, and viewing example deployment scenarios.
Contributing
If you're interested in interacting with the Fleet source code, you'll find information on modifying and building the code here.
If you have any questions, please don't hesitate to File a GitHub issue or join us on Slack. You can find us in the #fleet channel.