نام (NAME)

repo - بارگذاری تغییرات برای بازبینی کد

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

repo upload [--re --cc] [<project>]...

توضیحات (DESCRIPTION)

خلاصه

بارگذاری تغییرات برای بازبینی کد

گزینه‌ها (OPTIONS)

-h, --help: نمایش این پیام راهنما و خروج
-j JOBS, --jobs=JOBS: تعداد کارهایی که باید به‌صورت موازی اجرا شوند (پیش‌فرض: بر اساس تعداد هسته‌های CPU)
-t, --topic-branch: تنظیم موضوع (topic) به نام شاخهٔ محلی
--topic=TOPIC: تنظیم موضوع برای تغییر
--hashtag=HASHTAGS, --ht=HASHTAGS: افزودن هشتگ‌ها (جداشده با کاما) به بازبینی
--hashtag-branch, --htb: افزودن نام شاخهٔ محلی به‌عنوان یک هشتگ
-l LABELS, --label=LABELS: افزودن یک برچسب هنگام بارگذاری
--pd=PATCHSET_DESCRIPTION, --patchset-description=PATCHSET_DESCRIPTION: توضیحات برای مجموعه وصله (patchset)
--re=REVIEWERS, --reviewers=REVIEWERS: درخواست بازبینی از این افراد
--cc=CC: همچنین ارسال رایانامه به این نشانی‌های رایانامه
--br=BRANCH, --branch=BRANCH: شاخهٔ (محلی) برای بارگذاری
-c, --current-branch: بارگذاری شاخهٔ فعلی git
--no-current-branch: بارگذاری تمام شاخه‌های git
--ne, --no-emails: عدم ارسال رایانامه در هنگام بارگذاری
-p, --private: بارگذاری به‌عنوان تغییر خصوصی (منسوخ شده؛ از --wip استفاده کنید)
-w, --wip: بارگذاری به‌عنوان تغییر در حال انجام (work-in-progress)
-r, --ready: علامت‌گذاری تغییر به‌عنوان آماده (تنظیم work-in-progress را پاک می‌کند)
-o PUSH_OPTIONS, --push-option=PUSH_OPTIONS: گزینه‌های push اضافی برای ارسال
-D BRANCH, --destination=BRANCH, --dest=BRANCH: ارسال برای بازبینی در این شاخهٔ مقصد
-n, --dry-run: انجام همه‌چیز به‌جز بارگذاری واقعی CL
-y, --yes: پاسخ بله به تمام اعلان‌های امن
--ignore-untracked-files: نادیده‌گرفتن فایل‌های ردیابی‌نشده در نسخهٔ کاری
--no-ignore-untracked-files: پرسش همیشگی دربارهٔ فایل‌های ردیابی‌نشده در نسخهٔ کاری
--no-cert-checks: غیرفعال‌سازی اعتبارسنجی گواهی‌های ssl (ناامن)

گزینه‌های ثبت گزارش (Logging options):

-v, --verbose: نمایش تمام خروجی‌ها
-q, --quiet: تنها نمایش خطاها

گزینه‌های چندمانیفست (Multi-manifest options):

--outer-manifest: شروع عملیات از بیرونی‌ترین مانیفست
--no-outer-manifest: عدم اجرا روی مانیفست‌های بیرونی
--this-manifest-only: فقط اجرا روی این مانیفست (یا زیرمانیفست)
--no-this-manifest-only, --all-manifests: اجرا روی این مانیفست و زیرمانیفست‌های آن

قلاب‌های پیش از بارگذاری (pre-upload hooks):

--no-verify: عدم اجرای قلاب پیش از بارگذاری (pre-upload hook).
--verify: اجرای قلاب پیش از بارگذاری بدون پرسش تأیید.
--ignore-hooks: عدم توقف در صورت شکست قلاب‌های پیش از بارگذاری.

برای مشاهدهٔ راهنمای دقیق، دستور `repo help upload` را اجرا کنید.

جزئیات (DETAILS)

دستور 'repo upload' برای ارسال تغییرات به سامانهٔ بازبینی کد Gerrit استفاده می‌شود. این دستور شاخه‌های موضوعی را در پروژه‌های محلی که هنوز برای بازبینی منتشر نشده‌اند جستجو می‌کند. در صورتی که چندین شاخهٔ موضوعی یافت شود، 'repo upload' ویرایشگری را باز می‌کند تا کاربر بتواند شاخه‌های موردنظر برای بارگذاری را انتخاب کند.

دستور 'repo upload' تغییرات قابل بارگذاری را در تمام پروژه‌های مشخص‌شده در خط فرمان جستجو می‌کند. پروژه‌ها را می‌توان با نام، یا با مسیر نسبی یا مطلق به دایرکتوری محلی پروژه تعیین کرد. اگر پروژه‌ای مشخص نشود، 'repo upload' تغییرات قابل بارگذاری را در تمامی پروژه‌های ذکرشده در مانیفست جستجو خواهد کرد.

در صورت استفاده از گزینه‌های --reviewers یا --cc، آن رایانامه‌ها به فهرست کاربران مربوطه اضافه شده و به کاربران جدید رایانامه ارسال می‌شود. کاربران مشخص‌شده در --reviewers باید از قبل در سامانهٔ بازبینی کد ثبت‌نام کرده باشند، در غیر این صورت بارگذاری ناموفق خواهد بود.

اگرچه بیشتر گزینه‌های معمول Gerrit دارای گزینه‌های اختصاصی در خط فرمان هستند، دسترسی مستقیم به گزینه‌های Gerrit از طریق --push-options نیز ممکن است. این قابلیت زمانی مفید است که Gerrit ویژگی جدیدتری ارائه داده باشد که repo upload هنوز از آن پشتیبانی نمی‌کند یا برنامه‌ای برای پشتیبانی از آن ندارد. برای جزئیات بیشتر به مستندات Push Options مراجعه کنید: https://gerrit-review.googlesource.com/Documentation/user-upload.html#push_options

پیکربندی (Configuration)

review.URL.autoupload:

برای غیرفعال کردن اعلان "?Upload ... (y/N)"، می‌توانید یک گزینهٔ پیکربندی Git برای هر پروژه یا به‌صورت سراسری تنظیم کنید. اگر review.URL.autoupload روی "true" تنظیم شده باشد، repo فرض می‌کند که شما همیشه در اعلان پاسخ "y" می‌دهید و دیگر سؤالی نمی‌پرسد. اگر روی "false" تنظیم شود، repo فرض می‌کند که همیشه پاسخ شما "n" است و عملیات متوقف می‌شود.

review.URL.autoreviewer:

برای افزودن خودکار یک کاربر یا فهرست پستی به بازبینی‌ها، می‌توانید یک گزینهٔ Git به‌ازای هر پروژه یا به‌صورت سراسری تعیین کنید.

review.URL.autocopy:

برای ارسال خودکار رونوشت به یک کاربر یا فهرست پستی در تمام بازبینی‌های بارگذاری‌شده، می‌توانید یک گزینهٔ Git به‌ازای هر پروژه یا سراسری تعیین کنید. به‌طور دقیق‌تر، review.URL.autocopy می‌تواند فهرستی جداشده با کاما از بازبین‌هایی باشد که می‌خواهید در تمام بارگذاری‌ها با آرگومان غیرخالی --re رونوشت دریافت کنند.

review.URL.username:

بازنویسی نام کاربری مورداستفاده برای اتصال به Gerrit Code Review. به‌طور پیش‌فرض از بخش محلی نشانی رایانامه استفاده می‌شود.

نشانی URL باید با نشانی review ذکرشده در فایل XML مانیفست یا فایل .git/config در پروژه مطابقت داشته باشد. برای مثال:

: [remote "origin"]
: url = git://git.example.com/project.git review = http://review.example.com
: [review "http://review.example.com"]
: autoupload = true autocopy = johndoe@company.com,my-team-alias@company.com

review.URL.uploadtopic:

برای افزودن شاخهٔ موضوعی در هر بار بارگذاری ثبت (commit)، می‌توانید یک گزینهٔ Git به‌ازای هر پروژه یا سراسری تعیین کنید. اگر review.URL.uploadtopic روی "true" تنظیم شود، repo فرض می‌کند همیشه معادل گزینهٔ -t در دستور repo را می‌خواهید. در صورت عدم تنظیم یا مقدار "false"، دستور repo تنها از گزینهٔ خط فرمان استفاده خواهد کرد.

review.URL.uploadhashtags:

برای افزودن هشتگ‌ها در هر بار بارگذاری ثبت، می‌توانید یک گزینهٔ Git به‌ازای هر پروژه یا سراسری تعیین کنید. مقدار review.URL.uploadhashtags همانند گزینهٔ --hashtag به‌صورت هشتگ‌های جداشده با کاما در نظر گرفته می‌شود.

review.URL.uploadlabels:

برای افزودن برچسب‌ها در هر بار بارگذاری ثبت، می‌توانید یک گزینهٔ Git به‌ازای هر پروژه یا سراسری تعیین کنید. مقدار review.URL.uploadlabels همانند گزینهٔ --label به‌صورت برچسب‌های جداشده با کاما استفاده خواهد شد.

review.URL.uploadnotify:

مدیریت اعلان‌های رایانامه‌ای هنگام بارگذاری: https://gerrit-review.googlesource.com/Documentation/user-upload.html#notify

review.URL.uploadwarningthreshold:

دستور Repo در صورتی که قصد بارگذاری تعداد زیادی ثبت در یک یا چند شاخه را داشته باشید هشدار می‌دهد. به‌طور پیش‌فرض، این آستانه پنج ثبت است. این گزینه امکان بازنویسی آستانهٔ هشدار به مقداری دیگر را فراهم می‌کند.

مراجع (References)

سامانه بازبینی کد Gerrit: https://www.gerritcodereview.com