Pachim CLI — راهنمای کامل نصب، راهاندازی و دیپلوی #
Pachim CLI ابزار رسمی خط فرمان Pachim برای دیپلوی سریع پروژهها روی سرورهای شماست.
با این ابزار میتوانید بدون نیاز به ورود به پنل، پروژه را بستهبندی، آپلود، دیپلوی و وضعیت اجرا را از ترمینال مدیریت کنید.
Pachim CLI چیست؟ #
Pachim CLI یک ابزار command-line است که برای تیمهای توسعه طراحی شده تا فرآیند دیپلوی پروژه را ساده، سریع و قابل تکرار کند.
با pachim میتوانید:
- وارد حساب کاربری خود شوید.
- سایتها را ببینید و انتخاب کنید.
- پروژه را به سایت هدف push کنید.
- وضعیت دیپلوی را لحظهای ببینید.
- تنظیمات git merge را برای آپلودها مدیریت کنید.
- در نسخههای جدید، هنگام انتشار آپدیت، بهصورت تعاملی بهروزرسانی انجام دهید.
پیشنیازها #
قبل از استفاده:
- یک حساب فعال در Pachim داشته باشید.
- حداقل یک سایت روی سرور خود در Pachim ساخته باشید.
- روی سیستم خود یکی از روشهای نصب CLI را انجام دهید.
- برای اولین استفاده، دستور login را اجرا کنید.
روشهای نصب #
1) Linux / macOS (پیشنهادی) #
curl -fsSL https://mirrors.pachim.app/cli/install.sh | sh
2) Windows PowerShell #
irm https://mirrors.pachim.app/cli/install.ps1 | iex
3) Windows (Winget) #
winget install Pachim.PachimCLI
4) Windows (Scoop) #
scoop bucket add pachimsh https://github.com/pachimsh/scoop-bucket
scoop install pachim
5) Windows (MSI Installer) #
دانلود مستقیم MSI:
https://mirrors.pachim.app/cli/pachim_windows_amd64.msi
MSI بهصورت خودکار pachim.exe را نصب میکند و مسیر را به PATH اضافه میکند.
شروع سریع (Quick Start) #
مرحله 1: ورود به حساب #
pachim login
بعد از اجرا، ایمیل و رمز عبور پرسیده میشود.
مرحله 2: مشاهده سایتها #
pachim sites
مرحله 3: اتصال پروژه به سایت #
در روت پروژه:
pachim init
این دستور فایل .pachim.json را در پروژه ایجاد میکند و سایت پیشفرض را مشخص میکند.
مرحله 4: دیپلوی #
pachim push
اگر چند سایت دارید:
pachim push --site staging
ساختار فایلها #
1) اطلاعات کاربر (Profile) #
مسیر: ~/.pachim/profiles/<profile>.json
این فایل شامل token ورود است و نباید commit شود.
2) تنظیم پروژه #
مسیر: .pachim.json (داخل ریشه پروژه)
نمونه:
{
"default": "example.com",
"sites": {
"example.com": {
"site_id": "uuid-here",
"domain": "example.com"
},
"staging": {
"site_id": "uuid-staging",
"domain": "staging.example.com"
}
}
}
3) تنظیم سراسری CLI (Dev / Local Override) #
مسیر: ~/.pachim/pachim.json
(برای override محلی API URL با دستور dev داخلی)
دستورات اصلی CLI #
pachim login
ورود به حساب و ذخیره token
pachim logout
خروج از حساب و حذف token محلی
pachim whoami
نمایش اطلاعات کاربر فعلی
pachim sites
لیست سایتهای شما
pachim init
اتصال پروژه فعلی به یک یا چند سایت
<pachim use <alias
تغییر سایت پیشفرض پروژه
pachim push
بستهبندی پروژه، آپلود و شروع دیپلوی
pachim git-merge
نمایش/فعالسازی/غیرفعالسازی حالت git merge برای آپلود
pachim profiles
مدیریت پروفایلها
رفتار هوشمند هنگام push #
در pachim push:
- پروژه zip میشود (با رعایت فایلهای git)
- درصد پیشرفت packaging و upload نمایش داده میشود
- وضعیت دیپلوی poll میشود (queued, deploying, finished, failed)
- در پایان، در صورت وجود commitهای local، امکان پیشنهاد git push داده میشود
Git Merge در آپلودها #
اگر git merge غیرفعال باشد:
- CLI قبل از ادامه، هشدار میدهد که آپلود شما full replace خواهد بود
- میتواند همان لحظه git merge را برای سایت فعال کند
- برای اولین دیپلوی هم جریان جداگانه و امنی در نظر گرفته شده تا کاربر تجربه بهتری داشته باشد
آپدیت CLI #
CLI هنگام اجرای دستورات، نسخه جدید را بررسی میکند و در صورت وجود آپدیت، از کاربر تأیید میگیرد.
روی نصبهای معمولی (script/zip/scoop) #
آپدیت باینری مستقیم انجام میشود.
روی نصب MSI (Windows) #
آپدیت از مسیر MSI انجام میشود (ممکن است UAC/Administrator prompt نمایش داده شود).
نکات شبکه و Mirror #
در برخی سرورها ممکن است دسترسی مستقیم به mirror دچار اختلال DNS باشد.
برای همین در جریان deploy:
- قبل از اجرای اسکریپت اصلی دیپلوی، pre-check انجام میشود
- اگر URL آپلود در دسترس نبود، nameserverهای fallback روی سرور اعمال میشوند
- سپس دانلود مجدد فایل انجام میشود
این کار بهخصوص برای سرورهای isolate یا محدودشده بسیار مفید است.
خروجیها و روش انتشار #
Pachim CLI بهصورت چندکاناله منتشر میشود:
- GitHub Releases
- Mirror S3 (mirrors.pachim.app/cli)
- Scoop
- Winget
- MSI
امنیت #
- Tokenها فقط local نگهداری میشوند
- فایل profile را commit نکنید
پیشنهاد برای تیمها #
اگر چند محیط دارید (dev/staging/prod):
- برای هر محیط alias جدا در .pachim.json بگذارید.
- سایت پیشفرض را روی staging تنظیم کنید.
- production را با –site production صراحتاً deploy کنید.
این کار ریسک deploy اشتباه را کم میکند.
جمعبندی #
Pachim CLI برای تیمهایی ساخته شده که میخواهند:
- سریعتر deploy کنند.
- workflow استاندارد و قابل تکرار داشته باشند.
- از یک ابزار واحد برای نصب، آپدیت و دیپلوی استفاده کنند.
اگر هنوز نصب نکردهاید، همین الان با یکی از روشهای بالا شروع کنید و اولین deploy را با:
pachim login
pachim init
pachim push
انجام دهید.
