mirror of
https://gitea.com/gitea/docs.git
synced 2026-11-05 17:45:46 +00:00
bircni
55c3a392a1
update_cli_docs.sh runs gt's own generator and lays the pages out for the site: one directory per command group, front matter, titles, sidebar order, fenced help text and rewritten links. --released succeeds while no series is documented. A weekly workflow proposes updates like the runner's. Signed-off-by: bircni <[email protected]>
2.6 KiB
2.6 KiB
sidebar_position, description
| sidebar_position | description |
|---|---|
| 7 | Print the logs of a run's jobs |
gt run logs
Print the logs of a run's jobs
Synopsis
Print the logs of a run's jobs, one after another; the name of each job goes to stderr.
With --follow, gt waits for jobs to start and prints new log lines until they complete,
prefixing each line with its job's name when it follows several jobs. With --output or --dir,
it downloads the logs of the whole run as a ZIP archive instead. The URL of a job selects that job,
like --job.
gt run logs [<run-id>] [flags]
Examples
# print the logs of every job of a run
$ gt run logs 34
# follow the logs of one job while it runs
$ gt run logs 34 --job build --follow
# download the logs as a ZIP archive
$ gt run logs 34 --output logs.zip
Options
--clobber Replace an existing file
-D, --dir string Directory to download into
--failed Only the logs of failed jobs
-f, --follow Wait for jobs to start and print new lines until they complete
-h, --help help for logs
-i, --interval duration Polling interval with --follow (default 5s)
-j, --job name or ID Only the logs of this job, by name or ID
-O, --output string File or directory to write to, or - for standard output (default: the download's name)
--skip-existing Keep an existing file and skip the download
--timeout duration Maximum time to follow (default 1h0m0s)
Options inherited from parent commands
--cwd directory Working directory for repository discovery
--debug Log the method, URL, status, and duration of each HTTP request to stderr
--host URL Gitea instance URL, including any base path
--interactive Allow prompts with machine output
-q, --jq expression Filter JSON output using a jq expression; implies --json
--json fields[="*"] Output JSON with the specified comma-separated fields, or all fields
--no-input Disable prompts and implicit editor/browser interactions
--remote remote Git remote used for repository discovery
-R, --repo OWNER/REPO Select a repository as OWNER/REPO or URL
--sudo user Perform API requests as this user (requires an administrator account)
--user name Account name on the selected instance
-y, --yes Accept confirmations without prompting
SEE ALSO
- gt run: View and manage Actions workflow runs