act(1) act(1)

act - اجرای محلی اکشن‌های GitHub Actions

act [نام رویداد برای اجرا] [گزینه‌ها]

اگر هیچ نام رویدادی مشخص نشود، به‌طور پیش‌فرض از "on: push" استفاده خواهد شد. اگر اکشن‌ها تنها از یک رویداد پشتیبانی کنند، به‌جای "on: push" از آن به عنوان پیش‌فرض استفاده می‌شود.

اجرای محلی اکشن‌های GitHub Actions با مشخص کردن نام رویداد (مانند push) یا مستقیماً نام یک اکشن.

--action-cache-path="/build/.cache/act" مسیر کش شدن اکشن‌ها و ایجاد فضاهای کاری میزبان را مشخص می‌کند.

--action-offline-mode[=false] اگر محتوای اکشن وجود داشته باشد، مجدداً دریافت و واکشی نمی‌شود. فعال کردن این گزینه، دریافت اجباری (force pull) را غیرفعال می‌کند.

-a, --actor="nektos/act" کاربری که رویداد را ایجاد کرده است.

--artifact-server-addr="162.55.28.166" آدرسی را که سرور آرتیفکت به آن متصل می‌شود مشخص می‌کند.

--artifact-server-path="" مسیری را مشخص می‌کند که سرور آرتیفکت فایل‌های آپلود شده را در آن ذخیره کرده و دانلودها را از آن بازیابی می‌کند. اگر مشخص نشود، سرور آرتیفکت راه‌اندازی نخواهد شد.

--artifact-server-port="34567" درگاهی (پورت) را که سرور آرتیفکت روی آن گوش می‌دهد مشخص می‌کند.

-b, --bind[=false] دایرکتوری کاری را به کانتینر متصل (bind) می‌کند، به جای این‌که آن را کپی کند.

--bug-report[=false] نمایش اطلاعات سیستم برای گزارش باگ.

--cache-server-addr="162.55.28.166" آدرسی را که سرور کش به آن متصل می‌شود مشخص می‌کند.

--cache-server-external-url="" نشانی اینترنتی (URL) خارجی را در صورتی که سرور کش پشت یک پروکسی باشد مشخص می‌کند؛ مانند: https://act-cache-server.example.com (دقت کنید که بدون اسلش پایانی باشد).

--cache-server-path="/build/.cache/actcache" مسیری را که سرور کش، کش‌ها را در آن ذخیره می‌کند مشخص می‌کند.

--cache-server-port=0 درگاهی را که سرور کش روی آن گوش می‌دهد مشخص می‌کند. مقدار 0 به معنای یک درگاه تصادفی آزاد است.

--concurrent-jobs=0 حداکثر تعداد کارهای همزمان برای اجرا. مقدار پیش‌فرض برابر با تعداد پردازنده‌های در دسترس است.

--container-architecture="" معماری مورد استفاده برای اجرای کانتینرها، مانند: linux/amd64. در صورت عدم تعیین، از معماری پیش‌فرض میزبان استفاده می‌شود. نیازمند Docker server API نسخه 1.41+ است. در پلتفرم‌های قدیمی‌تر Docker سرور نادیده گرفته می‌شود.

--container-cap-add=[] قابلیت‌های هسته (kernel capabilities) برای افزودن به کانتینرهای ورک‌فلو (مانند --container-cap-add SYS_PTRACE).

--container-cap-drop=[] قابلیت‌های هسته (kernel capabilities) برای حذف از کانتینرهای ورک‌فلو (مانند --container-cap-drop SYS_PTRACE).

--container-daemon-socket="" شناسه منبع یکنواخت (URI) سوکت Docker Engine (مانند: unix://~/.docker/run/docker.sock یا - برای غیرفعال کردن اتصال سوکت).

--container-options="" گزینه‌های سفارشی کانتینر داکر برای کانتینر وظیفه (job) که در تعریف آن ویژگی options مشخص نشده است.

--defaultbranch="" نام شاخه اصلی.

--detect-event[=false] استفاده از اولین نوع رویداد از ورک‌فلو به عنوان رویدادی که ورک‌فلو را آغاز کرده است.

-C, --directory="." دایرکتوری کاری.

-n, --dryrun[=false] غیرفعال کردن ایجاد کانتینر و فقط اعتبارسنجی درستی ورک‌فلو.

--env=[] متغیر محیطی برای در دسترس قرار دادن در اکشن‌ها همراه با مقدار اختیاری (مانند --env myenv=foo یا --env myenv).

--env-file=".env" فایل محیطی برای خواندن و استفاده به عنوان متغیرهای محیطی در کانتینرها.

-e, --eventpath="" مسیر فایل JSON رویداد.

--github-instance="github.com" نمونه گیت‌هاب مورد استفاده. تنها هنگام استفاده از GitHub Enterprise Server از این گزینه استفاده کنید.

-g, --graph[=false] رسم گراف ورک‌فلوها.

-h, --help[=false] نمایش راهنمای act.

--input=[] ورودی اکشن برای در دسترس قرار دادن در اکشن‌ها (مانند --input myinput=foo).

--input-file=".input" فایل ورودی برای خواندن و استفاده به عنوان ورودی اکشن.

--insecure-secrets[=false] توصیه نمی‌شود! هنگام چاپ لاگ‌ها، رازها (secrets) را پنهان نمی‌کند.

-j, --job="" اجرای یک شناسه وظیفه (Job ID) خاص.

--json[=false] خروجی دادن لاگ‌ها در قالب JSON.

-l, --list[=false] فهرست کردن ورک‌فلوها.

--list-options[=false] چاپ یک ساختار JSON از گزینه‌های سازگار.

--local-repository=[] جایگزین کردن مخزن و ارجاع (ref) مشخص‌شده با یک پوشه محلی (مانند https://github.com/test/test@v0=/home/act/test یا test/test@v0=/home/act/test که مورد دوم با هر میزبان یا پروتکلی مطابقت دارد).

--log-prefix-job-id[=false] خروجی دادن شناسه وظیفه در لاگ‌های غیر JSON به جای نام کامل آن.

--man-page[=false] چاپ صفحه راهنمای تولید شده در خروجی استاندارد (stdout).

--matrix=[] مشخص کردن این‌که کدام پیکربندی ماتریسی گنجانده شود (مانند --matrix java:13).

--network="host" نام شبکه داکر را تنظیم می‌کند. پیش‌فرض host است.

--no-cache-server[=false] غیرفعال کردن سرور کش.

--no-recurse[=false] فلگ غیرفعال کردن اجرای ورک‌فلوها از زیرپوشه‌های مسیر مشخص شده در فلگ‌های '--workflows'/'-W'.

--no-skip-checkout[=false] استفاده از actions/checkout به جای کپی کردن فایل‌های محلی به درون کانتینر.

-P, --platform=[] ایمیج سفارشی مورد استفاده برای هر پلتفرم (مانند -P ubuntu-18.04=nektos/act-environments-ubuntu:18.04).

--privileged[=false] استفاده از حالت دسترسی ویژه (privileged mode).

-p, --pull[=true] دریافت (pull) ایمیج‌های داکر حتی در صورتی که از قبل موجود باشند.

-q, --quiet[=false] غیرفعال کردن ثبت خروجی گام‌ها در لاگ.

--rebuild[=true] بازسازی ایمیج‌های داکر اکشن محلی حتی در صورتی که از قبل موجود باشند.

--remote-name="origin" نام ریموت گیت که برای دریافت نشانی مخزن گیت استفاده می‌شود.

--replace-ghe-action-token-with-github-com="" اگر از replace-ghe-action-with-github-com استفاده می‌کنید و می‌خواهید از اکشن‌های خصوصی در گیت‌هاب استفاده کنید، باید توکن دسترسی شخصی (personal access token) را تنظیم نمایید.

--replace-ghe-action-with-github-com=[] اگر از GitHub Enterprise Server استفاده می‌کنید و اجازه استفاده از اکشن‌های خاص از GitHub (github.com) را می‌دهید، می‌توانید اکشن‌ها را در این گزینه تنظیم کنید (مانند --replace-ghe-action-with-github-com =github/super-linter).

-r, --reuse[=false] عدم حذف کانتینرها پس از تکمیل موفقیت‌آمیز ورک‌فلوها برای حفظ وضعیت بین دفعات اجرا.

--rm[=false] حذف خودکار کانتینرها/والیوم‌ها پس از شکست یک یا چند ورک‌فلو.

-s, --secret=[] راز (secret) برای در دسترس قرار دادن در اکشن‌ها همراه با مقدار اختیاری (مانند -s mysecret=foo یا -s mysecret).

--secret-file=".secrets" فایل حاوی فهرستی از رازها برای خواندن (مانند --secret-file .secrets).

--strict[=false] استفاده از ساختار (schema) سخت‌گیرانه ورک‌فلو.

--use-gitignore[=true] کنترل می‌کند که آیا مسیرهای مشخص شده در .gitignore باید به داخل کانتینر کپی شوند یا خیر.

--use-new-action-cache[=false] فعال کردن استفاده از Action Cache جدید برای ذخیره محلی اکشن‌ها.

--userns="" فضای نام کاربر (user namespace) مورد استفاده.

--validate[=false] اعتبارسنجی ورک‌فلوها.

--var=[] متغیر برای در دسترس قرار دادن در اکشن‌ها همراه با مقدار اختیاری (مانند --var myvar=foo یا --var myvar).

--var-file=".vars" فایل حاوی فهرستی از متغیرها برای خواندن (مانند --var-file .vars).

-v, --verbose[=false] خروجی با جزئیات کامل.

--version[=false] نمایش نسخه act.

-w, --watch[=false] نظارت بر محتویات مخزن محلی و اجرا در هنگام تغییر فایل‌ها.

-W, --workflows="./.github/workflows/" مسیر فایل(های) ورک‌فلو.

1-Jun-2026 تولید خودکار توسط spf13/cobra

Jun 2026 act 0.2.89