Shell Agent

Shell Agent, is a program installed on remote host, help you to execute shell command on the remote host.

This agent can also help to transport file to/from remote host.

Install

go build
./shell_agent

Now you can visit the agent via 8080 port.

The usage is simple:

Shell Agent.

        Usage:
        shell_agent [--cnf=<path>] [--addr=<addr>]
        shell_agent -h | --help
        shell_agent --version

        Options:
        --cnf=<path>  config file path [default: ].
        --addr=<addr>  config file path [default: :8080].

Execute command

There are two ways to execute command on remote host: sync(is default) and async.

sync

Type the following curl request will hang and wait for sleep 5 to finish.

curl -d '{"cmd":"sleep 5 && echo test sleep"}' http://127.0.0.1:8080/api/v1/cmd/run
{"errno":0,"error":"succeed","data":{"id":"bda8616a-0179-4c54-468b-918e15112006","status":"finished","error":"","cmd":"sleep 600 \u0026\u0026 echo test sleep","env":null,"stdout":"test sleep\n","stderr":"","exit_code":0,"pid":10266,"create_time":"2018-02-25T19:01:32.870915989+08:00","finish_time":"2018-02-25T19:11:32.875958476+08:00"}}

Take a careful look at the response:

{
    "errno": 0, 
    "error": "succeed", 
    "data": {
        "id": "bda8616a-0179-4c54-468b-918e15112006", 
        "status": "finished", 
        "error": "", 
        "cmd": "sleep 600 && echo test sleep", 
        "env": null, 
        "stdout": "test sleep\n", 
        "stderr": "", 
        "exit_code": 0, 
        "pid": 10266, 
        "create_time": "2018-02-25T19:01:32.870915989+08:00", 
        "finish_time": "2018-02-25T19:11:32.875958476+08:00"
    }
}

The returned http response contain:

id: UUID of the job .
status: Status of the job, maybe running, finished(the command exited with zero exit code), failed(the command failed to start, or be killed, or exited with non-zero exit code), canceled(canceled by user)
error: The reason why the job failed.
stdout: Stdout of the command.
stderr: Stderr of the command.
exit_code: Exit code of the command.

async

Type the following curl request will not hang and return immediately. The returned http response only contain the job id, which can be use to query job progress.

curl -d '{"cmd":"sleep 600 && echo test sleep", "async":true}' http://127.0.0.1:8080/api/v1/cmd/run  
{"errno":0,"error":"succeed","data":{"id":"3dcb8bb9-5aab-4a5c-7575-fa11294d2dff","create_time":"2018-02-25T19:38:38.539287299+08:00"}}

The returned http response contain:

id: UUID of the job .

Query a job

You can use the job id to query the job info:

curl http://127.0.0.1:8080/api/v1/cmd/query?id=3dcb8bb9-5aab-4a5c-7575-fa11294d2dff

Cancel a job

You can cancel a runnning job:

curl http://127.0.0.1:8080/api/v1/cmd/cancel?id=3dcb8bb9-5aab-4a5c-7575-fa11294d2dff

List all command jobs

You can get all jobs ordered by create time desc:

curl http://127.0.0.1:8080/api/v1/cmd/list

flike/shell-agent