Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
pete911
committed
Dec 31, 2021
1 parent
c23c1d5
commit 78a5bb1
Showing
1 changed file
with
35 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,2 +1,36 @@ | ||
# hcr | ||
helm chart releaser | ||
Helm chart releaser is a tool to help to host helm repository as GitHub page, where packaged chart is uploaded as | ||
a release asset and the index file is hosted on GitHub page. This tool is very similar to | ||
[helm chart releaser](https://github.com/helm/chart-releaser), but is simpler and works with private repos as well. | ||
|
||
## Install | ||
``` | ||
git clone https://github.com/pete911/hcr.git | ||
cd hcr | ||
go install | ||
``` | ||
|
||
## Use | ||
``` | ||
Usage of hcr: | ||
-charts-dir string | ||
The Helm charts location (default "charts") | ||
-pages-branch string | ||
The GitHub pages branch (default "gh-pages") | ||
-remote string | ||
The Git remote for the GitHub Pages branch (default "origin") | ||
-token string | ||
GitHub Auth Token | ||
``` | ||
|
||
Simply run `hcr` inside the project, this will: | ||
- check if `-pages-branch` exists | ||
- packages helm charts from `-charts-dir` to current directory as `<name>-<version>.tgz` | ||
- adds `-pages-branch` git worktree to temp. directory | ||
- creates release per chart in `-charts-dir` and uploads packaged chart as asset to that release | ||
- update index file with the released charts, commit and push index file to `-pages-branch` | ||
|
||
This makes it simpler and easier than [helm chart releaser](https://github.com/helm/chart-releaser), because we are not | ||
reading from GitHub pages (or downloading releases) over http, so we don't face issues with restrictions on private | ||
repositories (autogenerated pages link, authentication, ...), caching (GitHub pages are not updated immediately with | ||
the latest changes) etc. |