Detecting Missing Dependencies and Notifiers in Puppet Programs

TL;DR

This paper presents a formal analysis approach to detect missing dependencies and notifiers in Puppet programs, improving reliability by identifying potential configuration faults through trace analysis and dependency graph comparison.

Contribution

It introduces a formal model for Puppet trace analysis to automatically identify configuration issues related to dependencies and notifications.

Findings

Discovered 57 previously unknown issues in Puppet modules

Analyzed real-world configurations with thousands of lines in minutes

Effectively detects configuration faults affecting system reliability

Abstract

Puppet is a popular computer system configuration management tool. It provides abstractions that enable administrators to setup their computer systems declaratively. Its use suffers from two potential pitfalls. First, if ordering constraints are not specified whenever an abstraction depends on another, the non-deterministic application of abstractions can lead to race conditions. Second, if a service is not tied to its resources through notification constructs, the system may operate in a stale state whenever a resource gets modified. Such faults can degrade a computing infrastructure's availability and functionality. We have developed an approach that identifies these issues through the analysis of a Puppet program and its system call trace. Specifically, we present a formal model for traces, which allows us to capture the interactions of Puppet abstractions with the file system. By analyzing these interactions we identify (1) abstractions that are related to each other (e.g., operate on the same file), and (2) abstractions that should act as notifiers so that changes are correctly propagated. We then check the relationships from the trace's analysis against the program's dependency graph: a representation containing all the ordering constraints and notifications declared in the program. If a mismatch is detected, our system reports a potential fault. We have evaluated our method on a large set of Puppet modules, and discovered 57 previously unknown issues in 30 of them. Benchmarking further shows that our approach can analyze in minutes real-world configurations with a magnitude measured in thousands of lines and millions of system calls.