23 Commits

Author SHA1 Message Date
a2d5832a97 chore: update drone-ssh version
Some checks failed
remote ssh command / Build (push) Failing after 4s
2019-09-29 12:11:00 +08:00
49e81b4a32 docs: add stop script if command error 2019-09-29 12:02:21 +08:00
04535147e0 chore: stop script 2019-09-29 11:49:01 +08:00
533a062133 chore: update docs 2019-09-29 11:45:42 +08:00
ef697c0ac1 docs: add Pass environment variable to shell script 2019-09-29 11:23:40 +08:00
480ff5e05e chore: add FOO envs 2019-09-29 11:19:40 +08:00
ccece0c886 chore: add envs 2019-09-29 11:18:42 +08:00
7e0bb7cd75 chore: add script_stop 2019-09-29 11:17:11 +08:00
dc9ae8e2e3 chore: add some example 2019-09-29 11:16:09 +08:00
d0bd170212 docs: update readme. 2019-09-29 11:09:26 +08:00
54eb169e33 chore: support multiple command 2019-09-29 10:55:53 +08:00
1a6f86cece chore: support multiple command 2019-09-29 10:53:17 +08:00
917a1df2a4 chore: executing remote ssh commands using ssh key 2019-09-29 10:52:20 +08:00
b87ddeff00 fix: ENTRYPOINT in dockerfile 2019-09-29 10:50:09 +08:00
4f7d6491f3 chore: update action image 2019-09-29 10:46:23 +08:00
1f7ce4dfab chore: rename job title. 2019-09-29 10:45:29 +08:00
46adad98f2 chore: try the drone-ssh latest version 2019-09-29 10:44:56 +08:00
215a0580d7 chore: initial github actions 2019-09-29 10:43:33 +08:00
b305709c8d chore: remove github action label 2019-09-29 10:36:34 +08:00
fd26aa3ca7 chore: add github action yaml 2019-09-29 10:34:58 +08:00
c94d94aab3 bump to 0.0.2
Signed-off-by: Bo-Yi Wu <appleboy.tw@gmail.com>
2019-05-16 10:07:59 +08:00
592a3daf58 upgrade to 1.5.1
Signed-off-by: Bo-Yi Wu <appleboy.tw@gmail.com>
2019-05-16 10:07:41 +08:00
5942cfaf03 update
Signed-off-by: Bo-Yi Wu <appleboy.tw@gmail.com>
2019-05-15 10:58:11 +08:00
7 changed files with 207 additions and 153 deletions

45
.github/main.workflow vendored
View File

@ -1,45 +0,0 @@
workflow "Remote ssh commands" {
on = "push"
resolves = [
"Executing remote ssh commands",
"Support Private Key",
"Multiple Commands",
]
}
action "Executing remote ssh commands" {
uses = "appleboy/ssh-action@master"
secrets = [
"HOST",
"PASSWORD",
]
args = [
"--user", "actions",
"--script", "whoami",
]
}
action "Support Private Key" {
uses = "appleboy/ssh-action@master"
secrets = [
"HOST",
"KEY",
]
args = [
"--user", "actions",
"--script", "'ls -al'",
]
}
action "Multiple Commands" {
uses = "appleboy/ssh-action@master"
secrets = [
"HOST",
"KEY",
]
args = [
"--user", "actions",
"--script", "'whoami'",
"--script", "'ls -al'",
]
}

60
.github/workflows/ci.yml vendored Normal file
View File

@ -0,0 +1,60 @@
name: remote ssh command
on: [push]
jobs:
build:
name: Build
runs-on: ubuntu-latest
steps:
- 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
- name: executing remote ssh commands using ssh key
uses: appleboy/ssh-action@master
with:
host: ${{ secrets.HOST }}
username: ${{ secrets.USERNAME }}
key: ${{ secrets.KEY }}
port: ${{ secrets.PORT }}
script: whoami
- name: multiple command
uses: appleboy/ssh-action@master
with:
host: ${{ secrets.HOST }}
username: ${{ secrets.USERNAME }}
key: ${{ secrets.KEY }}
port: ${{ secrets.PORT }}
script: |
whoami
ls -al
# - name: stop script if command error
# uses: appleboy/ssh-action@master
# with:
# host: ${{ secrets.HOST }}
# username: ${{ secrets.USERNAME }}
# key: ${{ secrets.KEY }}
# port: ${{ secrets.PORT }}
# script_stop: true
# script: "mkdir abc/def,ls -al"
- name: pass environment
uses: appleboy/ssh-action@master
env:
FOO: "BAR"
with:
host: ${{ secrets.HOST }}
username: ${{ secrets.USERNAME }}
key: ${{ secrets.KEY }}
port: ${{ secrets.PORT }}
envs: FOO
script: |
echo "I am $FOO"
echo "I am $BAR"

View File

@ -1,15 +1,4 @@
FROM appleboy/drone-ssh:1.5.0-linux-amd64
# Github labels
LABEL "com.github.actions.name"="SSH Commands"
LABEL "com.github.actions.description"="Executing remote ssh commands"
LABEL "com.github.actions.icon"="terminal"
LABEL "com.github.actions.color"="gray-dark"
LABEL "repository"="https://github.com/appleboy/ssh-action"
LABEL "homepage"="https://github.com/appleboy"
LABEL "maintainer"="Bo-Yi Wu <appleboy.tw@gmail.com>"
LABEL "version"="0.0.1"
FROM appleboy/drone-ssh:1.5.2-linux-amd64
ADD entrypoint.sh /entrypoint.sh
RUN chmod +x /entrypoint.sh

203
README.md
View File

@ -2,130 +2,141 @@
[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
Executing remote ssh commands.
```
action "Executing remote ssh commands" {
uses = "appleboy/ssh-action@master"
secrets = [
"HOST",
"PASSWORD",
]
args = [
"--user", "actions",
"--script", "whoami",
]
}
```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
```
## Environment variables
output:
* HOST - ssh server host
* PORT - ssh server port
* USERNAME - ssh server username
* PASSWORD - ssh server password
* KEY - ssh server private key
* SCRIPT - execute the scripts
```sh
======CMD======
whoami
======END======
out: ***
==========================================
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
Executing remote ssh commands.
Executing remote ssh commands using password.
```
action "Executing remote ssh commands" {
uses = "appleboy/ssh-action@master"
secrets = [
"PASSWORD",
]
args = [
"--host", "foo.com"
"--user", "bar",
"--script", "whoami",
]
}
```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
```
Using private key
```
action "Support Private Key" {
uses = "appleboy/ssh-action@master"
secrets = [
"HOST",
"KEY",
]
args = [
"--user", "actions",
"--script", "'ls -al'",
]
}
```yaml
- name: executing remote ssh commands using ssh key
uses: appleboy/ssh-action@master
with:
host: ${{ secrets.HOST }}
username: ${{ secrets.USERNAME }}
key: ${{ secrets.KEY }}
port: ${{ secrets.PORT }}
script: whoami
```
Multiple Commands
```
action "Multiple Commands" {
uses = "appleboy/ssh-action@master"
secrets = [
"HOST",
"KEY",
]
args = [
"--user", "actions",
"--script", "'whoami'",
"--script", "'ls -al'",
]
}
```yaml
- name: multiple command
uses: appleboy/ssh-action@master
with:
host: ${{ secrets.HOST }}
username: ${{ secrets.USERNAME }}
key: ${{ secrets.KEY }}
port: ${{ secrets.PORT }}
script: |
whoami
ls -al
```
<img src="./images/multiple-command-result.png">
![result](./images/output-result.png)
Multiple Hosts
```
action "Multiple Hosts" {
uses = "appleboy/ssh-action@master"
secrets = [
"KEY",
]
args = [
"--host", "foo.com",
"--host", "bar.com",
"--user", "actions",
"--script", "'whoami'",
"--script", "'ls -al'",
]
}
```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
```
see the detail of `drone-ssh` command
Pass environment variable to shell script
```
--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]
```diff
uses: appleboy/ssh-action@master
+ env:
+ FOO: "BAR"
with:
host: ${{ secrets.HOST }}
username: ${{ secrets.USERNAME }}
key: ${{ secrets.KEY }}
port: ${{ secrets.PORT }}
+ envs: FOO
script: |
echo "I am $FOO"
echo "I am $BAR"
```
## Secrets
Stop script after first failure. ex: missing `abc` folder
* `PASSWORD` - ssh server password
* `KEY` - ssh server private key
```yaml
- name: stop script if command error
uses: appleboy/ssh-action@master
with:
host: ${{ secrets.HOST }}
username: ${{ secrets.USERNAME }}
key: ${{ secrets.KEY }}
port: ${{ secrets.PORT }}
script_stop: true
script: "mkdir abc/def,ls -al"
```

39
action.yml Normal file
View File

@ -0,0 +1,39 @@
name: 'SSH Remote Commands'
description: 'Executing remote ssh commands'
author: 'Bo-Yi Wu'
inputs:
host:
description: 'ssh remote host'
port:
description: 'ssh remote port'
username:
description: 'ssh username'
password:
description: 'ssh password'
timeout:
description: 'timeout for ssh to remote host'
default: "30s"
command_timeout:
description: 'timeout for ssh command'
default: "1m"
key:
description: 'content of ssh private key. ex raw content of ~/.ssh/id_rsa'
key_path:
description: 'path of ssh private key'
script:
description: 'execute commands'
script_stop:
description: 'stop script after first failure'
default: false
envs:
description: 'pass environment variable to shell script'
debug:
description: 'enable debug mode'
default: false
runs:
using: 'docker'
image: 'Dockerfile'
branding:
icon: 'terminal'
color: 'gray-dark'

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