LogoENEnglish

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

Code این مقاله نحوه پیکربندی Deployment برای مخازن Git مدیریت‌شده در cPanel را توضیح می‌دهد. شامل دو روش اصلی Deployment (Push و Pull)، نحوه ساخت مخزن، ایجاد فایل .cpanel.yml، افزودن ریموت، Push تغییرات و نحوه Pull و Deploy از طریق رابط Git Version Control است.

Git DeploymentcPanel Gitcpanel.yml

~3 دقیقه مطالعه • بروزرسانی ۲ اسفند ۱۴۰۴

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 کنترل دستی بیشتری ارائه می‌دهد.


نوشته و پژوهش شده توسط دکتر شاهین صیامی

Next Article