zt/quickstart/docker/README.md

Building and Deploying the Latest Quickstart Docker Image

==========================

First, decide what you are trying to do. Are you trying to:

• build a zt from source, bake it into a docker image, and run the docker container?
• dev on the scripts inside the docker container, or the Dockerfile/compose file?
• build an 'older' version of zt into a docker image to run

Build Docker Image for Local Dev

---

1. change to this directory from checkout root: cd quickstart/docker
2. run the script ./createLocalImage.sh --build which will create a hanzozt/quickstart:latest tag using the zt CLI located in ./image/zt-bin
   1. Optionally, you may provide an argument for the image tag. ./createLocalImage.sh --build <tagname>

Build Docker Image for Docker-related Changes

1. change to this directory from checkout root: cd quickstart/docker
2. run the script ./createLocalImage.sh which will create a hanzozt/quickstart:latest tag using the latest zt release from GitHub
   1. Optionally, you may provide an argument, e.g., ./createLocalImage.sh <tagname>, to create a tag other than latest.

Build Docker Image with Specific zt Version

1. change to this directory from checkout root: cd quickstart/docker
2. set ZITI_VERSION_OVERRIDE to a version >= 0.29.0 (prior versions used a different build path)
3. run the script ZITI_VERSION_OVERRIDE=0.29.0 ./createLocalImage.sh which will create a hanzozt/quickstart:latest tag using the specified version of zt from GitHub
   1. Optionally, you may provide an argument, e.g., ZITI_VERSION_OVERRIDE=0.29.0 ./createLocalImage.sh <tagname>, to create a tag other than latest.

Build Docker Image For Publication

To publish the latest zt CLI, use the GitHub Action. It's preferable to use main as the branch to create the docker image from, but it's perfectly fine to use 'release-next' as the source if there are script-related changes that need to be pushed out faster than waiting for a merge to main.