concourse-ssh-resource/README.md
2022-05-06 16:06:21 +02:00

58 lines
1.4 KiB
Markdown

# concourse-ssh-resource
A resource type for a ssh resource
## Source configuration
```
resource_types:
- name: ssh
type: registry-image
source:
repository: redxef/concourse-ssh-resource
resources:
- name: my-server
type: ssh
source:
hostname: ((my-server.hostname))
port: ((my-server.port))
user: ((my-server.user))
identity: ((my-server.identity))
hostkey: ((my-server.hostkey))
files: []
```
- hostname: *Required*. Servers hostname to connect to.
- port: *Optional*. *Default* `22`. Port the ssh server accepts connections on.
- user: *Required*. User as which to connect.
- identity: *Required*. The private key used to authenticate.
- hostkey: *Required*. The hostkey of the server.
- files: *Optional*. File paths on the remote to get/put
- directory: *Optional*. *Default* `$HOME`. The remote directory from which to base paths on.
## `check`
Check if any of the listed files on the remote server have been updated.
## `in` receive files
Receive all configured files.
## `out` push files and run command
Push all configured files to the server and run the specified command afterwards.
### Configuration
```
- put: my-server
params:
command:
- ls
- -la
```
### parameters
- workdir: *Optional*. *Default* `$HOME`. The remote directory to use as `cwd` when running commands.
- command: *Optional*. *Default* `[true]`. A command to execute on the remote, given as list.