docs: refine input descriptions for clarity and user guidance

- Improve and clarify input descriptions for better usability and understanding
- Add guidance on defaults, security considerations, and example values in several input descriptions
- Reword descriptions to be more user-friendly and precise throughout configuration

Signed-off-by: appleboy <appleboy.tw@gmail.com>
This commit is contained in:
appleboy 2025-04-27 11:15:08 +08:00
parent 98b7132065
commit bc835cba55
No known key found for this signature in database

View File

@ -1,76 +1,76 @@
name: "SCP Command to Transfer Files" name: "SCP Command to Transfer Files"
description: "How to Use SCP Command to Transfer Files/Folders in Linux" description: "Easily transfer files and folders using the SCP command in Linux."
author: "Bo-Yi Wu" author: "Bo-Yi Wu"
inputs: inputs:
host: host:
description: "scp remote host" description: "Remote host address for SCP (e.g., example.com or 192.168.1.1)."
port: port:
description: "scp remote port" description: "Remote SSH port for SCP. Default: 22."
default: "22" default: "22"
username: username:
description: "scp username" description: "Username for SSH authentication."
password: password:
description: "scp password" description: "Password for SSH authentication (not recommended; use SSH keys if possible)."
protocol: protocol:
description: "The IP protocol to use. Valid values are 'tcp'. 'tcp4' or 'tcp6'. Default to tcp." description: "IP protocol to use. Valid values: 'tcp', 'tcp4', or 'tcp6'. Default: tcp."
default: "tcp" default: "tcp"
timeout: timeout:
description: "timeout for ssh to remote host" description: "Timeout for establishing SSH connection to the remote host. Default: 30s."
default: "30s" default: "30s"
command_timeout: command_timeout:
description: "timeout for scp command" description: "Timeout for the SCP command execution. Default: 10m."
default: "10m" default: "10m"
key: key:
description: "content of ssh private key. ex raw content of ~/.ssh/id_rsa" description: "Content of the SSH private key (e.g., the raw content of ~/.ssh/id_rsa)."
key_path: key_path:
description: "path of ssh private key" description: "Path to the SSH private key file."
passphrase: passphrase:
description: "ssh key passphrase" description: "Passphrase for the SSH private key, if required."
fingerprint: fingerprint:
description: "fingerprint SHA256 of the host public key, default is to skip verification" description: "SHA256 fingerprint of the host's public key. If not set, host key verification is skipped (not recommended for production)."
use_insecure_cipher: use_insecure_cipher:
description: "include more ciphers with use_insecure_cipher" description: "Enable additional, less secure ciphers for compatibility. Not recommended unless required."
target: target:
description: "target path on the server, must be a directory path." description: "Target directory path on the remote server. Must be a directory."
source: source:
description: "scp file list" description: "List of files or directories to transfer (local paths)."
rm: rm:
description: "remove target folder before upload data" description: "Remove the target directory on the server before uploading new data."
debug: debug:
description: "enable debug message" description: "Enable debug messages for troubleshooting."
strip_components: strip_components:
description: "remove the specified number of leading path elements" description: "Remove the specified number of leading path elements when extracting files."
overwrite: overwrite:
description: "use --overwrite flag with tar" description: "Use the --overwrite flag with tar to overwrite existing files."
tar_dereference: tar_dereference:
description: "use --dereference flag with tar" description: "Use the --dereference flag with tar to follow symlinks."
tar_tmp_path: tar_tmp_path:
description: "temporary path for tar file on the dest host" description: "Temporary path for the tar file on the destination host."
tar_exec: tar_exec:
description: "temporary path for tar file on the dest host" description: "Path to the tar executable on the destination host. Default: tar."
default: "tar" default: "tar"
proxy_host: proxy_host:
description: "ssh proxy remote host" description: "Remote host address for SSH proxy."
proxy_port: proxy_port:
description: "ssh proxy remote port" description: "SSH proxy port. Default: 22."
default: "22" default: "22"
proxy_username: proxy_username:
description: "ssh proxy username" description: "Username for SSH proxy authentication."
proxy_password: proxy_password:
description: "ssh proxy password" description: "Password for SSH proxy authentication."
proxy_passphrase: proxy_passphrase:
description: "ssh proxy key passphrase" description: "Passphrase for the SSH proxy private key, if required."
proxy_timeout: proxy_timeout:
description: "timeout for ssh to proxy host" description: "Timeout for establishing SSH connection to the proxy host. Default: 30s."
default: "30s" default: "30s"
proxy_key: proxy_key:
description: "content of ssh proxy private key. ex raw content of ~/.ssh/id_rsa" description: "Content of the SSH proxy private key (e.g., the raw content of ~/.ssh/id_rsa)."
proxy_key_path: proxy_key_path:
description: "path of ssh proxy private key" description: "Path to the SSH proxy private key file."
proxy_fingerprint: proxy_fingerprint:
description: "fingerprint SHA256 of the host public key, default is to skip verification" description: "SHA256 fingerprint of the proxy host's public key. If not set, host key verification is skipped (not recommended for production)."
proxy_use_insecure_cipher: proxy_use_insecure_cipher:
description: "include more ciphers with use_insecure_cipher" description: "Enable additional, less secure ciphers for the proxy connection. Not recommended unless required."
curl_insecure: curl_insecure:
description: "When true, uses the --insecure option with curl for insecure downloads." description: "When true, uses the --insecure option with curl for insecure downloads."
default: "false" default: "false"