Gitea

پلتفرم Gitea یک سیستم کنترل نسخه بسیار سبک و متن‌باز است که به زبان Go توسعه یافته است. اگر به امکانات پایه‌ای کنترل نسخه، مرور کد، ردیابی مسائل (Issue Tracking) و مدیریت مخازن نیاز دارید اما نمی‌خواهید زیرساخت خود را با مصرف بالای منابع در سیستم‌های سنگینی مانند GitLab درگیر کنید، Gitea بهترین گزینه جایگزین در معماری شماست. در پلتفرم ابری پارس‌پک، این ابزار به‌صورت یک کانتینر مستقل و یکپارچه مستقر می‌شود و تمامی متغیرهای ادمین پیش از استقرار مستقیما به آن تزریق می‌شوند تا سایت بدون نیاز به پیکربندی دستی، آماده استفاده باشد.

مراحل استقرار

برای مشاهده راهنمای گام‌به‌گام ساخت سرویس و پیکربندی‌های پایه، به مستندات «استقرار برنامه‌های آماده» مراجعه کنید. همچنین برای تنظیمات زیرساختی نیز به بخش مدیریت اپلیکیشن مراجعه کنید:

پیش‌نیازها و استقرار برنامه

در استقرار کانتینری Gitea، معماری سیستم دارای الزامات زیر است که باید در زمان دیپلوی به آن‌ها توجه کنید:

  • سطح دسترسی سیستمی: این کانتینر برای به حداکثر رساندن امنیت زیرساخت، با دسترسی کاربر عادی (Non-Root) اجرا می‌شود. بنابراین شما امکان اعمال تغییرات در سطح سیستم‌عامل یا نصب پکیج‌های پایه را در ترمینال ندارید.

  • تخصیص منابع پردازشی: ماهیت Gitea به‌گونه‌ای است که بر خلاف سایر پلتفرم‌های DevOps به منابع پردازشی عظیمی نیاز ندارد و با حداقل رم (حتی پلن‌های پایه مانند ۱ گیگابایت) نیز عملکرد پایداری ارائه می‌دهد.

  • فضای ذخیره‌سازی و بکاپ: از آنجا که این سرویس میزبان سورس‌کدهای حیاتی شماست، کاهش فضای ذخیره‌سازی (Scale Down) پس از استقرار، خطر نابودی کدهای شما را به همراه دارد. با افزایش حجم مخازن، صرفاً مجاز به افزایش (Scale Up) دیسک هستید. همچنین روشن گذاشتن گزینه بکاپ خودکار در زمان ساخت اکیداً توصیه می‌شود.

متغیرهای محیطی

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

  • gitea admin email: آدرس ایمیل معتبر برای مدیر ارشد سیستم.

  • gitea admin username: نام کاربری اختصاصی مدیر ارشد که برای ورود به پنل استفاده می‌شود.

  • gitea admin password: رمز عبور قدرتمند برای اکانت مدیریت که سیستم یک رشته امن برای آن پیشنهاد می‌دهد (امکان تغییر این رمز وجود دارد).

  • Version of gitea Image: انتخاب نسخه ایمیج اجرایی کانتینر متناسب با نیازمندی‌های تیم توسعه.

نکته: برای آموزش گام‌به‌گام نحوه تعریف متغیرهای اختصاصی، ConfigMapها و Secretها در داشبورد، به مستندات متغیرهای محیطی مراجعه کنید.

تنظیمات دامنه

سیستم Gitea برای تولید صحیح لینک‌های Clone مخازن و مدیریت نشست‌های کاربری، نیازمند تنظیم دقیق دامنه اصلی است. پیش از تعریف پروژه‌ها و دعوت از اعضای تیم، حتماً دامنه اختصاصی خود را متصل کنید. جهت انجام این کار به راهنمای تنظیمات دامنه و IP مراجعه نمایید.

راه‌اندازی و ورود به پنل مدیریت

به دلیل تزریق متغیرهای محیطی در زمان ساخت، هسته Gitea پس از استقرار به صورت خودکار پیکربندی شده و نیازی به طی کردن مراحل نصب دستی ندارد. برای ورود به پلتفرم مراحل زیر را طی کنید:

۱. پس از اتمام استقرار و فعال شدن وضعیت سرویس در داشبورد، آدرس سایت خود (ساب‌دامین ابری یا دامنه اختصاصی متصل‌شده) را در مرورگر باز کنید تا ظاهر اصلی Gitea بارگذاری شود.

۲. در گوشه سمت راست بالای صفحه، بر روی گزینه Sign In کلیک کنید.

۳. در صفحه لاگین، نام کاربری تعیین‌شده در فیلد gitea admin username و رمز عبور مشخص‌شده در مرحله ساخت را وارد کنید تا مستقیما وارد پیشخوان مدیریت مخازن کد خود شوید.