Skip to content

How tasks work

Netpilot is a generic config push engine. A task is any set of commands you push to devices — SNMPv3, syslog, NTP, ACL, banner, or anything else.

  • --task is a label recorded in the inventory so you can track which devices have been configured for each task independently.
  • --commands tells Netpilot which command files to load.

Each task uses up to 3 files per vendor:

FilePurposeWhen
config/{vendor}/{task}_pre.txtShow commands — snapshot before changeBefore push
config/{vendor}/{task}.txtConfig commands to pushDuring push
config/{vendor}/{task}_post.txtShow commands — verify change appliedAfter push

Most specific wins:

  1. config/{vendor}/{role_suffix}/{task}.txt — role override (e.g. alcatel/poe_switch/snmpv3.txt)
  2. config/{vendor}/{task}.txt — vendor default
Task--commandsFiles
SNMPv3 pushsnmpv3cisco/snmpv3.txt, alcatel/snmpv3.txt, alcatel/poe_switch/snmpv3.txt, alcatel_wlc/snmpv3.txt
Syslog configsyslogcisco/syslog.txt, alcatel/syslog.txt
Config backupbackupcisco/backup.txt, alcatel/backup.txt