gt-run-logs1

Usage

Overview

Print the logs of a run's jobs, one after another; the name of each job goes to stderr. With --tail, gt prints only the last lines of each job's log. --failed selects the jobs that failed or were canceled, those that gt run rerun --failed reruns.

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.

A run can be supplied as its ID ("34", "#34") or its URL
("https://gitea.example.com/OWNER/REPO/actions/runs/34"). Without an argument,
gt asks for one of the repository's recent runs in a terminal.

Options

--clobber[=false]
Replace an existing file

-D, --dir=""
Directory to download into

--failed[=false]
Only the logs of failed and canceled jobs

-f, --follow[=false]
Wait for jobs to start and print new lines until they complete

-h, --help[=false]
help for logs

-i, --interval=5s
Polling interval with --follow

-j, --job=""
Only the logs of this job, by name or ID

-O, --output=""
File or directory to write to, or - for standard output (default: the download's name)

--skip-existing[=false]
Keep an existing file and skip the download

--tail=0
Only the last N lines of each job's log

--timeout=1h0m0s
Maximum time to follow

Options inherited from parent commands

--cwd=""
Working directory for repository discovery

--debug[=false]
Log the method, URL, status, and duration of each HTTP request to stderr

--host=""
Gitea instance URL, including any base path

--interactive[=false]
Allow prompts with machine output

--no-input[=false]
Disable prompts and implicit editor/browser interactions

--remote=""
Git remote used for repository discovery

-R, --repo=""
Select a repository as OWNER/REPO or URL

--sudo=""
Perform API requests as this user (requires an administrator account)

--user=""
Account name on the selected instance

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
# print the last 50 lines of each failed or canceled job
$ gt run logs 34 --failed --tail 50
# download the logs as a ZIP archive
$ gt run logs 34 --output logs.zip