suyiiyii
/
ssh-action
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: improve readability and functionality across project 

- Reformat input parameters in README.md as a table for better readability

Signed-off-by: Bo-Yi Wu <appleboy.tw@gmail.com>
This commit is contained in:
Bo-Yi Wu 2023-06-04 11:08:59 +08:00
parent f579d71942
commit c7d850f6cd
1 changed files with 31 additions and 32 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

63
README.md
View File

@ -16,38 +16,37 @@ This thing is built using [Golang](https://go.dev) and [drone-ssh](https://githu
See [action.yml](./action.yml) for more detailed information. See [action.yml](./action.yml) for more detailed information.
* `host` - ssh host | Input Parameter | Description | Default Value |
* `port` - ssh port, default is `22` |-------------------------|-----------------------------------------------------------------|---------------|
* `username` - ssh username | host | SSH host address | |
* `password` - ssh password | port | SSH port number | 22 |
* `passphrase` - the passphrase is usually to encrypt the private key | passphrase | SSH key passphrase | |
* `sync` - synchronous execution if multiple hosts, default is false | username | SSH username | |
* `timeout` - timeout for ssh to remote host, default is `30s` | password | SSH password | |
* `command_timeout` - timeout for ssh command, default is `10m` | sync | Enable synchronous execution if multiple hosts | false |
* `key` - content of ssh private key. ex raw content of ~/.ssh/id_rsa, remember include the BEGIN and END lines | use_insecure_cipher | Include more ciphers with use_insecure_cipher | false |
* `key_path` - path of ssh private key | cipher | Allowed cipher algorithms. If unspecified, a sensible default | |
* `fingerprint` - fingerprint SHA256 of the host public key, default is to skip verification | timeout | Timeout duration for SSH to host | 30s |
* `script` - execute commands | command_timeout | Timeout duration for SSH command | 10m |
* `script_stop` - stop script after first failure | key | Content of SSH private key. e.g., raw content of ~/.ssh/id_rsa | |
* `envs` - pass environment variable to shell script | key_path | Path of SSH private key | |
* `debug` - enable debug mode | fingerprint | SHA256 fingerprint of the host public key | |
* `use_insecure_cipher` - include more ciphers with use_insecure_cipher (see [#56](https://github.com/appleboy/ssh-action/issues/56)) | proxy_host | SSH proxy host | |
* `cipher` - the allowed cipher algorithms. If unspecified then a sensible | proxy_port | SSH proxy port | 22 |
* `envs_format` - flexible configuration of environment value transfer. default is `export {NAME}={VALUE}` | proxy_username | SSH proxy username | |
| proxy_password | SSH proxy password | |
SSH Proxy Setting: | proxy_passphrase | SSH proxy key passphrase | |
| proxy_timeout | Timeout for SSH to proxy host | 30s |
* `proxy_host` - proxy host | proxy_key | Content of SSH proxy private key | |
* `proxy_port` - proxy port, default is `22` | proxy_key_path | Path of SSH proxy private key | |
* `proxy_username` - proxy username | proxy_fingerprint | SHA256 fingerprint of the proxy host public key | |
* `proxy_password` - proxy password | proxy_cipher | Allowed cipher algorithms for the proxy | |
* `proxy_passphrase` - the passphrase is usually to encrypt the private key | proxy_use_insecure_cipher | Include more ciphers with use_insecure_cipher for the proxy | false |
* `proxy_timeout` - timeout for ssh to proxy host, default is `30s` | script | Execute commands | |
* `proxy_key` - content of ssh proxy private key. | script_stop | Stop script after first failure | false |
* `proxy_key_path` - path of ssh proxy private key | envs | Pass environment variables to shell script | |
* `proxy_fingerprint` - fingerprint SHA256 of the proxy host public key, default is to skip verification | envs_format | Flexible configuration of environment value transfer | |
* `proxy_use_insecure_cipher` - include more ciphers with use_insecure_cipher (see [#56](https://github.com/appleboy/ssh-action/issues/56)) | debug | Enable debug mode | false |
* `proxy_cipher` - the allowed cipher algorithms. If unspecified then a sensible
## Usage ## Usage