راهنمای Git — میزبانی مخازن Git در یک حساب cPanelcc

1. مقدمه

رابط Git Version Control در cPanel (مسیر cPanel » Home » Files » Git Version Control) بهترین روش برای مدیریت مخازن Git است. این رابط برخی مراحل را خودکار کرده و امکان مشاهده تاریخچه مخزن در Gitweb را فراهم می‌کند.

با داشتن دسترسی مناسب، حساب‌های cPanel می‌توانند مخازن Git را میزبانی کنند. Git تغییرات فایل‌ها را ردیابی کرده و امکان همکاری چند کاربر را فراهم می‌کند. این آموزش نحوه ایجاد یا کلون مخزن، پیکربندی آن و کلون مخزن روی سیستم محلی را توضیح می‌دهد.

برای مشاهده دستورات رایج Git، به مستندات Common Git Commands مراجعه کنید.

2. پیش‌نیازها

برای انجام مراحل این آموزش، باید شرایط زیر را داشته باشید:

• یک حساب فعال cPanel با فضای کافی
• فعال بودن Shell Access برای حساب شما
• ثبت کلید عمومی در مسیر cPanel » Home » Security » SSH Access

نکته مهم: برای کلون مخازن خصوصی باید مراحل اضافی را در مستندات Set Up Access to Private Repositories انجام دهید.

3. میزبانی مخزن Git در cPanel

3.1 ایجاد یا کلون مخزن

می‌توانید مخزن Git را در هر دایرکتوری موجود ایجاد کنید یا یک دایرکتوری جدید بسازید. اگر پروژه شما قبلاً مخزن Git دارد، می‌توانید آن را روی cPanel کلون کنید.

محدودیت‌های مهم:

برای اینکه مخزن در رابط Git Version Control نمایش داده شود:

• نام مخزن یا مسیر آن نباید شامل فاصله یا کاراکترهای زیر باشد:

\ * | " ' < > & @ ` $ { } [ ] ( ) ; ? : = % #

• مخزن نباید در مسیرهای کنترل‌شده توسط cPanel قرار گیرد:

.cpanel, .trash, etc, mail, ssl, tmp, logs, .cphorde, spamassassin, .htpasswds, var, cgi-bin, .ssh, perl5, access-logs

اگر مخزن را با خط فرمان در مسیرهای محدود ایجاد کنید، در رابط cPanel نمایش داده نمی‌شود.

4. ایجاد مخزن جدید

مراحل:

• با SSH وارد حساب cPanel شوید.
• به مسیر موردنظر بروید:

cd ~/Project/example

اگر مسیر وجود ندارد:

mkdir -p ~/Project/example
cd ~/Project/example

برای ایجاد مخزن:

git init

5. کلون مخزن موجود

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

مراحل:

• با SSH وارد حساب cPanel شوید.
• به مسیر موردنظر بروید:

cd ~/Project

اگر مسیر وجود ندارد:

mkdir -p ~/Project
cd ~/Project

کلون مخزن:

git clone https://domain.com/Account/example.git example.git

نکته: مخازن GitHub معمولاً به شکل زیر هستند:

https://github.com/Account/example.git

کلون مخازن بزرگ ممکن است زمان‌بر باشد. تا پایان کلون، اطلاعات HEAD در رابط cPanel نمایش داده نمی‌شود.

رابط Git Version Control اجازه استفاده از URLهای دارای نام کاربری و رمز عبور را نمی‌دهد.

6. به‌روزرسانی تنظیمات Git

این مرحله اختیاری است و باعث می‌شود مخزن هنگام push از سمت سیستم محلی به‌روز بماند.

برای تنظیم:

git config receive.denyCurrentBranch updateInstead

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

نکته: این قابلیت محدودیت‌هایی روی URL کلون اعمال می‌کند.

برای کلون مخزن میزبانی‌شده روی cPanel:

git clone ssh://username@hostname/home/username/Project/example.git

username: نام کاربری cPanel hostname: نام سرور میزبان

8. ارسال تغییرات به مخزن cPanel

پس از اعمال تغییرات روی سیستم محلی، برای ارسال آن‌ها به مخزن میزبانی‌شده:

git push origin master -u

این دستور تغییرات شما را به نسخه موجود در cPanel ارسال می‌کند.

نتیجه‌گیری

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