detached 9ef6929

docs: clarify push domain override examples (#174)

commit
9ef69294fa05fc256e2b8bde7d893b30090ec27d
author
bnema · · 2026-04-12 15:04 UTC
committer
GitHub · · 2026-04-12 15:04 UTC
parent
9287455
signature
GPG UnverifiedB5690EEEBB952194 The key is unknown
refs
tag: v2.31.0-dev7
6 files · +6 -6
M README.md +1 -1
@@ -33,7 +33,7 @@ Build locally, push directly to your Gordon server:
3333
3434 ```bash
3535 # Push using an explicit domain override
36-gordon push --domain app.example.com
36+gordon push myapp:latest --domain app.example.com
3737
3838 # Or add a route manually, then deploy
3939 gordon routes add app.example.com myapp:latest
@@ -33,7 +33,7 @@ Build locally, push directly to your Gordon server:
33 33
34 ```bash34 ```bash
35 # Push using an explicit domain override35 # Push using an explicit domain override
36-gordon push --domain app.example.com36+gordon push myapp:latest --domain app.example.com
37 37
38 # Or add a route manually, then deploy38 # Or add a route manually, then deploy
39 gordon routes add app.example.com myapp:latest39 gordon routes add app.example.com myapp:latest
M docs/cli/attachments.md +1 -1
@@ -255,7 +255,7 @@ gordon bootstrap app.example.com myapp:latest --attachment pitlane-pgsql
255255 gordon attachments push pitlane-pgsql --build
256256
257257 # Then push and deploy the route image
258-gordon push --domain app.example.com --build --no-confirm
258+gordon push myapp:latest --domain app.example.com --build --no-confirm
259259 ```
260260
261261 ### CI/CD Integration
@@ -255,7 +255,7 @@ gordon bootstrap app.example.com myapp:latest --attachment pitlane-pgsql
255 gordon attachments push pitlane-pgsql --build255 gordon attachments push pitlane-pgsql --build
256 256
257 # Then push and deploy the route image257 # Then push and deploy the route image
258-gordon push --domain app.example.com --build --no-confirm258+gordon push myapp:latest --domain app.example.com --build --no-confirm
259 ```259 ```
260 260
261 ### CI/CD Integration261 ### CI/CD Integration
M docs/cli/bootstrap.md +1 -1
@@ -44,7 +44,7 @@ Unlike `gordon push`, `gordon bootstrap` does not require the route to exist fir
4444 gordon bootstrap app.example.com myapp:latest
4545
4646 # Then push and deploy the image
47-gordon push --domain app.example.com --build --no-confirm
47+gordon push myapp:latest --domain app.example.com --build --no-confirm
4848
4949 # First-time route setup with a database attachment and environment variable
5050 gordon bootstrap app.example.com myapp:latest --attachment postgres:18 --env APP_ENV=production
@@ -44,7 +44,7 @@ Unlike `gordon push`, `gordon bootstrap` does not require the route to exist fir
44 gordon bootstrap app.example.com myapp:latest44 gordon bootstrap app.example.com myapp:latest
45 45
46 # Then push and deploy the image46 # Then push and deploy the image
47-gordon push --domain app.example.com --build --no-confirm47+gordon push myapp:latest --domain app.example.com --build --no-confirm
48 48
49 # First-time route setup with a database attachment and environment variable49 # First-time route setup with a database attachment and environment variable
50 gordon bootstrap app.example.com myapp:latest --attachment postgres:18 --env APP_ENV=production50 gordon bootstrap app.example.com myapp:latest --attachment postgres:18 --env APP_ENV=production
M docs/cli/index.md +1 -1
@@ -72,7 +72,7 @@ gordon restart myapp.example.com
7272 gordon bootstrap app.example.com myapp:latest --attachment postgres:18 --env APP_ENV=production
7373
7474 # Then push and deploy
75-gordon push --domain app.example.com --build --no-confirm
75+gordon push myapp:latest --domain app.example.com --build --no-confirm
7676
7777 # Push an image and deploy
7878 gordon push myapp --build
@@ -72,7 +72,7 @@ gordon restart myapp.example.com
72 gordon bootstrap app.example.com myapp:latest --attachment postgres:18 --env APP_ENV=production72 gordon bootstrap app.example.com myapp:latest --attachment postgres:18 --env APP_ENV=production
73 73
74 # Then push and deploy74 # Then push and deploy
75-gordon push --domain app.example.com --build --no-confirm75+gordon push myapp:latest --domain app.example.com --build --no-confirm
76 76
77 # Push an image and deploy77 # Push an image and deploy
78 gordon push myapp --build78 gordon push myapp --build
M docs/cli/push.md +1 -1
@@ -100,7 +100,7 @@ gordon push --build --remote https://gordon.example.com --no-confirm
100100 gordon push myapp --remote https://gordon.example.com --no-confirm
101101
102102 # Push and deploy to an explicit domain
103-gordon push --domain app.example.com --remote https://gordon.example.com --no-confirm
103+gordon push myapp:latest --domain app.example.com --remote https://gordon.example.com --no-confirm
104104
105105 # Tagged refs still resolve routes by image name
106106 gordon push myapp:v1.2.3 --tag v1.2.3 --no-deploy
@@ -100,7 +100,7 @@ gordon push --build --remote https://gordon.example.com --no-confirm
100 gordon push myapp --remote https://gordon.example.com --no-confirm100 gordon push myapp --remote https://gordon.example.com --no-confirm
101 101
102 # Push and deploy to an explicit domain102 # Push and deploy to an explicit domain
103-gordon push --domain app.example.com --remote https://gordon.example.com --no-confirm103+gordon push myapp:latest --domain app.example.com --remote https://gordon.example.com --no-confirm
104 104
105 # Tagged refs still resolve routes by image name105 # Tagged refs still resolve routes by image name
106 gordon push myapp:v1.2.3 --tag v1.2.3 --no-deploy106 gordon push myapp:v1.2.3 --tag v1.2.3 --no-deploy
M docs/getting-started.md +1 -1
@@ -147,7 +147,7 @@ gordon remotes use prod
147147 gordon bootstrap app.example.com myapp:latest --attachment postgres:18 --env APP_ENV=production
148148
149149 # Then build, push, and deploy
150-gordon push --domain app.example.com --build --no-confirm
150+gordon push myapp:latest --domain app.example.com --build --no-confirm
151151 ```
152152
153153 What this command does:
@@ -147,7 +147,7 @@ gordon remotes use prod
147 gordon bootstrap app.example.com myapp:latest --attachment postgres:18 --env APP_ENV=production147 gordon bootstrap app.example.com myapp:latest --attachment postgres:18 --env APP_ENV=production
148 148
149 # Then build, push, and deploy149 # Then build, push, and deploy
150-gordon push --domain app.example.com --build --no-confirm150+gordon push myapp:latest --domain app.example.com --build --no-confirm
151 ```151 ```
152 152
153 What this command does:153 What this command does:

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 7

Tags 106

↑↓ moveenter openesc close