|
|
|
@ -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">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
[](https://github.com/appleboy/ssh-action/actions)
|
|
|
|
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
|
|
|
|
Executing remote ssh commands.
|
|
|
|
Executing remote ssh commands.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
```yaml
|
|
|
|
|
|
|
|
- name: executing remote ssh commands using password
|
|
|
|
|
|
|
|
uses: appleboy/ssh-action@master
|
|
|
|
|
|
|
|
with:
|
|
|
|
|
|
|
|
host: ${{ secrets.HOST }}
|
|
|
|
|
|
|
|
username: ${{ secrets.USERNAME }}
|
|
|
|
|
|
|
|
password: ${{ secrets.PASSWORD }}
|
|
|
|
|
|
|
|
port: ${{ secrets.PORT }}
|
|
|
|
|
|
|
|
script: whoami
|
|
|
|
```
|
|
|
|
```
|
|
|
|
action "Executing remote ssh commands" {
|
|
|
|
|
|
|
|
uses = "appleboy/ssh-action@master"
|
|
|
|
output:
|
|
|
|
secrets = [
|
|
|
|
|
|
|
|
"HOST",
|
|
|
|
```sh
|
|
|
|
"PASSWORD",
|
|
|
|
======CMD======
|
|
|
|
]
|
|
|
|
whoami
|
|
|
|
args = [
|
|
|
|
======END======
|
|
|
|
"--user", "actions",
|
|
|
|
out: ***
|
|
|
|
"--script", "whoami",
|
|
|
|
==========================================
|
|
|
|
]
|
|
|
|
Successfully executed commands to all host.
|
|
|
|
}
|
|
|
|
==========================================
|
|
|
|
```
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## Environment variables
|
|
|
|
## Input variables
|
|
|
|
|
|
|
|
|
|
|
|
* HOST - ssh server host
|
|
|
|
see the [action.yml](./action.yml) file for more detail imformation.
|
|
|
|
* PORT - ssh server port
|
|
|
|
|
|
|
|
* USERNAME - ssh server username
|
|
|
|
|
|
|
|
* PASSWORD - ssh server password
|
|
|
|
|
|
|
|
* KEY - ssh server private key
|
|
|
|
|
|
|
|
* SCRIPT - execute the scripts
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Example
|
|
|
|
* 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
|
|
|
|
|
|
|
|
|
|
|
|
Executing remote ssh commands.
|
|
|
|
### Example
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
Executing remote ssh commands using password.
|
|
|
|
action "Executing remote ssh commands" {
|
|
|
|
|
|
|
|
uses = "appleboy/ssh-action@master"
|
|
|
|
```yaml
|
|
|
|
secrets = [
|
|
|
|
- name: executing remote ssh commands using password
|
|
|
|
"PASSWORD",
|
|
|
|
uses: appleboy/ssh-action@master
|
|
|
|
]
|
|
|
|
with:
|
|
|
|
args = [
|
|
|
|
host: ${{ secrets.HOST }}
|
|
|
|
"--host", "foo.com"
|
|
|
|
username: ${{ secrets.USERNAME }}
|
|
|
|
"--user", "bar",
|
|
|
|
password: ${{ secrets.PASSWORD }}
|
|
|
|
"--script", "whoami",
|
|
|
|
port: ${{ secrets.PORT }}
|
|
|
|
]
|
|
|
|
script: whoam
|
|
|
|
}
|
|
|
|
|
|
|
|
```
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
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">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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
|
|
|
|
|
|
|
|
|
Bo-Yi Wu
5 years ago
