WizTeleport

WizTeleport is a Ruby Gem that simplifies SSH connections and remote command execution. It is ideal for operational tasks and automated deployments.

WizTeleport is designed to execute shell commands remotely over SSH, with no agents to install on remote systems.

Add this line to your application's Gemfile:

gem 'wiz-teleport'

And then execute:

$ bundle

Or install it yourself as:

gem install wiz-teleport

WizTeleport is a powerful automation tool for configuration management, application deployment, task execution, and more. It is based on SSH, so there is no need to install the agent on the target host. Here are the basic steps and examples for using WizTeleport.

1. Create a project directory

   First, create a new directory to save your Ruby project:

   mkdir my_ruby_project
   cd my_ruby_project

2. Install WizTeleport

   Make sure you have Ruby installed. Then run the following command to install the WizTeleport:

   gem install wiz-teleport

3. Create an WizTeleport manifest file

   WizTeleport uses a manifest file to define hosts. Wiz-Teleport reads a list or group from Inventory.yml and can operate these controlled nodes or hosts simultaneously and concurrently, just like Ansible. Create a file called inventory.yml that looks like this:

   # inventory.yml
   ---
   - name: web1
     user: root
     password: root
     servers:
     - host: 127.0.0.1     
   - name: data1
     servers:
     - host: db1.example.com       
     - host: db2.example.com
       name: db1
       user: root
       password: root
     children:
     - web1

4. Build an WizTeleport script

   WizTeleport script defines tasks by writing ruby scripts. Here is an example of a simple WizTeleport script:

   #example.rb
   require 'wiz-teleport'
   
   WizTeleport::Shell.run 'web1' do
     # write ruby code
     puts "Hello from Ruby Shell!"
     
     # running linux command
     uname "-a"
     ls "-l" 
     
   end

5. Execute WizTeleport script

   Run WizTeleport script using ruby command:

   ruby example.rb

Executing shell tasks in rakefiles is a common requirement. A shell task is actually a rake task. Here is a basic example of how to define and execute a shell task in a Rakefile.

1. Create Rakefile

   # Rakefile.rb
   require 'rake'
   require 'wiz-teleport'
   
   namespace :custom do
     desc "A custom shell task"
     shell :example, 'web1' do
       puts 'Hello from Ruby Shell!'
       uname "-a"
       ls "-l"
     end
   end

2. Execute Rake tasks

   rake custom:example

The project structure looks like this:

my_ruby_project/
│
├── inventory.yml
├── Rakefile
├── example.rb
└── ... other file

Bug reports and pull requests are welcome on GitHub at https://github.com/songgz/wiz-teleport. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.

The gem is available as open source under the terms of the MIT License.

Everyone interacting in the WizTeleport project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.