mirror of
				https://github.com/appleboy/ssh-action.git
				synced 2025-10-31 12:43:52 +00:00 
			
		
		
		
	docs: update readme.
This commit is contained in:
		
							parent
							
								
									54eb169e33
								
							
						
					
					
						commit
						d0bd170212
					
				
							
								
								
									
										183
									
								
								README.md
									
									
									
									
									
								
							
							
						
						
									
										183
									
								
								README.md
									
									
									
									
									
								
							| @ -2,131 +2,110 @@ | |||||||
| 
 | 
 | ||||||
| [GitHub Action](https://developer.github.com/actions/) for executing remote ssh commands. | [GitHub Action](https://developer.github.com/actions/) for executing remote ssh commands. | ||||||
| 
 | 
 | ||||||
| <img src="./images/ssh-workflow.png"> |  | ||||||
|  | 
 | ||||||
|  | [](https://github.com/appleboy/ssh-action/actions) | ||||||
| 
 | 
 | ||||||
| ## Usage | ## Usage | ||||||
| 
 | 
 | ||||||
| Executing remote ssh commands. | Executing remote ssh commands. | ||||||
| 
 | 
 | ||||||
| ``` | ```yaml | ||||||
| action "Executing remote ssh commands" { | - name: executing remote ssh commands using password | ||||||
|   uses = "appleboy/ssh-action@master" |   uses: appleboy/ssh-action@master | ||||||
|   secrets = [ |   with: | ||||||
|     "HOST", |     host: ${{ secrets.HOST }} | ||||||
|     "PASSWORD", |     username: ${{ secrets.USERNAME }} | ||||||
|   ] |     password: ${{ secrets.PASSWORD }} | ||||||
|   args = [ |     port: ${{ secrets.PORT }} | ||||||
|     "--user", "actions", |     script: whoami | ||||||
|     "--script", "whoami", |  | ||||||
|   ] |  | ||||||
| } |  | ||||||
| ``` | ``` | ||||||
| 
 | 
 | ||||||
| ## Environment variables | output: | ||||||
| 
 | 
 | ||||||
| * HOST - ssh server host | ```sh | ||||||
| * PORT - ssh server port | ======CMD====== | ||||||
| * USERNAME - ssh server username | whoami | ||||||
| * PASSWORD - ssh server password | ======END====== | ||||||
| * KEY - ssh server private key | out: *** | ||||||
| * SCRIPT - execute the scripts | ========================================== | ||||||
|  | Successfully executed commands to all host. | ||||||
|  | ========================================== | ||||||
|  | ``` | ||||||
|  | 
 | ||||||
|  | ## Input variables | ||||||
|  | 
 | ||||||
|  | see the [action.yml](./action.yml) file for more detail imformation. | ||||||
|  | 
 | ||||||
|  | * host - scp remote host | ||||||
|  | * port - scp remote port | ||||||
|  | * username - scp username | ||||||
|  | * password - scp password | ||||||
|  | * timeout - timeout for ssh to remote host, default is `30s` | ||||||
|  | * command_timeout - timeout for scp command, default is `1m` | ||||||
|  | * key - content of ssh private key. ex raw content of ~/.ssh/id_rsa | ||||||
|  | * key_path - path of ssh private key | ||||||
|  | * script - execute commands | ||||||
|  | * script_stop - stop script after first failure | ||||||
|  | * envs - pass environment variable to shell script | ||||||
|  | * debug - enable debug mode | ||||||
| 
 | 
 | ||||||
| ### Example | ### Example | ||||||
| 
 | 
 | ||||||
| Executing remote ssh commands. | Executing remote ssh commands using password. | ||||||
| 
 | 
 | ||||||
| ``` | ```yaml | ||||||
| action "Executing remote ssh commands" { | - name: executing remote ssh commands using password | ||||||
|   uses = "appleboy/ssh-action@master" |   uses: appleboy/ssh-action@master | ||||||
|   secrets = [ |   with: | ||||||
|     "PASSWORD", |     host: ${{ secrets.HOST }} | ||||||
|   ] |     username: ${{ secrets.USERNAME }} | ||||||
|   args = [ |     password: ${{ secrets.PASSWORD }} | ||||||
|     "--host", "foo.com" |     port: ${{ secrets.PORT }} | ||||||
|     "--user", "bar", |     script: whoam | ||||||
|     "--script", "whoami", |  | ||||||
|   ] |  | ||||||
| } |  | ||||||
| ``` | ``` | ||||||
| 
 | 
 | ||||||
| Using private key | Using private key | ||||||
| 
 | 
 | ||||||
| ``` | ```yaml | ||||||
| action "Support Private Key" { | - name: executing remote ssh commands using ssh key | ||||||
|   uses = "appleboy/ssh-action@master" |   uses: appleboy/ssh-action@master | ||||||
|   secrets = [ |   with: | ||||||
|     "HOST", |     host: ${{ secrets.HOST }} | ||||||
|     "KEY", |     username: ${{ secrets.USERNAME }} | ||||||
|   ] |     key: ${{ secrets.KEY }} | ||||||
|   args = [ |     port: ${{ secrets.PORT }} | ||||||
|     "--user", "actions", |     script: whoami | ||||||
|     "--script", "'ls -al'", |  | ||||||
|   ] |  | ||||||
| } |  | ||||||
| ``` | ``` | ||||||
| 
 | 
 | ||||||
| Multiple Commands | Multiple Commands | ||||||
| 
 | 
 | ||||||
| ``` | ```yaml | ||||||
| action "Multiple Commands" { | - name: multiple command | ||||||
|   uses = "appleboy/ssh-action@master" |   uses: appleboy/ssh-action@master | ||||||
|   secrets = [ |   with: | ||||||
|     "HOST", |     host: ${{ secrets.HOST }} | ||||||
|     "KEY", |     username: ${{ secrets.USERNAME }} | ||||||
|   ] |     key: ${{ secrets.KEY }} | ||||||
|   args = [ |     port: ${{ secrets.PORT }} | ||||||
|     "--user", "actions", |     script: | | ||||||
|     "--script", "'whoami'", |       whoami | ||||||
|     "--script", "'ls -al'", |       ls -al | ||||||
|   ] |  | ||||||
| } |  | ||||||
| ``` | ``` | ||||||
| 
 | 
 | ||||||
| <img src="./images/multiple-command-result.png"> |  | ||||||
| 
 | 
 | ||||||
| Multiple Hosts | Multiple Hosts | ||||||
| 
 | 
 | ||||||
|  | ```diff | ||||||
|  |   uses: appleboy/ssh-action@master | ||||||
|  |   with: | ||||||
|  | -   host: "foo.com" | ||||||
|  | +   host: "foo.com,bar.com" | ||||||
|  |     username: ${{ secrets.USERNAME }} | ||||||
|  |     key: ${{ secrets.KEY }} | ||||||
|  |     port: ${{ secrets.PORT }} | ||||||
|  |     script: | | ||||||
|  |       whoami | ||||||
|  |       ls -al | ||||||
| ``` | ``` | ||||||
| action "Multiple Hosts" { |  | ||||||
|   uses = "appleboy/ssh-action@master" |  | ||||||
|   secrets = [ |  | ||||||
|     "KEY", |  | ||||||
|   ] |  | ||||||
|   args = [ |  | ||||||
|     "--host", "foo.com", |  | ||||||
|     "--host", "bar.com", |  | ||||||
|     "--user", "actions", |  | ||||||
|     "--script", "'whoami'", |  | ||||||
|     "--script", "'ls -al'", |  | ||||||
|     "--script", "'cat test.txt'", |  | ||||||
|   ] |  | ||||||
| } |  | ||||||
| ``` |  | ||||||
| 
 |  | ||||||
| see the detail of `drone-ssh` command |  | ||||||
| 
 |  | ||||||
| ``` |  | ||||||
|    --ssh-key value                           private ssh key [$PLUGIN_SSH_KEY, $PLUGIN_KEY, $SSH_KEY, $KEY] |  | ||||||
|    --key-path value, -i value                ssh private key path [$PLUGIN_KEY_PATH, $SSH_KEY_PATH, $PATH] |  | ||||||
|    --username value, --user value, -u value  connect as user (default: "root") [$PLUGIN_USERNAME, $PLUGIN_USER, $SSH_USERNAME, $USERNAME] |  | ||||||
|    --password value, -P value                user password [$PLUGIN_PASSWORD, $SSH_PASSWORD, $PASSWORD] |  | ||||||
|    --host value, -H value                    connect to host [$PLUGIN_HOST, $SSH_HOST, $HOST] |  | ||||||
|    --port value, -p value                    connect to port (default: 22) [$PLUGIN_PORT, $SSH_PORT, $PORT] |  | ||||||
|    --sync                                    sync mode [$PLUGIN_SYNC, $SYNC] |  | ||||||
|    --timeout value, -t value                 connection timeout (default: 0s) [$PLUGIN_TIMEOUT, $SSH_TIMEOUT, $TIMEOUT] |  | ||||||
|    --command.timeout value, -T value         command timeout (default: 1m0s) [$PLUGIN_COMMAND_TIMEOUT, $SSH_COMMAND_TIMEOUT, $COMMAND_TIMEOUT] |  | ||||||
|    --script value, -s value                  execute commands [$PLUGIN_SCRIPT, $SSH_SCRIPT, $SCRIPT] |  | ||||||
|    --script.stop                             stop script after first failure [$PLUGIN_SCRIPT_STOP, $STOP] |  | ||||||
|    --proxy.ssh-key value                     private ssh key of proxy [$PLUGIN_PROXY_SSH_KEY, $PLUGIN_PROXY_KEY, $PROXY_SSH_KEY] |  | ||||||
|    --proxy.key-path value                    ssh private key path of proxy [$PLUGIN_PROXY_KEY_PATH, $PROXY_SSH_KEY_PATH] |  | ||||||
|    --proxy.username value                    connect as user of proxy (default: "root") [$PLUGIN_PROXY_USERNAME, $PLUGIN_PROXY_USER, $PROXY_SSH_USERNAME] |  | ||||||
|    --proxy.password value                    user password of proxy [$PLUGIN_PROXY_PASSWORD, $PROXY_SSH_PASSWORD] |  | ||||||
|    --proxy.host value                        connect to host of proxy [$PLUGIN_PROXY_HOST, $PROXY_SSH_HOST] |  | ||||||
|    --proxy.port value                        connect to port of proxy (default: "22") [$PLUGIN_PROXY_PORT, $PROXY_SSH_PORT] |  | ||||||
|    --proxy.timeout value                     proxy connection timeout (default: 0s) [$PLUGIN_PROXY_TIMEOUT, $PROXY_SSH_TIMEOUT] |  | ||||||
| ``` |  | ||||||
| 
 |  | ||||||
| ## Secrets |  | ||||||
| 
 |  | ||||||
| * `PASSWORD` - ssh server password |  | ||||||
| * `KEY` - ssh server private key |  | ||||||
|  | |||||||
										
											Binary file not shown.
										
									
								
							| Before Width: | Height: | Size: 104 KiB | 
							
								
								
									
										
											BIN
										
									
								
								images/output-result.png
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										
											BIN
										
									
								
								images/output-result.png
									
									
									
									
									
										Normal file
									
								
							
										
											Binary file not shown.
										
									
								
							| After Width: | Height: | Size: 193 KiB | 
		Loading…
	
	
			
			x
			
			
		
	
		Reference in New Issue
	
	Block a user