docs: update readme.

This commit is contained in:
Bo-Yi Wu 2019-09-29 11:09:26 +08:00
parent 54eb169e33
commit d0bd170212
3 changed files with 81 additions and 102 deletions

183
README.md
View File

@ -2,131 +2,110 @@
[GitHub Action](https://developer.github.com/actions/) for executing remote ssh commands. [GitHub Action](https://developer.github.com/actions/) for executing remote ssh commands.
<img src="./images/ssh-workflow.png"> ![ssh workflow](./images/ssh-workflow.png)
[![Actions Status](https://github.com/appleboy/ssh-action/workflows/remote%20ssh%20command/badge.svg)](https://github.com/appleboy/ssh-action/actions)
## Usage ## Usage
Executing remote ssh commands. Executing remote ssh commands.
``` ```yaml
action "Executing remote ssh commands" { - name: executing remote ssh commands using password
uses = "appleboy/ssh-action@master" uses: appleboy/ssh-action@master
secrets = [ with:
"HOST", host: ${{ secrets.HOST }}
"PASSWORD", username: ${{ secrets.USERNAME }}
] password: ${{ secrets.PASSWORD }}
args = [ port: ${{ secrets.PORT }}
"--user", "actions", script: whoami
"--script", "whoami",
]
}
``` ```
## Environment variables output:
* HOST - ssh server host ```sh
* PORT - ssh server port ======CMD======
* USERNAME - ssh server username whoami
* PASSWORD - ssh server password ======END======
* KEY - ssh server private key out: ***
* SCRIPT - execute the scripts ==========================================
Successfully executed commands to all host.
==========================================
```
## Input variables
see the [action.yml](./action.yml) file for more detail imformation.
* host - scp remote host
* port - scp remote port
* username - scp username
* password - scp password
* timeout - timeout for ssh to remote host, default is `30s`
* command_timeout - timeout for scp command, default is `1m`
* key - content of ssh private key. ex raw content of ~/.ssh/id_rsa
* key_path - path of ssh private key
* script - execute commands
* script_stop - stop script after first failure
* envs - pass environment variable to shell script
* debug - enable debug mode
### Example ### Example
Executing remote ssh commands. Executing remote ssh commands using password.
``` ```yaml
action "Executing remote ssh commands" { - name: executing remote ssh commands using password
uses = "appleboy/ssh-action@master" uses: appleboy/ssh-action@master
secrets = [ with:
"PASSWORD", host: ${{ secrets.HOST }}
] username: ${{ secrets.USERNAME }}
args = [ password: ${{ secrets.PASSWORD }}
"--host", "foo.com" port: ${{ secrets.PORT }}
"--user", "bar", script: whoam
"--script", "whoami",
]
}
``` ```
Using private key Using private key
``` ```yaml
action "Support Private Key" { - name: executing remote ssh commands using ssh key
uses = "appleboy/ssh-action@master" uses: appleboy/ssh-action@master
secrets = [ with:
"HOST", host: ${{ secrets.HOST }}
"KEY", username: ${{ secrets.USERNAME }}
] key: ${{ secrets.KEY }}
args = [ port: ${{ secrets.PORT }}
"--user", "actions", script: whoami
"--script", "'ls -al'",
]
}
``` ```
Multiple Commands Multiple Commands
``` ```yaml
action "Multiple Commands" { - name: multiple command
uses = "appleboy/ssh-action@master" uses: appleboy/ssh-action@master
secrets = [ with:
"HOST", host: ${{ secrets.HOST }}
"KEY", username: ${{ secrets.USERNAME }}
] key: ${{ secrets.KEY }}
args = [ port: ${{ secrets.PORT }}
"--user", "actions", script: |
"--script", "'whoami'", whoami
"--script", "'ls -al'", ls -al
]
}
``` ```
<img src="./images/multiple-command-result.png"> ![result](./images/output-result.png)
Multiple Hosts Multiple Hosts
```diff
uses: appleboy/ssh-action@master
with:
- host: "foo.com"
+ host: "foo.com,bar.com"
username: ${{ secrets.USERNAME }}
key: ${{ secrets.KEY }}
port: ${{ secrets.PORT }}
script: |
whoami
ls -al
``` ```
action "Multiple Hosts" {
uses = "appleboy/ssh-action@master"
secrets = [
"KEY",
]
args = [
"--host", "foo.com",
"--host", "bar.com",
"--user", "actions",
"--script", "'whoami'",
"--script", "'ls -al'",
"--script", "'cat test.txt'",
]
}
```
see the detail of `drone-ssh` command
```
--ssh-key value private ssh key [$PLUGIN_SSH_KEY, $PLUGIN_KEY, $SSH_KEY, $KEY]
--key-path value, -i value ssh private key path [$PLUGIN_KEY_PATH, $SSH_KEY_PATH, $PATH]
--username value, --user value, -u value connect as user (default: "root") [$PLUGIN_USERNAME, $PLUGIN_USER, $SSH_USERNAME, $USERNAME]
--password value, -P value user password [$PLUGIN_PASSWORD, $SSH_PASSWORD, $PASSWORD]
--host value, -H value connect to host [$PLUGIN_HOST, $SSH_HOST, $HOST]
--port value, -p value connect to port (default: 22) [$PLUGIN_PORT, $SSH_PORT, $PORT]
--sync sync mode [$PLUGIN_SYNC, $SYNC]
--timeout value, -t value connection timeout (default: 0s) [$PLUGIN_TIMEOUT, $SSH_TIMEOUT, $TIMEOUT]
--command.timeout value, -T value command timeout (default: 1m0s) [$PLUGIN_COMMAND_TIMEOUT, $SSH_COMMAND_TIMEOUT, $COMMAND_TIMEOUT]
--script value, -s value execute commands [$PLUGIN_SCRIPT, $SSH_SCRIPT, $SCRIPT]
--script.stop stop script after first failure [$PLUGIN_SCRIPT_STOP, $STOP]
--proxy.ssh-key value private ssh key of proxy [$PLUGIN_PROXY_SSH_KEY, $PLUGIN_PROXY_KEY, $PROXY_SSH_KEY]
--proxy.key-path value ssh private key path of proxy [$PLUGIN_PROXY_KEY_PATH, $PROXY_SSH_KEY_PATH]
--proxy.username value connect as user of proxy (default: "root") [$PLUGIN_PROXY_USERNAME, $PLUGIN_PROXY_USER, $PROXY_SSH_USERNAME]
--proxy.password value user password of proxy [$PLUGIN_PROXY_PASSWORD, $PROXY_SSH_PASSWORD]
--proxy.host value connect to host of proxy [$PLUGIN_PROXY_HOST, $PROXY_SSH_HOST]
--proxy.port value connect to port of proxy (default: "22") [$PLUGIN_PROXY_PORT, $PROXY_SSH_PORT]
--proxy.timeout value proxy connection timeout (default: 0s) [$PLUGIN_PROXY_TIMEOUT, $PROXY_SSH_TIMEOUT]
```
## Secrets
* `PASSWORD` - ssh server password
* `KEY` - ssh server private key

Binary file not shown.

Before

Width:  |  Height:  |  Size: 104 KiB

BIN
images/output-result.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 193 KiB