Overview
Simple project for convert old repository for using git-lfs feature.
How to use
Run from binaries
For quick run you need:
-
Install Java 1.8 or later
-
Download binaries archive from: https://github.com/bozaro/git-lfs-migrate/releases/latest
-
After unpacking archive you can run server executing:
java -jar build/deploy/git-lfs-migrate.jar -s source-repo.git -d target-repo.git -l http://test:test@lfs-server/ "*.psd" "*.zip" "*.bin"
For example, you can convert bozaro/git-lfs-migrate to bozaro/git-lfs-migrate-converted by commands:
#!/bin/bash
# Clone original repository
git clone --mirror [email protected]:bozaro/git-lfs-migrate.git
# Convert repository with moving .md and .jar file to LFS
#
# Usage: <main class> [options] LFS file glob patterns
# Options:
# -c, --cache
# Source repository
# Default: .
# --check-lfs
# Check LFS server settings and exit
# Default: false
# * -d, --destination
# Destination repository
# -g, --git
# GIT repository url (ignored with --lfs parameter)
# -h, --help
# Show help
# Default: false
# -l, --lfs
# LFS server url (can be determinated by --git paramter)
# * -s, --source
# Source repository
# -u, --upload-threads
# HTTP upload thread count
# Default: 4
# -t, --write-threads
# IO thread count
# Default: 2
# --glob-file
# File containing glob patterns
java -jar git-lfs-migrate.jar \
-s git-lfs-migrate.git \
-d git-lfs-migrate-converted.git \
-g [email protected]:bozaro/git-lfs-migrate-converted.git \
"*.md" \
"*.jar"
# Push coverted repository to new repository
cd git-lfs-migrate-converted.git
git fsck && git push --mirror [email protected]:bozaro/git-lfs-migrate-converted.git
After that you with have:
- New repository bozaro/git-lfs-migrate-converted
- All *.md and *.jar in this repository will stored in LFS storage
- All revisions on this repository will have modified or created .gitattributes file with new lines like:
*.md filter=lfs diff=lfs merge=lfs -text
*.jar filter=lfs diff=lfs merge=lfs -text
Supported Git url formats:
- https://user:[email protected]/foo/bar.git
- http://user:[email protected]/foo/bar.git
- git://user:[email protected]/foo/bar.git
- ssh://[email protected]/foo/bar.git
- [email protected]:foo/bar.git
Build from sources
To build from sources you need install JDK 1.8 or later and run build script.
For Linux:
./gradlew deployZip
For Windows:
call gradlew.bat deployZip
When build completes you can convert repository executing:
java -jar build/deploy/git-lfs-migrate.jar -s source-repo.git -d target-repo.git -l http://test:test@lfs-server/ "*.psd" "*.zip" "*.bin"