forked from I2P_Developers/i2p.i2p
Compare commits
1 Commits
build-debi
...
release-gi
Author | SHA1 | Date | |
---|---|---|---|
![]() |
62d5fab1bb |
55
docs/RELEASE-GIT-BUNDLE.md
Normal file
55
docs/RELEASE-GIT-BUNDLE.md
Normal file
@@ -0,0 +1,55 @@
|
||||
Releasing a git bundle as an I2P Torrent
|
||||
========================================
|
||||
|
||||
Git Bundles are a way of taking all(or part) the data in a Git repository and
|
||||
bundling it into a single file. The file, once obtained, can be used exactly like
|
||||
a remote git repository, and of particular use for large repositories of code with
|
||||
a long history like I2P is the fact that you can use a git bundle to "clone" a copy
|
||||
of the I2P source after downloading it reliably with Bittorrent, retaining all
|
||||
properties of the repository that was bundled. This includes things like branches and
|
||||
release tags.
|
||||
|
||||
When generating a git bundle accompanying an official I2P release, the bundle generation
|
||||
should be done immediately after tagging to ensure that the main branch is even with the
|
||||
most recent tag.
|
||||
|
||||
Torrents of the I2P git repository are generated monthly on the tenth by IDK.
|
||||
.torrent files and magnet links can be found at
|
||||
|
||||
- https://github.com/eyedeekay/i2p.i2p.git.bundles
|
||||
- https://i2pgit.org/idk/i2p.i2p.git.bundles
|
||||
- http://git.idk.i2p/idk/i2p.i2p.git.bundles
|
||||
- http://idk.i2p/bundles/
|
||||
|
||||
Git bundles generated from identical repositories will produce the same outputs. If you
|
||||
want to set up your own git bundle mirror, those scripts will help you set up so that
|
||||
your bundles are generated in sync with idk's so that we all end up sharing the same
|
||||
version of the source code.
|
||||
|
||||
To create a git bundle of i2p.i2p named i2p.i2p.bundle, run the command:
|
||||
|
||||
git bundle \
|
||||
create i2p.i2p.bundle \
|
||||
--all \
|
||||
--branches \
|
||||
--tags \
|
||||
|
||||
In order to create a torrent of i2p.i2p.bundle, you can either use the Snark WebUI, call
|
||||
run Snark manually from the terminal, or use another torrent-creation tool like mktorrent.
|
||||
|
||||
For the sake of convenience, this process can be done automatically with the
|
||||
|
||||
ant bundle
|
||||
|
||||
target. When the ant bundle target is used, the filename is i2p.i2p.{full.version}.bundle
|
||||
and the torrent is i2p.i2p.{full.version}.bundle.torrent Once the bundle is generated, it
|
||||
contains all the contents of the repository it was generated from. For i2p.i2p, this is
|
||||
about 389mb as of 2020-12-11. It is recommended that most people only seed the latest
|
||||
version of the git bundle.
|
||||
|
||||
References
|
||||
----------
|
||||
|
||||
- [The Git Book: Git Bundles](https://git-scm.com/book/en/v2/Git-Tools-Bundling)
|
||||
- [The Git Documentation: git-bundle](https://git-scm.com/docs/git-bundle)
|
||||
|
Reference in New Issue
Block a user