mirror of
				https://github.com/appleboy/scp-action.git
				synced 2025-11-04 19:21:26 +08:00 
			
		
		
		
	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:
		
							parent
							
								
									98b7132065
								
							
						
					
					
						commit
						bc835cba55
					
				
							
								
								
									
										64
									
								
								action.yml
									
									
									
									
									
								
							
							
						
						
									
										64
									
								
								action.yml
									
									
									
									
									
								
							@ -1,76 +1,76 @@
 | 
			
		||||
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"
 | 
			
		||||
inputs:
 | 
			
		||||
  host:
 | 
			
		||||
    description: "scp remote host"
 | 
			
		||||
    description: "Remote host address for SCP (e.g., example.com or 192.168.1.1)."
 | 
			
		||||
  port:
 | 
			
		||||
    description: "scp remote port"
 | 
			
		||||
    description: "Remote SSH port for SCP. Default: 22."
 | 
			
		||||
    default: "22"
 | 
			
		||||
  username:
 | 
			
		||||
    description: "scp username"
 | 
			
		||||
    description: "Username for SSH authentication."
 | 
			
		||||
  password:
 | 
			
		||||
    description: "scp password"
 | 
			
		||||
    description: "Password for SSH authentication (not recommended; use SSH keys if possible)."
 | 
			
		||||
  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"
 | 
			
		||||
  timeout:
 | 
			
		||||
    description: "timeout for ssh to remote host"
 | 
			
		||||
    description: "Timeout for establishing SSH connection to the remote host. Default: 30s."
 | 
			
		||||
    default: "30s"
 | 
			
		||||
  command_timeout:
 | 
			
		||||
    description: "timeout for scp command"
 | 
			
		||||
    description: "Timeout for the SCP command execution. Default: 10m."
 | 
			
		||||
    default: "10m"
 | 
			
		||||
  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:
 | 
			
		||||
    description: "path of ssh private key"
 | 
			
		||||
    description: "Path to the SSH private key file."
 | 
			
		||||
  passphrase:
 | 
			
		||||
    description: "ssh key passphrase"
 | 
			
		||||
    description: "Passphrase for the SSH private key, if required."
 | 
			
		||||
  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:
 | 
			
		||||
    description: "include more ciphers with use_insecure_cipher"
 | 
			
		||||
    description: "Enable additional, less secure ciphers for compatibility. Not recommended unless required."
 | 
			
		||||
  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:
 | 
			
		||||
    description: "scp file list"
 | 
			
		||||
    description: "List of files or directories to transfer (local paths)."
 | 
			
		||||
  rm:
 | 
			
		||||
    description: "remove target folder before upload data"
 | 
			
		||||
    description: "Remove the target directory on the server before uploading new data."
 | 
			
		||||
  debug:
 | 
			
		||||
    description: "enable debug message"
 | 
			
		||||
    description: "Enable debug messages for troubleshooting."
 | 
			
		||||
  strip_components:
 | 
			
		||||
    description: "remove the specified number of leading path elements"
 | 
			
		||||
    description: "Remove the specified number of leading path elements when extracting files."
 | 
			
		||||
  overwrite:
 | 
			
		||||
    description: "use --overwrite flag with tar"
 | 
			
		||||
    description: "Use the --overwrite flag with tar to overwrite existing files."
 | 
			
		||||
  tar_dereference:
 | 
			
		||||
    description: "use --dereference flag with tar"
 | 
			
		||||
    description: "Use the --dereference flag with tar to follow symlinks."
 | 
			
		||||
  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:
 | 
			
		||||
    description: "temporary path for tar file on the dest host"
 | 
			
		||||
    description: "Path to the tar executable on the destination host. Default: tar."
 | 
			
		||||
    default: "tar"
 | 
			
		||||
  proxy_host:
 | 
			
		||||
    description: "ssh proxy remote host"
 | 
			
		||||
    description: "Remote host address for SSH proxy."
 | 
			
		||||
  proxy_port:
 | 
			
		||||
    description: "ssh proxy remote port"
 | 
			
		||||
    description: "SSH proxy port. Default: 22."
 | 
			
		||||
    default: "22"
 | 
			
		||||
  proxy_username:
 | 
			
		||||
    description: "ssh proxy username"
 | 
			
		||||
    description: "Username for SSH proxy authentication."
 | 
			
		||||
  proxy_password:
 | 
			
		||||
    description: "ssh proxy password"
 | 
			
		||||
    description: "Password for SSH proxy authentication."
 | 
			
		||||
  proxy_passphrase:
 | 
			
		||||
    description: "ssh proxy key passphrase"
 | 
			
		||||
    description: "Passphrase for the SSH proxy private key, if required."
 | 
			
		||||
  proxy_timeout:
 | 
			
		||||
    description: "timeout for ssh to proxy host"
 | 
			
		||||
    description: "Timeout for establishing SSH connection to the proxy host. Default: 30s."
 | 
			
		||||
    default: "30s"
 | 
			
		||||
  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:
 | 
			
		||||
    description: "path of ssh proxy private key"
 | 
			
		||||
    description: "Path to the SSH proxy private key file."
 | 
			
		||||
  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:
 | 
			
		||||
    description: "include more ciphers with use_insecure_cipher"
 | 
			
		||||
    description: "Enable additional, less secure ciphers for the proxy connection. Not recommended unless required."
 | 
			
		||||
  curl_insecure:
 | 
			
		||||
    description: "When true, uses the --insecure option with curl for insecure downloads."
 | 
			
		||||
    default: "false"
 | 
			
		||||
 | 
			
		||||
		Loading…
	
	
			
			x
			
			
		
	
		Reference in New Issue
	
	Block a user