drone-ssh/DOCS.md

date	title	author	tags	repo	logo	image
2017-01-29T00:00:00+00:00	SSH	appleboy	publish ssh	appleboy/drone-ssh	term.svg	appleboy/drone-ssh

Use the SSH plugin to execute commands on a remote server. The below pipeline configuration demonstrates simple usage:

pipeline:
  ssh:
    image: appleboy/drone-ssh
    host: foo.com
    user: root
    password: 1234
    port: 22
    script:
      - echo hello
      - echo world

Example configuration in your .drone.yml file for multiple hosts:

pipeline:
  ssh:
    image: appleboy/drone-ssh
    host:
+    - foo.com
+    - bar.com
    user: root
    port: 22
    script:
      - echo hello
      - echo world

Example configuration for success build:

pipeline:
  ssh:
    image: appleboy/drone-ssh
    host: foo.com
    user: root
    password: 1234
    port: 22
    script:
      - echo hello
      - echo world
+   when:
+     status: success

Example configuration for tag event:

pipeline:
  ssh:
    image: appleboy/drone-ssh
    host: foo.com
    user: root
    password: 1234
    port: 22
    script:
      - echo hello
      - echo world
+   when:
+     status: success
+     event: tag

Parameter Reference

host

target hostname or IP

port

ssh port of target host

user

account for target host user

password

password for target host user

key

plain text of user private key

script

execute commands on a remote server

timeout

Timeout is the maximum amount of time for the TCP connection to establish.