Syncing files to BunnyCDN

thumper is a self-contained binary that can place files from a local folder into a folder in a BunnyCDN Storage Zone.

I made this tool to facilitate quick and easy sync from multiple repositories/static sites that I run, into the same BunnyCDN Storage Zone. It is written in Rust to make use of the excellent ubi installer, so that I can easily install it on all the machines and systems I use with mise.

Features

• Checksumming to send only files that differ between source and destination
• Deleting files that are present in destination but not source
• Skip deleting in subtrees to easily facilitate many sites in different trees
• Rudimentary concurrency control by placing a lockfile in the storage zone to prevent concurrent deploys
• Dry runs and verbose output
• Concurrent requests to bunny.net API for both file listing and uploads
• Syncs html files last, so that other assets are present before they change

Getting thumper

The recommended method of installing is to use mise:

mise use ubi:kaaveland/thumper@latest

This downloads the latest release for your platform from the releases page, which you can also do manually.

There's a docker image available at ghcr.

It is also possible to install thumper with cargo install thumper.

Usage

The documentation has a guide for configuring a storage zone and setting up GitHub Workflows to deploy a static site.

Development

Run tests:

cargo test

Format:

cargo fmt

Lint:

cargo clippy && cargo check

Contributions & License

thumper is available under the MIT license, and contributions are welcome. Feel free to open an issue so we can have discussion before adding new code.

Planned work

• Concurrent uploads ✅
• Progress indicator ✅
• Cleaning up empty folders in the target 🤔
• Add subcommand to purge pull zone ✅
• Add subcommand to purge url ✅
• Keyring integration 🤔