NAME

gt-run-logs - Print the logs of a run's jobs

SYNOPSIS

gt run logs [<run-id>] [flags]

DESCRIPTION

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.

ARGUMENTS

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

EXAMPLE

# 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