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


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

مقالات مرتبط

راهنمای کامل بازیابی اکانت cPanel و انتقال حساب‌ها و تنظیمات برای مدیران سیستم تازه‌کار

این مقاله یک راهنمای جامع برای مدیران سیستم تازه‌کار است که می‌خواهند اکانت‌های cPanel را بازیابی کنند، حساب‌ها و تنظیمات را بین سرورها منتقل کنند، و از ابزارهای تشخیصی برای بررسی مشکلات انتقال و بازیابی استفاده کنند. این راهنما شامل نحوه استفاده از WHM، نحوه آپلود بکاپ‌ها، روش‌های انتقال، و فعال‌سازی لاگ‌های پیشرفته است.

ادامه

How to Move All cPanel Accounts from One Server to Another

This guide explains how to migrate all cPanel accounts, service configurations, SSL certificates, and the main server IP address from an old source server to a new target server. It covers installation requirements, configuration transfers, account migration, IP reassignment, DNS adjustments, and SSL restoration.

ادامه

آموزش کامل مهاجرت یک وب‌سایت وردپرس از macOS به سرور cPanel & WHM

این مقاله نحوه انتقال یک وب‌سایت وردپرس که روی macOS میزبانی شده است را به یک سرور cPanel & WHM توضیح می‌دهد. شامل خروجی گرفتن از دیتابیس، آپلود فایل‌ها، ایجاد دیتابیس جدید، تنظیم wp-config.php، تغییر URL سایت، و رفع لینک‌ها و تصاویر خراب است.

ادامه

آموزش کامل انتقال دستی یک اکانت بین سرورها در cPanel & WHM

این مقاله نحوه انتقال دستی یک اکانت بین دو سرور را زمانی که حجم اکانت برای ابزارهای انتقال WHM بسیار بزرگ است توضیح می‌دهد. شامل ایجاد دایرکتوری موقت، فشرده‌سازی public_html و لاگ‌ها، انتقال امن با scp، و بازیابی فایل‌ها در سرور جدید است.

ادامه

آموزش کامل مهاجرت دستی داده‌های Horde به Roundcube در cPanel & WHM

این مقاله نحوه مهاجرت دستی تقویم‌ها و مخاطبین Horde به Roundcube را در نسخه‌های 108 تا 118 cPanel & WHM توضیح می‌دهد. شامل مراحل خروجی گرفتن از Horde، انتقال فایل‌ها به مسیرهای صحیح، و وارد کردن داده‌ها در Roundcube با استفاده از افزونه‌های داخلی یا ابزارهای واردسازی است.

ادامه

آموزش کامل مهاجرت دستی اکانت‌ها از کنترل‌پنل‌های غیرپشتیبانی‌شده به cPanel & WHM

این مقاله نحوه مهاجرت دستی اکانت‌ها از کنترل‌پنل‌های غیرپشتیبانی‌شده به cPanel & WHM را توضیح می‌دهد. شامل اقدامات قبل از مهاجرت، نصب سرور جدید، انتقال فایل‌ها و دایرکتوری‌ها، بازیابی دیتابیس‌ها، انتقال SSL، و اقدامات پس از مهاجرت است.

ادامه