alexxnica / rudder-agent

Rudder agent support utility repository

rudder-agent

Rudder agent support utility repository.

CLI

This repository contains a CLI for rudder. Here is how it works :

rudder help
rudder agent help
rudder agent <command>
rudder server help
rudder server <command> # if you have server support

This cli is made to be expandable, which means that you can add new commands at will.

To add a new command, just drop it into /opt/rudder/share/command and/or make a new pull request to add it to share/command in this repository.

A command must have the following properties :

• be called agent- or server-

• parameters will not include the 'agent', 'server' or given in the command line

• the executable must contain a string with a single line of the form:

  @description

• the executable may also contain a single or multi-line string of the form:

  @man

New commands should follow these guidelines :

• have as few dependencies as possible on the agent side
• if -h is an option, it must provide help
• if -v is an option, it must make the command verbose
• if -d is an option, it must be debug

Build man pages

In order to build the man pages, you will need:

• asciidoc for man pages: probably packaged by your distribution
• asciidoctor for the HTML output: gem install asciidoctor

Then run make in the man folder. It will generate rudder.1 and rudder.html.