OpenZiti Helm Charts

This is a repository of Helm charts for use with OpenZiti on Kubernetes.

These files are published from a GitHub repo as a GitHub pages site here.

Use this Repo

Subscribe

$ helm repo add openziti https://docs.openziti.io/helm-charts/
"openziti" has been added to your repositories                         

Search for available charts in this repo

$ helm search repo openziti
NAME                            CHART VERSION   APP VERSION     DESCRIPTION                                       
openziti/ziti-controller        0.1.2           0.27.5          Host an OpenZiti controller in Kubernetes         
openziti/ziti-router            0.1.3           0.27.5          Host an OpenZiti router in Kubernetes             
openziti/ziti-console           0.1.1           latest          Deploy OpenZiti console as kubernetes service     
openziti/ziti-host              0.3.5           0.20.20         Host OpenZiti services with a tunneler pod        
openziti/hello-toy              1.3.1           latest          Run the lightweight toy web server, optionally ...
openziti/httpbin                0.1.2           latest          Run the Ziti fork of go-httpbin                   
openziti/reflect                0.3.3           0.0.4           Deploy a pod running the Ziti-embeded version o...

Chart Highlights

Charts for Workloads

These charts help cluster workloads access or provide a Ziti service.

• ziti-host: Ziti tunnel pod for hosting services (ingress only)
• (planned) ziti-node: Ziti tunnel daemonset for accessing services (intercept node egress)

Charts for Self-Hosting Ziti

• ziti-controller
• ziti-router
• ziti-console

Charts that Deploy a Ziti-enabled Application

• httpbin: Ziti fork of the REST testing server
• prometheus: Ziti fork of Prometheus
• reflect: A Ziti original. This app echoes the bytes it receives and is useful for testing Ziti.

Maintainers

This repo uses GitHub Actions to automate the following tasks:

1. Generate Helm docs for each chart in the repo.
2. Package and index the charts and publish the new Helm repo index and READMEs to GitHub Pages.

Troubleshooting a Missing Chart

In case a chart release is missing from the Helm index, you can run the following commands to resolve the issue locally.

For this example, support the httpbin chart release version 0.1.2 exists in GitHub, but is missing from the Helm index. The solution is to run Chart Releaser locally to package and index the chart.

git checkout gh-pages
cr package ./charts/httpbin
cr index --owner openziti --git-repo helm-charts --index-path .

Contribute

1. Clone this repo.
2. Optionally, to customize the auto-generated README.md file, add a helm-docs template named README.md.gotmpl in the chart directory.
3. Wait for GitHub bot to generate Helm docs in your branch, or run helm-docs --chart-search-root ./charts/my-new-chart/ locally
4. Send PR targeting main.
5. Wait for GitHub bot to bump chart versions if necessary, i.e., if anything in the chart dir changed since latest tag and the chart version is already released.
6. Merging to main runs GitHub Actions to package and index the charts and publish the new Helm repo index and READMEs to GitHub Pages.

You may verify changes are present in the Helm index: https://docs.openziti.io/helm-charts/index.yaml.