همه برنامهنویسانی که در مسیر توسعه نرمافزار قدم برمیدارند با گیتهاب بهعنوان یکی از پرکاربردترین پلتفرمهای کنترل و نسخه و همکاری تیمی آشنا هستند. اما شناخت Github تنها نیمی از مسیر است. بخش مهمتر ماجرا استفاده عملی از آن برای مدیریت، ذخیرهسازی و انتشار پروژههاست و در رأس این فرایند، بارگذاری پروژه در Github یا آپلود پروژه در گیت هاب قرار دارد.
در این مقاله، قصد داریم بهصورت گامبهگام، روشهای نحوه بارگذاری پروژه در گیت هاب را آموزش دهیم. چه از خط فرمان استفاده کنید، چه بخواهید با محیط گرافیکی GitHub Desktop کار کنید، این راهنما شما را از ابتدا تا پایان همراهی خواهد کرد. علاوهبرآن، در پایان نیز نحوهٔ حذف پروژه از گیتهاب را بررسی میکنیم تا بتوانید در صورت نیاز، مخازن خود را مدیریت کنید.
در نهایت، اگر «چگونه پروژه را در گیت هاب آپلود کنم؟» ذهنتان را مشغول کرده است یا میخواهید با نحوه بارگذاری پروژه در Github آشنا شوید، این مقاله برای شما مناسب خواهد بود.
فهرست مطالب
دسترسی سریع به ویدئوهای آپلود پروژه در گیت هاب
پیشنیازهای آپلود پروژه در گیت هاب
قبل از اینکه نحوه آپلود پروژه در گیت هاب را بررسی کنیم، نیاز است چند مرحله آمادهسازی را پشت سر بگذارید. این مراحل شامل ساخت حساب کاربری، نصب نرمافزارهای لازم و انجام تنظیمات اولیه است.
ساخت حساب کاربری در گیتهاب
اگر هنوز حساب کاربری در گیتهاب ندارید، ابتدا باید یکی ایجاد کنید. خوشبختانه مراحل ساخت حساب بسیار ساده است. ما در مقاله زیر، همه مراحل ساخت حساب کاربری در گیتهاب را با عکس و ویدئو توضیح دادهایم که میتوانید به آن مراجعه کنید.
پیشنهاد مطالعه: Github چیست؟ راهنمای کامل ساخت اکانت در گیت هاب
نصب Git و GitHub Desktop
برای آپلود پروژه در Github دو مسیر کلی وجود دارد:
- مسیر خط فرمان (CLI) که به دانش اولیهی ترمینال نیاز دارد؛
- مسیر گرافیکی (GUI) که با استفاده از نرمافزار GitHub Desktop انجام میشود و مناسب کاربران مبتدی است.
۱- نصب Git:
به سایت رسمی Git مراجعه و نسخه متناسب با سیستمعامل خود را دانلود و نصب کنید.
پس از نصب، میتوانید با اجرای دستور git –version در ترمینال، از نصب موفق آن اطمینان حاصل کنید.
۲- نصب Github Desktop:
به سایت رسمی GitHub Desktop مراجعه کنید.
پس از دانلود و نصب، نرمافزار را اجرا کنید و با حساب گیتهاب خود وارد شوید (در بخش آپلود با رابط گرافیکی بیشتر توضیح داده میشود).
انجام تنظیمات اولیه Git
برای اینکه Git بتواند به درستی کامیتهای شما را ثبت کند، باید اطلاعات اولیهی کاربری خود را در آن تنظیم کنید. این کار تنها یکبار لازم است و از طریق دستورات زیر انجام میشود:
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"
اگر هنوز هیچ بارگذاری پروژهای در گیت هاب گسترش ندادهاید، اجرای این دستورات ضروریست تا نام و ایمیل شما در تاریخچهی پروژهها ثبت شود.
آموزش آپلود پروژه در گیت هاب با استفاده از خط فرمان
اگر شما هم مثل من از این لذت میبرید که آپلود پروژه در گیت هاب را با دست خودتان و از عمق پشتصحنهٔ محیط برنامهنویسی انجام دهید، روش خط فرمان (Terminal) برای شما ساختهشده است. منظور از ترمینال محیطی در سیستم عامل است که با نوشتن چند دستور ساده کارهای پیشرفته انجام میشود. درست مثل یک گفتگوی شما و رایانهتان. در ادامه فرض میکنیم شما یک پروژه دارید و میخواهید آن را در گیت هاب آپلود کنید. برای این کار:
- ابتدا پوشه پروژه را در ترمینال باز کنید. (با دستور cd)
- سپس دستورات زیر را وارد کنید:
git init
ابتدا پروژه را به یک مخزن گیت تبدیل میکنیم.
git add .
تمام فایلهای پروژه را برای ارسال آماده میکنیم.
git commit -m "اولین کامیت"
یک نقطه ذخیره (commit) برای فایلها ثبت میکنیم.
git remote add origin https://github.com/username/repo-name.git
مخزن گیت هاب خود را به پروژه وصل میکنیم.
git push -u origin main
در نهایت پروژه را روی گیت هاب بارگذاری میکنیم. برای جزئیات بیشتر به فیلم آموزشی نحوه آپلود پروژه در گیت هاب با خط فرمان در ابتدای همین بخش مراجعه کنید.
نکات مهم آپلود پروژه در گیت هاب با خط فرمان
۱- احراز هویت (Authentication Failure):
اگر با خطای authentication مواجه شدید، مطمئن شوید که:
- از توکن دسترسی شخصی (Personal Access Token) استفاده میکنید، نه رمز عبور ساده.
- نام کاربری و لینک مخزن (repo) را درست وارد کردهاید.
۲- تفاوت بین main و master:
گیت قبلاً از master به عنوان شاخه اصلی استفاده میکرد، اما در نسخههای جدید main شاخه پیشفرض است. اگر پروژه شما از شاخه master استفاده میکند، کافیست در دستور push بهجای main بنویسید:
git push -u origin master
۴- آموزش آپلود پروژه در گیت هاب با رابط گرافیکی (GitHub Desktop)
اگر ترجیح میدهید بهجای نوشتن دستور، با کلیککردن کارها را انجام دهید، برنامه GitHub Desktop دقیقاً برای همین کار ساختهشده است. این ابزار رسمی گیتهاب، یک رابط تصویری ساده و کاربردی است که شما را از پیچیدگیهای دستوری آپلود پروژه در گیت هاب نجات میدهد.
مراحل نصب GitHub Desktop:
اگر هنوز نرمافزار بارگذاری پروژه در گیت هاب را نصب نکردهاید، میتوانید ویدیوی آموزشی نصب و راهاندازی آن را در ابتدای این بخش مشاهده کنید.
- به سایت desktop.github.com بروید و نرمافزار را دانلود و نصب کنید.
- پس از نصب، وارد حساب کاربری گیت هاب خود شوید.
نحوه آپلود پروژه در گیت هاب با رابط گرافیکی:
حالا فرض کنیم پروژه شما در یک پوشه محلی (local) وجود دارد:
۱- برنامه GitHub Desktop را باز کنید.
۲- از منوی بالا، روی File > Add Local Repository کلیک کنید.
۳- مسیر پوشه پروژهتان را انتخاب کرده و روی Add Repository بزنید. (توجه: اگر پروژه قبلاً با Git مقداردهی اولیه نشده (init نشده)، GitHub Desktop خودش این کار را انجام میدهد).
۴- از بالای صفحه، روی Publish repository بزنید.
۵- در پنجره بازشده، نام مخزن، توضیحات، حالت عمومی یا خصوصی بودن را انتخاب کنید و روی Publish Repository کلیک کنید.
تبریک میگوییم! پروژه شما با موفقیت در گیت هاب بارگذاری شد.
چند نکته مفید:
- همگامسازی آسان: در آینده فقط کافی است روی دکمه Push origin بزنید تا تغییرات جدید به گیت هاب منتقل شوند.
- مشاهده پروژه در گیت هاب: در بالای GitHub Desktop، روی لینک View on GitHub کلیک کنید تا پروژهتان را در سایت گیت هاب ببینید.
در بخش بعدی آموزش، به شما نشان خواهیم داد که اگر روزی خواستید پروژهای را از گیت هاب حذف کنید، چطور این کار را بهصورت اصولی انجام دهید.
نحوه حذف پروژه از گیت هاب (حذف مخزن)
آپلود پروژه در گیت هاب یک بخش کار است. گاهی ممکن است بخواهید پروژهای را که قبلاً روی گیتهاب بارگذاری کردهاید، حذف کنید. این کار کاملاً امکانپذیر است و فقط چند کلیک ساده نیاز دارد. اما دقت کنید: این عملیات برگشتناپذیر است. بعد از حذف، دیگر هیچکسی (حتی خودتان) به آن مخزن دسترسی نخواهد داشت.
مراحل حذف مخزن (Repository) در GitHub:
- وارد سایت GitHub.com شوید و به حساب کاربریتان لاگین کنید.
- از منوی بالا، روی Repositories کلیک کرده و مخزنی را که میخواهید حذف کنید را انتخاب کنید.
- از بخش بالای مخزن، وارد Settings شوید.
- به پایین صفحه اسکرول کنید تا به قسمت Danger Zone برسید.
- روی دکمه قرمزرنگ Delete this repository کلیک کنید.
- GitHub برای تأیید، از شما میخواهد نام کامل مخزن را تایپ کنید (مثلاً: username/repository-name) و سپس روی I understand the consequences, delete this repository کلیک کنید.
اگر احراز هویت دو مرحلهای (2FA) را فعال کردهاید، ممکن است لازم باشد کد تأیید هم وارد کنید.
نکات مهم حذف پروژه از گیتهاب:
قبل از حذف پروژه از گیت هاب، شاید لازم باشد که نکات زیر را موردتوجه قرار دهید:
- حذف فقط برای مالک یا ادمین مخزن امکانپذیر است.
- پس از حذف، همه Issues، Pull Requestها، Releases و فایلها از بین میروند.
- اگر میخواهید فقط دسترسی دیگران را ببندید، میتوانید بهجای حذف آن، پروژه را به حالت Private تغییر دهید.
گیتهاب و سرور ابری؛ دو بال برای پروژههای حرفهای
گیتهاب به شما امکان میدهد پروژههایتان را مدیریت، اشتراکگذاری و نسخهبندی کنید؛ اما تنها زمانی به یک توسعهدهنده حرفهای تبدیل میشوید که بدانید پشت پروژهای که منتشر میکنید، چه زیرساختی خوابیده است. فرض کنید آپلود پروژه در گیت هاب را به نحو احسنت انجام دادهاید. اما حالا چه؟ آیا همیشه از لپتاپ شخصیتان برای اجرای آن استفاده میکنید؟ یا هر بار برای تست و اجرای پروژه، منتظر نصب وابستگیها و راهاندازی محیط توسعه میمانید؟
در اینجاست که سرور ابری وارد میدان میشود. سرور ابری درست مثل یک کامپیوتر همیشه روشن است که هر زمان و از هر کجا به آن دسترسی دارید. با اتصال گیتهاب به سرور ابری، پروژههای شما بهصورت خودکار اجرا، تست و حتی منتشر میشوند. دیگر خبری از نصبهای مکرر، تنظیمات وقتگیر یا نگرانی بابت خاموششدن سیستم نیست.
ابر فردوسی این مسیر را برایتان هموار کرده است. با زیرساختی بومی، سریع و مقرونبهصرفه میتوانید پروژههایتان را از یک مخزن ساده گیتهاب به یک سرویس واقعی و در حال اجرا تبدیل کنید.
جمعبندی: پروژهات را آپلود کن، اما حرفهای
در مقاله آپلود پروژه در گیت هاب یاد گرفتیم که چگونه پروژههایمان را با خط فرمان یا رابط گرافیکی روی Github آپلود کنیم، آنها را مدیریت کنیم و در صورت نیاز حذف کنیم. اما یک توسعهدهنده واقعی فقط به دنبال ذخیرهسازی کد نیست؛ او دنبال عملکرد پایدار، مدیریت حرفهای و مقیاسپذیری واقعی است.
گیتهاب ابزار قدرتمندی است، اما وقتی با زیرساخت ابری ترکیب شود، قدرت عملکرد شما را ارتقا میدهد. حالا وقت آن است که با ترکیب این دو، پروژههایتان را زنده کنید.
سؤالات متداول آپلود پروژه در گیت هاب
آیا برای آپلود پروژه در گیت هاب باید حتماً برنامهنویس باشم؟
خیر. حتی اگر توسعهدهنده نیستید، با دنبال کردن مراحل ساده این مقاله میتوانید پروژههای ساده یا حتی فایلهای غیربرنامهنویسی را هم در گیتهاب آپلود کنید.
تفاوت main و master در گیتهاب چیست؟
master شاخه پیشفرض قدیمی گیت بود؛ امروزه گیتهاب از main به عنوان شاخهی پیشفرض استفاده میکند. از نظر عملکرد تفاوتی ندارند، فقط نام آنها متفاوت است.
چرا هنگام push کردن با خطای authentication failure مواجه میشوم؟
احتمالاً بهدلیل استفاده از رمز عبور بهجای personal access token (در اکانتهایی با احراز هویت دو مرحلهای) یا اشتباه در آدرس remote. پیشنهاد میشود از SSH یا PAT استفاده کنید.
یا امکان آپلود پروژه از طریق موبایل هم وجود دارد؟
بله. با اپلیکیشن GitHub یا ابزارهای مدیریت گیت در موبایل (مانند Termux در اندروید) میتوانید به صورت محدود پروژه آپلود کنید: اما برای آپلود پروژه در گیت هاب استفاده از کامپیوتر پیشنهاد میشود.
آیا گیتهاب فضای ذخیرهسازی محدودی دارد؟
بله. برای هر مخزن محدودیتهایی مانند حجم فایل (۱۰۰ مگابایت به ازای هر فایل) و محدودیت کلی (حدود ۱ گیگابایت به ازای هر ریپازیتوری) وجود دارد.
چگونه یک پروژهی آپلود شده را از گیتهاب حذف کنم؟
وارد صفحهی پروژه شوید به بخش Settings بروید و به پایین اسکرول کنید و روی گزینهی Delete this repository کلیک کنید. سپس نام پروژه را تایپ و تأیید کنید.
آیا آپلود پروژه در گیتهاب خصوصی هم امکانپذیر است؟
بله. هنگام ساخت مخزن میتوانید گزینهی Private را انتخاب کنید تا فقط افراد مجاز به آن دسترسی داشته باشند.