Gordon - Deployment Guide

Gordon is a self-hosted container deployment platform. Private Docker registry + push-to-deploy + HTTP reverse proxy in a single binary.

Mental model: Build locally, push an image to Gordon's registry, Gordon deploys it, routes traffic, and handles zero-downtime updates.

Current CLI note: Use gordon version to check the installed version.

First step: Before running any Gordon command, check if ~/.config/gordon/remotes.toml exists and has a remote configured. If not, the user needs to set one up with gordon remotes add before any remote operation will work.

How Deployment Works

1. Push image to Gordon's registry (gordon push or docker push)
2. Gordon starts a new container from the image
3. Gordon waits for readiness (healthcheck, HTTP probe, or delay)
4. Gordon switches proxy traffic to the new container
5. Gordon drains in-flight requests and stops the old container

Designed for zero-downtime when readiness succeeds. Push only triggers deploy if a route matches the pushed image.