Skip to content
This repository has been archived by the owner on Jan 14, 2025. It is now read-only.

Latest commit

 

History

History
81 lines (56 loc) · 2.86 KB

README.md

File metadata and controls

81 lines (56 loc) · 2.86 KB

git-lfs-agent-rclone

============

WARNING: This branch is currently stopping development.
You can still use this, but I recommend other forks such as yaito6502's (Please check other forks by Network Graph)

============

A custom transfer agent for git-lfs that uses rclone to transfer files. This is useful if you do not want to install a git-lfs server.

Usage

Configure your local git repository as follows

$ git config lfs.standalonetransferagent rclone # <1>
$ git config lfs.customtransfer.rclone.path git-lfs-agent-rclone # <2>
$ git config lfs.customtransfer.rclone.args $DESTINATION # <3>
  1. tell git-lfs to use the transfer agent named "rclone"
  2. tell git-lfs what the name of the program is of the transfer agent
  3. $DESTINATION is the destination to which rclone will copy files tracked by git-lfs when running $ git pull and the place it will store files when running $ git push
  • NOTE: $DESTINATION can be set to anything rclone understands. As an example, source:/home/git/my-lfs-files ships files to a remote server over rclone.

Install

Download pre-built executable binary from Releases page (unzip it and move to /usr/local/bin or C:¥Windows¥System32).

Build

Clone the source and run:

$ cargo build --release # just build
$ cargo install --path . # build and install

Cross build

  • from mac (arm64), build mac x64
$ rustup target add x86_64-apple-darwin
$ cargo build --release --target=x86_64-apple-darwin

# aarch64
# rustup target add aarch64-apple-darwin
# cargo build --release --target=aarch64-apple-darwin
  • from mac, build linux

see rust-lang/rust#34282 (comment)

$ brew tap SergioBenitez/osxct
$ brew install x86_64-unknown-linux-gnu
$ brew tap messense/macos-cross-toolchains
$ brew install aarch64-unknown-linux-gnu
$ rustup target add x86_64-unknown-linux-gnu
$ rustup target add aarch64-unknown-linux-gnu
$ CARGO_TARGET_X86_64_UNKNOWN_LINUX_GNU_LINKER=x86_64-unknown-linux-gnu-gcc cargo build --release --target=x86_64-unknown-linux-gnu

$ CARGO_TARGET_AARCH64_UNKNOWN_LINUX_GNU_LINKER=aarch64-unknown-linux-gnu-gcc cargo build --release --target=aarch64-unknown-linux-gnu
  • from mac, build windows
$ brew install mingw-w64
$ rustup target add x86_64-pc-windows-gnu
$ CARGO_TARGET_X86_64_UNKNOWN_LINUX_GNU_LINKER=x86_64-w64-mingw32-gcc cargo build --release --target=x86_64-pc-windows-gnu

Acknowledgements

This project was created with fork from https://github.com/funatsufumiya/git-lfs-agent-scp, which forked from https://github.com/tdons/git-lfs-agent-scp