Kanrisuru helps you manage your remote servers with objected oriented ruby. Results come back as structured data, parsed, prepared and ready for you to easily use in your applications.
Get StartedWith Kanrisuru, there's no need to install agents on the infrastructure you are managing. Instead, the commands are run through remote ssh connections from wherever Kanrisuru is setup and run.
Kanrisuru is meant to be directly plugged into your ruby project. Since it's a library of modules to manage linux servers, it's easy to rapidly develop remote server management code, without large library dependencies.
All Kanrisuru commands have well tested options with arguments being directly verified. Any Kanrisuru command with output is parsed and assigned to a dedicated object property, making it easy to read results from the remote servers.
Specify the Kanrisuru gem in the Gemfile.
Run bundle install to install the latest version of Kanrisuru
You can also install Kanrisuru globally
Get up and runninggem 'kanrisuru'bundle installgem install kanrisuruKanrisuru is easy to quickly connect to your remote infrastructure. Once the library is installed, you can start running commands with just a few lines of code. Kanrisuru has a robust set of the top 80% of commands used in most linux environments, tested, and ported in a way that makes interacting with remote servers a breeze.
Dive into the commandsrequire 'kanrisuru'
host = Kanrisuru::Remote::Host.new(host: '127.0.1.1', username: 'ubuntu', keys: ['~/.ssh/id_rsa'])
host.env['VAR'] = 'world'
result = host.echo('hello $VAR')
result.success?
true
result.to_s
"hello world"Kanrisuru has a strong test suite, including a full integration suite over the top linux distros, including Debian, Ubuntu, Centos, Fedora, Redhat, openSUSE, and SLES. Kanrisuru strives to ensure operational effectiveness with the library with high line coverage and tested on as many flavors of linux as possible.
Learn more
