Files
shallow/README.md
2025-07-21 20:25:32 +02:00

21 lines
1.2 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<h2 align="center">
<img src="https://raw.githubusercontent.com/armbian/.github/master/profile/logosmall.png" alt="Armbian logo">
<br><br>
</h2>
This repository automates the preparation and distribution of **shallow Linux kernel bundles** optimized for use in CI/CD environments.
Full kernel trees can be several gigabytes in size and take considerable time and resources to clone. While shallow clones reduce this overhead, fetching them directly still places significant load on the source servers.
To address this, `kernel.org` provides [pre-generated git bundles](https://git-scm.com/docs/git-bundle), which are simple archive files downloadable via CDN. These are the recommended method for CI usage according to [kernel.org best practices](https://www.kernel.org/best-way-to-do-linux-clones-for-your-ci.html).
This repository:
- Automates downloading of upstream kernel bundles.
- Updates them from live git sources.
- Generates new, optimized shallow bundles for downstream use.
- Ensures all relevant version tags are included (including `-rc` tags).
- Executes scheduled daily updates using GitHub Actions and caching mechanisms.
> Optimized shallow bundles are ~300MB — significantly smaller than full clones and much faster to work with.