Watch local git repositories, keep in sync with remote and run commands.
gw
is a lightweight binary that manages a simple pull-based continuous deployment for you. It watches a local git repository, fetches if the remote changes, and builds or deploys your code. Current CD solutions either lock you into proprietary software (e.g. Netlify or Vercel) or complicated to run and manage (e.g. ArgoCD). gw
is a service that can run everywhere (even behind NAT or VPN), synchronizes code with your remote and deploys immediately, saving your developers time and energy.
Features of gw
:
- lightweight: it is only a 2.5MB binary (~7MB with git and ssh statically built-in)
- runs anywhere: use it on baremetal, systemd or docker
- open source: written entirely in Rust, you can build it from source in a few minutes
- pull-based: works on any network, even behind a NAT or VPN
- flexible: build, deploy, restart or anything you can imagine
To get started download the gw
binary from releases or install with cargo:
cargo binstall gw-bin
# or
cargo install gw-bin
gw
is a simple program, that you can use to pull changes from a remote repository and run scripts on the change.
First, make sure, that gw
is installed successfully and is in your PATH:
$ gw --version
0.3.1
The other necessary part is a git repository to which you have pull access. It is recommended to use a repository that you know, but if you don't have one at hand, you can use the daniel7grant/time repository. This is an example repository that is updated in every minute, so it is useful to test the auto update of gw
. First clone this repository (if you are using your own, clone again), and enter the cloned directory:
git clone https://github.com/daniel7grant/time.git
cd time
To get started, point gw
to this local repository. By default it pulls the changes every minute. We can add the --verbose
or -v
flag to see when the changes occur:
gw . -v
If you are using your own repository, create a commit in a different place, and see how it gets automatically pulled (in the case of the time
repo, there is a commit every minute). The verbose logs should print that a git pull happened:
$ gw . -v
# ...
2024-03-10T14:48:13.447Z DEBUG [gw_bin::checks::git::repository] Checked out fc23d21 on branch main.
2024-03-10T14:48:13.447Z INFO [gw_bin::start] There are updates, pulling.
Also check the files or the git log
to see that it the repository has been updated:
cat DATETIME # it should contain the latest time
git log -1 # it should be a commit in the last minute
Pulling files automatically is useful but the --script
or -s
flag unlocks gw
's potential: it can run any kind of custom script if there are any changes. For a simple example, we can print the content of a file to the log with cat
:
gw . -v --script 'cat DATETIME'
This will run every time there is a new commit, and after the pull it will print the file contents. You can see that the results are printed in the log:
$ gw . -v --script 'cat DATETIME'
# ...
2024-03-10T15:04:37.740Z INFO [gw_bin::start] There are updates, running scripts.
2024-03-10T15:04:37.740Z DEBUG [gw_bin::actions::script] Running script: cat DATETIME in directory /home/grant/Development/quick/time.
2024-03-10T15:04:37.742Z DEBUG [gw_bin::actions::script] Command success, output:
2024-03-10T15:04:37.742Z DEBUG [gw_bin::actions::script] 2024-03-10T15:04:01+0000
You can add multiple scripts, which will run one after another. Use these scripts to build source files, restarts deployments and anything else that you can imagine.
If you like gw
, there are multiple ways to use it for real-life use-cases.
If you want to put the gw
script in the background, you can:
- wrap into a systemd unit, if you want to manage it with a single file;
- start in a docker container, if you already use Docker in your workflow;
- or run periodically with cron, if you don't have shell access to the server.
If you are interested in some ideas on how to use gw
:
- if you only need to pull files, see PHP guide;
- if you are using a compiled language, see Guide for compiled languages for example on restarting a process;
- if you want to use
gw
with adocker-compose.yaml
, see Guide for docker-compose; - if you want to easily manage configuration files as GitOps, see Configuration guide;
- for a full-blown example, check out Netlify;
- and many other things, for the incomplete list guides page.