Watchtower for Git: automatically keep local Git repositories up to date with their remotes.
-r: Normally CrowsNest would loop forever, set this flag to run once then exit
-c: Where to look for your config.yaml file (
$HOME are automatically searched)
-v: Write a lot more info to the log, useful for finding errors
-l: Write the log to the given file instead of stdout. Should be a full path ending with the file name
CrowsNest reads its configuration from a
config.yaml using every possible option:
# The list of repositories we want to watch repositories: # The name of this repsoitory (can be anything, will show up in logs) peicecost: # The path to the root of the repo directory: D:\Code\piececost # Extra flags to provide to git when CrowsNest runs `git pull` gitpullflags: ["--verbose", "--autostash"] # How long to wait between pulls in seconds (defaults to 60), doesn't account for the time it takes to run cmds and pull interval: 900 # A command to run before pulling, if this returns a non-zero exit code, the pull will not happen prepullcmd: # The binary to execute, e.g. /bin/bash on debian for a shell script binarypath: C:\Programs\dosomething.exe # Any flags/arguments for the binary flags: ["--user", "psidex"] # Where to execute this binary workingdirectory: D:\Code\piececost\otherdir # A command to be run after pulling, same options as prepullcmd, but a non-zero exit code won't change anything postpullcmd: binarypath: C:\Programs\dosomething.exe flags: ["--user", "psidex"] workingdirectory: D:\Code\piececost\otherdir
The only required option is the
directory for each repo, and if you have set pre/post cmds then the
workingdirectory need to be valid for each of those.
Keep in mind that if you are running CrowsNest in a Docker container, all of the set directories and the pre and post pull binaries will need to be available and exectuable inside the container.
If you want to try it out in Docker there are images available on Docker Hub.
2 builds are published,
latest which is inline with the latest commit to this repository, and the versioned tags that are inline with the GitHub releases.
Example Docker Run
The crowsnest binary exists in and is run from the
/app directory in the container.
/gitrepos/Apollo in this example for no reason other than its short and descriptive, docker will create that directory automatically.
docker run -d --name crowsnest --restart unless-stopped \ -v $(pwd)/config.yaml:/app/config.yaml:ro \ -v /home/psidex/repos/Apollo:/gitrepos/Apollo \ psidex/crowsnest:latest
repositories: apollo: directory: /gitrepos/Apollo
Notice that the directory is the path inside the container, not the external path.
This would be useful if you store configuration files or content in a Git repository and want to keep your local copies up to date with the most recent versions.
Personally I use this to keep my website up to date as the files are published to GitHub from my development machine but need to be on my server to be served to the internet.
Bugs And Feature Requests
If you find a bug or would like to request a new feature please open an Issue.
Requires govvv to build correctly.
build.ps1 or the
Dockerfile for build commands.