نام (NAME)

gh-run-view - مشاهده خلاصه اجرای یک گردش‌کار

خلاصه دستور (SYNOPSIS)

gh run view [<run-id>] [flags]

توضیحات (DESCRIPTION)

مشاهده خلاصه اجرای یک گردش‌کار.

به دلیل محدودیت‌های پلتفرم، gh ممکن است هنگام استفاده از روش اصلی دریافت لاگ‌ها در قالب zip، همیشه قادر به مرتبط ساختن جاب‌ها با لاگ‌های مربوطه‌شان نباشد.

در چنین مواردی، gh تلاش خواهد کرد تا لاگ‌ها را برای هر جاب به صورت جداگانه از طریق API واکشی کند. این راهکار جایگزین، کندتر بوده و منابع بیشتری مصرف می‌کند. اگر بیش از ۲۵ لاگ جاب وجود نداشته باشد، عملیات با خطا متوقف خواهد شد.

علاوه بر این، به دلیل محدودیت‌های پلتفرمی مشابه، ممکن است برخی از خطوط لاگ با مرحله مشخصی از یک جاب مرتبط نباشند. در این موارد، نام مرحله در خروجی لاگ به صورت UNKNOWN STEP نمایش داده می‌شود.

گزینه‌ها (OPTIONS)

-a, --attempt <uint> (default 0): شماره تلاش اجرای گردش‌کار
--exit-status: خروج با وضعیت غیرصفر در صورت ناموفق بودن اجرا
-j, --job <string>: مشاهده یک شناسه جاب مشخص از یک اجرا
-q, --jq <expression>: فیلتر کردن خروجی JSON با استفاده از عبارت jq
--json <fields>: خروجی JSON با فیلدهای مشخص‌شده
--log: مشاهده لاگ کامل برای یک اجرا یا یک جاب مشخص
--log-failed: مشاهده لاگ برای مراحل ناموفق در یک اجرا یا یک جاب مشخص
-t, --template <string>: قالب‌بندی خروجی JSON با استفاده از قالب Go؛ به "gh help formatting" مراجعه کنید
-v, --verbose: نمایش مراحل جاب
-w, --web: باز کردن اجرا در مرورگر

گزینه‌های به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)

-R, --repo <[HOST/]OWNER/REPO>: انتخاب یک مخزن دیگر با استفاده از قالب [HOST/]OWNER/REPO

فیلدهای JSON (JSON FIELDS)

attempt, conclusion, createdAt, databaseId, displayTitle, event, headBranch, headSha, jobs, name, number, startedAt, status, updatedAt, url, workflowDatabaseId, workflowName

کدهای خروج (EXIT CODES)

0: اجرای موفقیت‌آمیز

1: خطا

2: دستور لغو شد

4: نیاز به احراز هویت است

نکته: دستورات خاص ممکن است کدهای خروج دیگری نیز داشته باشند. برای اطلاعات بیشتر به راهنمای دستور مربوطه مراجعه کنید.

مثال‌ها (EXAMPLES)

# انتخاب تعاملی یک اجرا برای مشاهده، با قابلیت انتخاب یک جاب مشخص به صورت اختیاری
$ gh run view
# مشاهده یک اجرای مشخص
$ gh run view 12345
# مشاهده یک اجرای مشخص با شماره تلاش مشخص
$ gh run view 12345 --attempt 3
# مشاهده یک جاب مشخص در یک اجرا
$ gh run view --job 456789
# مشاهده لاگ کامل برای یک جاب مشخص
$ gh run view --log --job 456789
# خروج با وضعیت غیرصفر در صورت ناموفق بودن اجرا
$ gh run view 0451 --exit-status && echo "run pending or passed"

همچنین ببینید (SEE ALSO)

gh-run(1)