helm-charts

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/hello-toy                      3.0.1           v1              Run the lightweight toy web server, optionally with a custom service domain name in cluster DNS.
openziti/httpbin                        0.1.11          latest          Run the Ziti fork of go-httpbin
openziti/prometheus                     0.0.11          0.0.13          Prometheus is a monitoring system and time series database.
openziti/reflect                        0.3.8           0.0.4           Deploy a pod running the Ziti-embeded version of go-httpbin, a REST API server.
openziti/ziti-console                   0.4.2           2.9.0           Deploy OpenZiti console as kubernetes service
openziti/ziti-controller                0.7.1           0.30.4          Host an OpenZiti controller in Kubernetes
openziti/ziti-edge-tunnel               0.0.2           0.22.12         Host OpenZiti services with a tunneler pod
openziti/ziti-host                      0.4.6           0.21.5          Host OpenZiti services with a tunneler pod
openziti/ziti-router                    0.8.3           0.30.4          Host an OpenZiti router in Kubernetes
openziti/zrok                           0.1.17          v0.3.6          A Helm chart for Kubernetes

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)
• ziti-edge-tunnel: 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.

This site is open source. Improve this page.