run-shell-scripts

Executes your shell/bash scripts on hosts, with an optional class condition and a minimum interval between runs.

Maintainer

Igor Aleksandrychev

Module stats

Total Downloads: 2
Updated: Sep 18, 2026

Installation version

Version
Released on Sep 18, 2026

Tags

Installation

                    
cfbs add run-shell-scripts@2.0.0
Description
Dependencies
Discussion

run-shell-scripts

CI

A cfbs module that runs shell/bash scripts.

Usage

cfbs add run-shell-scripts
cfbs input run-shell-scripts
cfbs build

Input

run_shell_scripts:main.scripts is a repeatable list; each entry describes one script:

Key Type Default Description
path file - Path to the .sh/.bash script to run.
condition string any Class expression gating whether this script runs.
ifelapsed string 0 Minutes between runs of this script (0 = every agent run).

condition is a CFEngine class expression, e.g. Monday, linux, !any (never run). Each script has its own condition and ifelapsed, so scripts can be scheduled independently of each other.

Note: scripts uses a list input with a keyed file/string subtype, which requires cfbs 5.8.0 or newer.

Dependencies

This module has no dependencies