فصل 3 عملیات‌های گیت درس 1 از 16

آموزش گیت - عملیات clone

دستور git clone برای ایجاد یک نسخه کپی یا «کلون» از یک مخزن Git موجود استفاده می‌شود. وقتی یک مخزن را کلون می‌کنیم، در واقع تمام کدها، فایل‌ها، تاریخچه و شاخه‌ها را از یک مخزن ریموت (remote) به سیستم محلی (local) دانلود می‌کنیم. این کار به ما امکان می‌دهد روی پروژه به‌صورت محلی کار کنیم و پس از اعمال تغییرات، به‌روزرسانی‌ها را دوباره به مخزن ریموت پوش (push) کنیم.

به زبان ساده، git clone روشی برای کپی کردن یک مخزن از یک سرور (مانند GitHub، GitLab، Bitbucket یا هر سرویس میزبانی مبتنی بر Git دیگر) به سیستم خودمان است.

Basic Syntax

git clone <repository-url>

برای مثال، برای کلون کردن یک مخزن از GitHub، دستور زیر را اجرا می‌کنیم:

git clone https://github.com/user/repository.git

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

Cloning with SSH

بسیاری از توسعه‌دهندگان ترجیح می‌دهند برای کلون کردن مخازن به‌جای HTTPS از SSH (Secure Shell) استفاده کنند. دلیلش این است که کلیدهای SSH امن‌تر هستند و نیاز به وارد کردن رمز عبور در هر بار تعامل با مخزن ریموت را از بین می‌برند.

برای کلون کردن یک مخزن با استفاده از SSH، باید از آدرس SSH استفاده کنیم:

git clone git@github.com:user/repository.git
Note: باید یک کلید SSH بسازیم و آن را به سرویس میزبانی Git (مثلاً GitHub یا GitLab) اضافه کنیم. پس از پیکربندی، می‌توانیم مخازن را با SSH بدون وارد کردن رمز عبور در هر بار کلون کنیم.

Cloning into a Specific Directory

به‌صورت پیش‌فرض، git clone یک پوشه جدید با همان نام مخزن می‌سازد. با این حال، می‌توانیم با افزودن یک آرگومان اضافی، پوشه دیگری را مشخص کنیم:

git clone <repository-url> <directory-name>

برای مثال، برای کلون کردن یک مخزن در یک پوشه متفاوت، دستور زیر را اجرا می‌کنیم:

git clone https://github.com/user/repository.git my-directory

Cloning a Specific Branch

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

git clone -b <branch-name> <repository-url>

برای مثال:

  
git clone -b develop https://github.com/user/repository.git

دستور بالا به‌جای شاخه پیش‌فرض، شاخه develop را کلون می‌کند.

Cloning Only the Latest Changes (Shallow Clone)

گاهی ممکن است به کل تاریخچه یک مخزن نیاز نداشته باشیم، به‌خصوص اگر یک پروژه بزرگ با کامیت‌های زیاد باشد. در چنین مواردی می‌توانیم با استفاده از گزینه --depth یک «کلون سطحی» (shallow clone) انجام دهیم. کلون سطحی فقط آخرین تغییرات (کامیت‌ها) را تا عمق مشخص‌شده دانلود می‌کند که می‌تواند در زمان و فضای دیسک صرفه‌جویی کند.

دستور زیر فقط ۱۰ کامیت آخر را کلون می‌کند*:

git clone --depth 10 https://github.com/user/repository.git

Cloning with Submodules

برخی مخازن Git از زیرماژول‌ها (submodules) استفاده می‌کنند که مخازنی تو در تو در داخل مخازن دیگر هستند. اگر مخزنی که در حال کلون کردن آن هستیم شامل زیرماژول باشد، می‌توانیم از گزینه --recurse-submodules استفاده کنیم تا زیرماژول‌ها همراه با مخزن اصلی به‌طور خودکار مقداردهی اولیه و کلون شوند.

برای مثال:

git clone --recurse-submodules https://github.com/user/repository.git

این دستور نه تنها مخزن اصلی را کلون می‌کند، بلکه تمام زیرماژول‌های آن را نیز مقداردهی اولیه و کلون می‌کند.

Cloning a Bare Repository

در Git، مخزن «bare» مخزنی بدون پوشه کاری (working directory) است. به عبارت دیگر، مخزنی است که فقط شامل داده‌های کنترل نسخه است و فایل‌های واقعی در آن نیستند. مخازن bare معمولاً روی سرورها یا در محیط‌هایی استفاده می‌شوند که مخزن به‌طور فعال توسعه داده نمی‌شود، بلکه فقط برای همکاری استفاده می‌شود.

برای ایجاد یک کلون bare از یک مخزن، از گزینه --bare استفاده کنید:

git clone --bare https://github.com/user/repository.git

این کار مخزنی ایجاد می‌کند که فقط شامل پوشه .git و بدون هیچ‌یک از فایل‌های کاری است. مخازن bare اغلب به‌عنوان مخزن ریموت یا مخزن مرکزی برای همکاری تیمی استفاده می‌شوند.

Git Clone vs. Git Pull

هر دو دستور شامل دریافت داده از یک مخزن ریموت هستند، اما اهداف متفاوتی دارند:

  • git clone: این دستور زمانی استفاده می‌شود که بخواهیم یک نسخه کپی جدید از یک مخزن روی سیستم محلی ایجاد کنیم. معمولاً وقتی برای اولین بار شروع به کار روی یک مخزن می‌کنیم، یک بار برای هر پروژه استفاده می‌شود.

  • git pull: پس از اینکه یک مخزن را کلون کردیم، از git pull استفاده می‌کنیم تا آخرین تغییرات را از مخزن ریموت دریافت کنیم و آن‌ها را در مخزن محلی ادغام (merge) کنیم. این دستور برای به‌روز نگه‌داشتن نسخه محلی با نسخه ریموت به کار می‌رود.

Common Use Cases for `git clone`

بیایید برخی سناریوهای رایج را بررسی کنیم که در آن‌ها git clone به‌طور معمول استفاده می‌شود.

  • Setting Up a New Project: وقتی به یک پروژه جدید می‌پیوندیم، اولین کاری که احتمالاً انجام می‌دهیم کلون کردن مخزن روی سیستم محلی است. این کار به ما امکان می‌دهد ساختار پروژه را بررسی کنیم، کد را اجرا کنیم و شروع به مشارکت کنیم.

  • Forking and Cloning: در پلتفرم‌هایی مثل GitHub، می‌توانیم یک مخزن را «fork» کنیم که یک نسخه کپی شخصی از مخزن زیر حساب کاربری ما ایجاد می‌کند. پس از fork کردن، می‌توانیم مخزن fork‌شده را کلون کنیم و به‌صورت مستقل روی آن کار کنیم. وقتی تغییرات را ایجاد کردیم، می‌توانیم یک pull request ارسال کنیم تا تغییرات دوباره در مخزن اصلی ادغام شوند.

  • Collaborating on Open Source Projects: توسعه متن‌باز به شدت به دستور git clone متکی است. توسعه‌دهندگان از سراسر جهان می‌توانند مخازن عمومی را کلون کنند، مشارکت داشته باشند و تغییرات خود را به پروژه اصلی پوش کنند.

Troubleshooting Common Issues

اگرچه git clone معمولاً سرراست است، ممکن است با برخی مشکلات مواجه شویم:

  • Permission Denied (SSH Issues): اگر هنگام استفاده از SSH خطای «Permission denied» دریافت کردیم، باید مطمئن شویم که کلید SSH به‌درستی تنظیم شده و به سرویس میزبانی Git اضافه شده است.

  • Repository Not Found: این خطا می‌تواند زمانی رخ دهد که آدرس (URL) نادرست باشد یا به مخزن دسترسی نداشته باشیم.

  • Slow Cloning: اگر کلون کردن یک مخزن بزرگ کند است، برای کاهش حجم داده‌های در حال کلون شدن، استفاده از کلون سطحی با گزینه --depth را در نظر بگیرید.

پیشرفت مطالعه: وضعیت خوانده‌شدن این درس فقط در همین مرورگر ذخیره می‌شود؛ بدون نیاز به حساب کاربری.