Skip to content

rduty is a Python script to easily and quickly run a command or multiple commands on remote and local hosts and devices via ssh (telnet is also supported). It is also able to automate repetitive tasks on many hosts using inventory files from Ansible, or simple .ini inventory files.

main
Switch branches/tags
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.rst

rduty

A simple and quick program to execute and automate remote commands.

rduty is a Python script to easily and quickly run a command or multiple commands on remote and local hosts and devices via ssh (telnet is also supported). It is also able to automate repetitive tasks on many hosts using inventory files from Ansible, or simple .ini inventory files.

rduty is currently tested on Python3, it hasn't been tested yet on other Python versions.

Installation

Python3 is needed, other than that, the rduty package is installation is very simple, but there are some dependencies which you might have to install as well:

$ sudo pip install paramiko
$ make install

By default rduty will be installed with the '/usr/local' prefix. You can change this by passing 'PREFIX=the_prefix' to make:

$ make PREFIX=/usr install

When rduty is executed it will check for the needed dependencies and report if anything is missing.

Usage

Usage: rduty [HOST or INVENTORY] [COMMAND or SCRIPT] ...

Some usage examples:

$ rduty -H 192.168.0.10 -C "ls"
$ rduty -H 192.168.0.10,192.168.0.20,server.mydomain.local -C "uname -a"
$ rduty -I myinventory/servers.ini --script "/home/user/commands_list.txt"
$ rduty -I myinventory/servers.ini --script "/home/user/commands_list.txt" --dryrun

Options:

Option Description
Required arguments:  
-H, --hosts host1,host2,... A hostname or IP, or a comma separated list of hosts
-I, --inventory FILENAME path to inventory file (.ini or Ansible format)
-C, --command COMMAND remote command to ececute on the remote hosts or devies
-S, --script FILENAME path to a list of commands to ececute on the remote hosts or devies
Optional arguments:  
-U, --username USERNAME username for the remote connection
-P, --password PASSWORD password for the remote connection
-p, --port PORT port used for the connection, default is 22
-d, --dryrun doesn't execute any command on the hosts
-q, --quiet shows essential output only
-v, --version output version information and exit.
-h, --help show this help and exit.

Script file and Inventory file format

A script is a file with a list of command to execute on the remote host, each one on a new line:

uname -a
df
hostname

A Inventory file is a .ini file with a list of hosts with the folling format:

[servers]
server1.localdomain.local
server2.localdomain.local
[dbs]
db1.localdomain.local

Command line

Usage: rduty [HOST or INVENTORY] [COMMAND or SCRIPT] ...

$ ./rduty.py  -H 192.168.0.3 -C "uname" -p 22
Username: gabriele
Password:
1. [192.168.0.3:22]
192.168.0.3 -> Connect
192.168.0.3 -> Executing command: uname
192.168.0.3 -> Getting output:
-----------------------------------------------------------------------------------------------------------------------
Linux
-----------------------------------------------------------------------------------------------------------------------
192.168.0.3 -> Connection closed.

Contact

The latest version of rduty is available on GitHub https://github.com/gabgio/rduty . For questions, bug reports, suggestions, etc. please contact the author.

License

This software is licensed under the GNU GPL2.

© 2020 Gabriele Giorgetti.

About

rduty is a Python script to easily and quickly run a command or multiple commands on remote and local hosts and devices via ssh (telnet is also supported). It is also able to automate repetitive tasks on many hosts using inventory files from Ansible, or simple .ini inventory files.

Topics

Resources

License

Packages

No packages published