Skip to content

Commit

Permalink
update README
Browse files Browse the repository at this point in the history
  • Loading branch information
pete911 committed Dec 31, 2021
1 parent c23c1d5 commit 78a5bb1
Showing 1 changed file with 35 additions and 1 deletion.
36 changes: 35 additions & 1 deletion README.md
@@ -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.

0 comments on commit 78a5bb1

Please sign in to comment.