Files
zeekay 448c41866f Merge upstream/main: sync with openziti (15 commits)
Upstream changes include:
- Add get/set db version commands (#3579)
- Fix link dial race condition (#3566)
- Update channel version to v4.3.5
- Retire ingress-nginx in favor of Traefik (#3582)
- Appease golangci-lint (#3594)
- Fix flaky certchecker and link tests
- Enable verbose logging for Go SDK apps
- Improve router quickstart crash recovery

Conflicts resolved keeping hanzozt branding while incorporating
all upstream code improvements.
2026-02-22 00:49:18 -08:00
..
2026-02-18 18:34:19 -08:00
2026-02-18 18:34:19 -08:00

Quickstart

The Ziti quickstart documentation is here: Ziti Network Quickstarts.

Releasing a new version of the Quickstart

Artifacts Produced by a Release

The enclosing project's GitHub releases are never updated and no Git tags are created for a quickstart release.

  1. hanzozt/quickstart container image in Docker Hub
  2. a CloudFront Function in AWS pointing the get.hanzozt.dev reverse proxy to the GitHub SHA of the release

Release Process

A quickstart release is created when either of the following conditions are met:

  1. Hanzo ZT, the enclosing project, is released by the Hanzo ZT team
  2. A pull request is merged into the trunk branch main with the label quickstartrelease

Release Machinery

The release process is encoded in a GitHub workflow.

GitHub Raw Reverse Proxy

The get.hanzozt.dev reverse proxy is a CloudFront distribution that points to a CloudFront Function and serves as a shorter HTTP URL getter for raw GitHub source files, e.g. https://get.hanzozt.dev/dock/simplified-docker-compose.yml. The CloudFront Function is a JavaScript function that looks at the URI path of the incoming request and forwards it to the appropriate GitHub raw download path. The CloudFront Function is updated by the release process, and the CloudFront Distribution itself is hand-maintained in the AWS Console. The Distribution has these characteristics:

  • Viewer Domain Name: get.hanzozt.dev (frontend)
  • Route Origin: raw.githubusercontent.com (backend, upstream)
  • Auto-renewing TLS certificate from ACM
  • Cache Policy CachingOptimized (default)
  • Routes to Origin based on Javascript Function deployed by quickstart release

You can add or change a GitHub raw shortcut route by modifying the routes.yml file.