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`
`--platform`	Target platform for buildx (default: `linux/amd64`)
`--build-arg`	Additional build args (repeatable, `KEY=VALUE`)
`--tag`	Override version tag (default: `git describe --tags --abbrev=0`)
`--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 the latest git tag. If no tag is found, latest is used.
When --build is set, the command uses docker buildx build --push and injects VERSION=<tag> plus any --build-arg values.
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

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| `--platform` | Target platform for buildx (default: `linux/amd64`) |
25| `--build-arg` | Additional build args (repeatable, `KEY=VALUE`) |
26| `--tag` | Override version tag (default: `git describe --tags --abbrev=0`) |
27| `--no-confirm` | Skip deploy confirmation prompt |
28| `--no-deploy` | Push only; skip deployment prompt |
29| `--remote` | Remote Gordon URL |
30| `--token` | Authentication token for remote |
31
32### Description
33
34`gordon push` resolves the route image for `<domain>`, tags the image for the
35Gordon registry, pushes it, and optionally deploys it.
36
37- The registry and repository are derived from the route image on the server.
38- The version tag defaults to the latest git tag. If no tag is found, `latest`
39  is used.
40- When `--build` is set, the command uses `docker buildx build --push` and
41  injects `VERSION=<tag>` plus any `--build-arg` values.
42- The version tag and `latest` are both pushed (unless the version is `latest`).
43
44### Examples
45
46```bash
47# Build, push, and deploy
48gordon push myapp.example.com --build
49
50# Push existing local image, skip deploy
51gordon push myapp.example.com --tag v1.2.0 --no-deploy
52
53# Push and deploy without confirmation
54gordon push myapp.example.com --no-confirm
55
56# Build for ARM and pass build args
57gordon push myapp.example.com --build --platform linux/arm64 --build-arg CGO_ENABLED=0
58```
59
60### Notes
61
62- Remote mode required. See [CLI Overview](./index.md) for targeting options.
63- `--build` requires Docker with Buildx. Docker Desktop includes it; on Linux,
64  install the `docker-buildx-plugin` package.
65
66## Related
67
68- [CLI Overview](./index.md)
69- [Routes Command](./routes.md)
70- [Serve Command](./serve.md)

push.md RawHistoryFolder