GH-RUN-VIEW(1)                 GitHub CLI manual                GH-RUN-VIEW(1)



نام (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)

                                   Sep 2026                     GH-RUN-VIEW(1)