Go to file
Bo-Yi Wu d0bd170212 docs: update readme. 2019-09-29 11:09:26 +08:00
.github/workflows chore: support multiple command 2019-09-29 10:55:53 +08:00
images docs: update readme. 2019-09-29 11:09:26 +08:00
Dockerfile fix: ENTRYPOINT in dockerfile 2019-09-29 10:50:09 +08:00
LICENSE Initial commit 2019-05-12 10:28:19 +08:00
README.md docs: update readme. 2019-09-29 11:09:26 +08:00
action.yml chore: add github action yaml 2019-09-29 10:34:58 +08:00
entrypoint.sh feat: initial 2019-05-15 00:31:53 +08:00

README.md

🚀 SSH for GitHub Actions

GitHub Action for executing remote ssh commands.

ssh workflow

Actions Status

Usage

Executing remote ssh commands.

- 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

output:

======CMD======
whoami
======END======
out: ***
==========================================
Successfully executed commands to all host.
==========================================

Input variables

see the 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 using password.

- 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: whoam

Using private key

- 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

- 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      

result

Multiple Hosts

  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