Skip to content

⚙️A GitHub Action for deploying code via rsync over SSH

License

Notifications You must be signed in to change notification settings

plum-umd/github-actions-rsync

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Rsync Deployments

Rsync files from a GitHub repo to a destination server over SSH

Environment variables

Variable Description
SSH_PRIVATE_KEY The private key part of an SSH key pair. The public key part should be added to the authorized_keys on the destination server.
SSH_USERNAME The username to use when connecting to the destination server
SSH_HOSTNAME The hostname of the destination server

Required arguments

Argument Description
RSYNC_OPTIONS Rsync-specific options when running the command. Exclusions, deletions, etc
RSYNC_TARGET Where to deploy the files on the server
RSYNC_SOURCE The path to the files to copy, relative to $GITHUB_WORKSPACE. If that variable is not set, you'll need to supply an absolute path here. NOTE: a trailing / deploys the contents of the directory instead of the entire directory.

Example usage

name: Create Sandbox

on: pull_request

jobs:
  deploy:
    name: Deploy
    runs-on: ubuntu-latest

    steps:
      - name: Checkout code
        uses: actions/checkout@v1

      - name: Deploy to sandbox via rsync
        uses: carlegbert/github-actions-rsync@master
        with:
          RSYNC_OPTIONS: -avzr --delete --exclude node_modules --exclude '.git*'
          RSYNC_TARGET: /path/to/target/folder/on/server
          RSYNC_SOURCE: src/public/
        env:
          SSH_PRIVATE_KEY: ${{secrets.SSH_PRIVATE_KEY}}
          SSH_USERNAME: ${{secrets.SSH_USERNAME}}
          SSH_HOSTNAME: ${{secrets.SSH_HOSTNAME}}

Disclaimer

Check your keys. Check your deployment paths. And use at your own risk!

About

⚙️A GitHub Action for deploying code via rsync over SSH

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Shell 67.5%
  • Dockerfile 32.5%