v2.12.0 657aee7

deploy.md RawHistoryFolder

Deploy Configuration

Controls how Gordon pulls images during deployment.

Example

[deploy]
pull_policy = "if-tag-changed"
readiness_delay = "5s"

Settings

deploy.pull_policy

How to decide when to pull an image:

  • always: always pull, even if the tag exists locally.
  • if-not-present: only pull when the tag is missing locally.
  • if-tag-changed: pull for tag references to check for updates; skip pulls for digest references (@sha256:...).

Default: if-tag-changed

deploy.readiness_delay

How long Gordon waits after a container first reports running before it is considered ready for traffic.

  • Uses Go duration format (examples: "5s", "15s", "1m").
  • If the container briefly exits right after this delay, Gordon now waits up to 30 additional seconds for it to recover before failing the deploy.

Default: "5s"

Notes

  • Changes to deploy.pull_policy require a restart to take effect.
  • Changes to deploy.readiness_delay require a restart to take effect.
source
1# Deploy Configuration
2
3Controls how Gordon pulls images during deployment.
4
5## Example
6
7```toml
8[deploy]
9pull_policy = "if-tag-changed"
10readiness_delay = "5s"
11```
12
13## Settings
14
15### `deploy.pull_policy`
16
17How to decide when to pull an image:
18
19- `always`: always pull, even if the tag exists locally.
20- `if-not-present`: only pull when the tag is missing locally.
21- `if-tag-changed`: pull for tag references to check for updates; skip pulls for digest references (`@sha256:...`).
22
23Default: `if-tag-changed`
24
25### `deploy.readiness_delay`
26
27How long Gordon waits after a container first reports `running` before it is
28considered ready for traffic.
29
30- Uses Go duration format (examples: `"5s"`, `"15s"`, `"1m"`).
31- If the container briefly exits right after this delay, Gordon now waits up to
32  30 additional seconds for it to recover before failing the deploy.
33
34Default: `"5s"`
35
36## Notes
37
38- Changes to `deploy.pull_policy` require a restart to take effect.
39- Changes to `deploy.readiness_delay` require a restart to take effect.

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