Push Command

Tag, push, and optionally deploy an image to the Gordon registry.

gordon push

Synopsis

gordon push <domain> [options]

Arguments

Argument	Description
`<domain>`	The route domain to resolve the registry and repository from

Options

Option	Description
`--build`	Build the image first using `docker buildx`
`-f, --file`	Path to Dockerfile (default: `./Dockerfile`, used with `--build`)
`--platform`	Target platform for buildx (default: `linux/amd64`)
`--build-arg`	Additional build args (repeatable, `KEY=VALUE`)
`--tag`	Override version tag (default: tag ref from CI, then `git describe --tags --dirty`)
`--no-confirm`	Skip deploy confirmation prompt
`--no-deploy`	Push only; skip deployment prompt
`--remote`	Remote Gordon URL
`--token`	Authentication token for remote

Description

gordon push resolves the route image for <domain>, tags the image for the Gordon registry, pushes it, and optionally deploys it.

The registry and repository are derived from the route image on the server.
The version tag defaults to a CI tag ref (like refs/tags/v1.2.3) when available, then falls back to git describe --tags --dirty (for example v1.2.3-4-gabc1234 or v1.2.3-dirty). If no tag is found, latest is used.
When --build is set, the command builds with docker buildx build --load and injects VERSION into the build environment plus any --build-arg values.
Use -f/--file to build from a Dockerfile outside the current directory root.
The version tag and latest are both pushed (unless the version is latest).

Examples

# Build, push, and deploy
gordon push myapp.example.com --build

# Push existing local image, skip deploy
gordon push myapp.example.com --tag v1.2.0 --no-deploy

# Push and deploy without confirmation
gordon push myapp.example.com --no-confirm

# Build for ARM and pass build args
gordon push myapp.example.com --build --platform linux/arm64 --build-arg CGO_ENABLED=0

# Build from a custom Dockerfile path
gordon push myapp.example.com --build -f docker/app/Dockerfile

Notes

Remote mode required. See CLI Overview for targeting options.
--build requires Docker with Buildx. Docker Desktop includes it; on Linux, install the docker-buildx-plugin package.

source

1# Push Command
2
3Tag, push, and optionally deploy an image to the Gordon registry.
4
5## gordon push
6
7### Synopsis
8
9```bash
10gordon push <domain> [options]
11```
12
13### Arguments
14
15| Argument | Description |
16|----------|-------------|
17| `<domain>` | The route domain to resolve the registry and repository from |
18
19### Options
20
21| Option | Description |
22|--------|-------------|
23| `--build` | Build the image first using `docker buildx` |
24| `-f, --file` | Path to Dockerfile (default: `./Dockerfile`, used with `--build`) |
25| `--platform` | Target platform for buildx (default: `linux/amd64`) |
26| `--build-arg` | Additional build args (repeatable, `KEY=VALUE`) |
27| `--tag` | Override version tag (default: tag ref from CI, then `git describe --tags --dirty`) |
28| `--no-confirm` | Skip deploy confirmation prompt |
29| `--no-deploy` | Push only; skip deployment prompt |
30| `--remote` | Remote Gordon URL |
31| `--token` | Authentication token for remote |
32
33### Description
34
35`gordon push` resolves the route image for `<domain>`, tags the image for the
36Gordon registry, pushes it, and optionally deploys it.
37
38- The registry and repository are derived from the route image on the server.
39- The version tag defaults to a CI tag ref (like `refs/tags/v1.2.3`) when available,
40  then falls back to `git describe --tags --dirty` (for example
41  `v1.2.3-4-gabc1234` or `v1.2.3-dirty`). If no tag is found, `latest` is used.
42- When `--build` is set, the command builds with `docker buildx build --load`
43  and injects `VERSION` into the build environment plus any `--build-arg` values.
44- Use `-f/--file` to build from a Dockerfile outside the current directory root.
45- The version tag and `latest` are both pushed (unless the version is `latest`).
46
47### Examples
48
49```bash
50# Build, push, and deploy
51gordon push myapp.example.com --build
52
53# Push existing local image, skip deploy
54gordon push myapp.example.com --tag v1.2.0 --no-deploy
55
56# Push and deploy without confirmation
57gordon push myapp.example.com --no-confirm
58
59# Build for ARM and pass build args
60gordon push myapp.example.com --build --platform linux/arm64 --build-arg CGO_ENABLED=0
61
62# Build from a custom Dockerfile path
63gordon push myapp.example.com --build -f docker/app/Dockerfile
64```
65
66### Notes
67
68- Remote mode required. See [CLI Overview](./index.md) for targeting options.
69- `--build` requires Docker with Buildx. Docker Desktop includes it; on Linux,
70  install the `docker-buildx-plugin` package.
71
72## Related
73
74- [CLI Overview](./index.md)
75- [Routes Command](./routes.md)
76- [Serve Command](./serve.md)

push.md RawHistoryFolder