راهنمای Git — تنظیم Deployment در cPanel

1. مقدمه

رابط Git Version Control در cPanel (مسیر cPanel » Home » Files » Git Version Control) امکان پیکربندی Deployment برای مخازن Git را فراهم می‌کند. این مقاله دو نوع اصلی Deployment را توضیح می‌دهد:

• Push Deployment — با Push کردن تغییرات به مخزن cPanel، سیستم به‌صورت خودکار Deployment را انجام می‌دهد.
• Pull Deployment — تغییرات از مخزن ریموت Pull شده و سپس از طریق رابط cPanel به‌صورت دستی Deploy می‌شوند.

اگر در تنظیم Deployment مشکل داشتید، مستندات زیر را بررسی کنید:

• Set Up Access to Private Repositories
• Git Problems and How to Fix Them

2. تنظیم Push Deployment

این روش توصیه می‌شود.

2.1 ایجاد یک مخزن خالی در cPanel

اگر مخزن موردنظر هنوز در cPanel وجود ندارد، از رابط Git Version Control یک مخزن خالی ایجاد کنید.

نکته مهم: در این مرحله مخزن ریموت را کلون نکنید. فقط یک مخزن خالی بسازید.

2.2 کلون مخزن ریموت روی سیستم محلی

git clone URL

نکته مهم: برای کلون مخازن خصوصی باید مراحل اضافی انجام دهید. در غیر این صورت با خطا مواجه می‌شوید.

برای یافتن Clone URL:

• به Git Version Control بروید
• روی Manage کلیک کنید
• URL را از بخش Clone URL کپی کنید

2.3 ساخت فایل .cpanel.yml

برای فعال‌سازی Deployment باید فایل .cpanel.yml را در ریشه مخزن قرار دهید.

نمونه فایل:

---
deployment:
 tasks:
 - export DEPLOYPATH=/home/user/public_html/
 - /bin/cp index.html $DEPLOYPATH
 - /bin/cp style.css $DEPLOYPATH

برای اطلاعات بیشتر، مستندات Deployment را بخوانید.

2.4 افزودن مخزن cPanel به‌عنوان ریموت

git remote add origin URL

در این دستور، URL همان Clone URL مخزن cPanel است.

2.5 Push تغییرات به مخزن cPanel

git push -u origin HEAD

پس از قرار گرفتن فایل .cpanel.yml در مخزن، هر Push جدید به‌صورت خودکار Deploy می‌شود.

نکته: اگر Push با خطا مواجه شد، احتمالاً مخزن خصوصی است و نیاز به SSH Access دارید.

---

3. تنظیم Pull Deployment

3.1 کلون مخزن ریموت روی cPanel

اگر مخزن هنوز روی cPanel وجود ندارد، از طریق Git Version Control آن را کلون کنید.

نکته: cPanel محدودیت‌هایی روی Clone URL اعمال می‌کند و کلیدهای SSH را بررسی می‌کند.

3.2 کلون مخزن ریموت روی سیستم محلی

git clone URL

3.3 ساخت فایل .cpanel.yml

---
deployment:
 tasks:
 - export DEPLOYPATH=/home/user/public_html/
 - /bin/cp index.html $DEPLOYPATH
 - /bin/cp style.css $DEPLOYPATH

3.4 Push تغییرات به مخزن ریموت

git push origin HEAD

3.5 Pull و Deploy از طریق cPanel

• به Git Version Control بروید
• روی Manage کلیک کنید
• به تب Pull or Deploy بروید
• روی Update from Remote کلیک کنید
• روی Deploy HEAD Commit کلیک کنید

در این روش Deployment خودکار انجام نمی‌شود و باید هر بار مراحل را تکرار کنید.

نتیجه‌گیری

با استفاده از Push یا Pull Deployment می‌توانید فرآیند استقرار پروژه‌های Git را در cPanel مدیریت کنید. Push Deployment کاملاً خودکار است، در حالی که Pull Deployment کنترل دستی بیشتری ارائه می‌دهد.