کار با ریپوزیتوری‌های ریموت

مقدمه

در درس‌های تئوری با مفهوم ریموت و دستورات مربوط به آن آشنا شدیم. اکنون زمان آن است که به صورت عملی و گام به گام، این مفاهیم را در محیط واقعی گیت‌هاب به کار ببریم. این درس شما را در چرخه کامل تعامل با یک مخزن ریموت راهنمایی می‌کند: از ساخت یک مخزن جدید در گیت‌هاب گرفته تا اتصال یک پروژه محلی به آن، و در نهایت، ارسال و دریافت تغییرات.

این جریان کاری، اساس همکاری‌های تیمی در گیت است و تسلط بر آن برای هر توسعه‌دهنده‌ای ضروری است.

مرحله اول: ساخت یک مخزن جدید در گیت‌هاب

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

1. وارد حساب کاربری خود در گیت‌هاب شوید.
2. در گوشه بالا سمت راست، روی آیکون «+» کلیک کرده و گزینه «New repository» را انتخاب کنید.
3. شما به صفحه «Create a new repository» هدایت می‌شوید. فیلدهای زیر را پر کنید:
   • Repository name: یک نام برای مخزن خود انتخاب کنید (مثلاً learning-github).
   • Description: یک توضیح کوتاه و اختیاری در مورد پروژه خود بنویسید.
   • Public / Private: انتخاب کنید که آیا مخزن شما عمومی و قابل مشاهده برای همه باشد یا خصوصی.
   • Initialize this repository with: این بخش بسیار مهم است. برای این تمرین که می‌خواهیم یک پروژه محلی موجود را متصل کنیم، تمام گزینه‌ها (README, .gitignore, license) را خالی بگذارید و تیک نزنید. این کار یک مخزن کاملاً خالی ایجاد می‌کند که اتصال به آن ساده‌تر است.
4. روی دکمه سبز رنگ «Create repository» کلیک کنید.

مرحله دوم: اتصال مخزن محلی به ریموت

پس از ساخت مخزن، گیت‌هاب شما را به صفحه‌ای هدایت می‌کند که دستورات لازم برای اتصال را به شما نمایش می‌دهد. ما سناریوی «push an existing repository from the command line» را دنبال می‌کنیم.

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

1. افزودن ریموت: ابتدا باید آدرس مخزن گیت‌هاب را به عنوان یک ریموت به گیت محلی خود معرفی کنیم. نام قراردادی برای ریموت اصلی، origin است.

   git remote add origin https://github.com/YOUR_USERNAME/learning-github.git

2. تغییر نام برنچ (اختیاری ولی پیشنهادی): برای اطمینان از اینکه نام برنچ اصلی شما main است (که استاندارد جدید است)، دستور زیر را اجرا کنید.

   git branch -M main

3. ارسال (Push) اولیه: در نهایت، برنچ main محلی خود را به ریموت origin پوش می‌کنیم. آپشن -u یک ارتباط تعقیب‌کننده (tracking connection) بین برنچ محلی و ریموت شما برقرار می‌کند.

   git push -u origin main

مرحله سوم: شبیه‌سازی تغییر توسط یک همکار

حالا که کد ما روی گیت‌هاب است، بیایید وضعیتی را شبیه‌سازی کنیم که در آن، یک همکار (یا خود ما از یک کامپیوتر دیگر) تغییری را مستقیماً روی گیت‌هاب اعمال می‌کند. به این ترتیب، مخزن ریموت یک قدم از مخزن محلی ما جلوتر خواهد بود.

ساده‌ترین راه برای این کار، ویرایش مستقیم یک فایل از طریق رابط وب گیت‌هاب است. به صفحه مخزن خود در گیت‌هاب بروید، روی یکی از فایل‌ها کلیک کنید و سپس آیکون مداد (Edit this file) را بزنید. یک خط به فایل اضافه کرده و در پایین صفحه، تغییرات را مستقیماً در برنچ main کامیت کنید.

مرحله چهارم: دریافت تغییرات به سیستم محلی

اکنون مخزن ریموت شما یک کامیت جدید دارد که در مخزن محلی شما موجود نیست. برای همگام‌سازی، باید این تغییرات را به سیستم خود pull کنید. به ترمینال خود برگردید و دستور زیر را اجرا کنید:

git pull

چون در مرحله اول با آپشن -u ارتباط لازم را برقرار کرده بودیم، دیگر نیازی به نوشتن git pull origin main نیست. گیت به صورت خودکار تغییرات را از origin/main دریافت کرده و با برنچ main محلی شما ادغام می‌کند. حالا اگر فایل ویرایش‌شده را در سیستم خود باز کنید، خواهید دید که تغییرات اعمال شده است و مخزن محلی و ریموت شما دوباره یکسان هستند.