مقدمه

• پروژه‌ی GitBucket ابزار و سامانه‌ای جهت مدیریت بهتر پروژه‌ها تحت بستر و مکانیزم Git است.
• GitBucket در مقایسه با GitLab دارای امکانات کمتری بوده اما در مقابل از منابع سخت‌افزاری کمتری استفاده خواهد نمود.
• به عنوان مثال تنها با یک پردازنده و 512 MB حافظه‌ی رم می‌توان این سامانه را راه‌اندازی نمود.
• لازم به ذکر است که این ابزار در مقابل GitLab بسیار سبک بوده و در همین راستا همانند ابزار GitLab از فرآیندهای CI/CD و دیگر ویژگی‌ها این سامانه پشتیبانی نمی‌کند.

مقدمه‌ای بر پروژه‌ی desertco-gitbucket

• پرو‌ژه‌ی desertco-gitbucket به منظور نصب و راه‌اندازی هر چه سریع‌تر و راحت‌تر ابزار GitBucket تهیه شده است.
• این پروژه تحت سیسم‌عامل Gnu-Linux توزیع Ubuntu نسخه‌های 22.04, 20.04 و 18.04 به خوبی راه‌اندازی می‌شود.

دریافت پروژه desertco-gitbucket

• به منظور دریافت پروژه از ابزار git به صورت زیر استفاده نمایید.

# cd /opt/
# git clone http://git.homayouni.info/git/iman/desertco-gitbucket.git -b 4.38.4

• در ادامه وارد پوشه‌ی desertco-gitbucket شوید.

# cd desertco-gitbucket

نصب و راه‌اندازی پروژه desertco-gitbucket

• به منظور نصب و راه‌اندازی پروژه‌ی desertco-gitbucket یک اسکریپت به زبان Bash تهیه شده است.
• این پرونده‌ را به صورت زیر اجرا نمایید.

# cd /opt/desertco-gitbucket/
# bash setup.sh

• در صورتی که فرآیند نصب و راه‌اندازی با موفقیت تمام شود، با تصویری مشابه زیر روبه‌رو خواهید شد.

استفاده از Nginx Reverse Proxy

• معمولا در جلوی ابزارها و سامانه‌های مختلف از Nginx به عنوان Reverse Proxy استفاده می‌شود.
• دلیل این امر استفاده از قابلیت Cache ، راه‌اندازی https و دیگر مزایایی است که Nginx در جلوی سامانه‌ها قرار می‌دهد.
• به طور مختصر و خلاصه توپولوژی استفاده از این قابلیت به شرح زیر است.

تنظیمات DNS

• در صورتی که پروژه را در محیط آزمایشگاهی راه‌اندازی می‌کنید، کافیست پرونده‌ی etc/hosts/ سیستم خود را ابتدا با یک ویرایشگر باز نمایید.

# vim /etc/hosts

• در نهایت اقدام به اضافه نمودن خط زیر به انتهای پرونده‌ی etc/hosts/ نمایید.

172.64.32.16 gitbucket.homayouni.info
172.64.32.16 www.gitbucket.homayouni.info

• در صورتی که از DNS Server در شبکه‌ی داخلی استفاده می‌کنید، کافیست دو عدد A Record به DNS Server موجود در شبکه اضافه نمایید.
• در صورتی که از پروژه در سطح اینترنت استفاده می‌کنید، کافیست دو عدد A Record درون DNS Server عمومی نظیر Cloud Flare اضافه نمایید.
• لطفا توجه نمایید که آدرس 172.64.32.16 و desertco.homayouni.info ذکر شده در این بخش مثال بوده و باید متناسب با سناریو موجود تغییر یابد.

دسترسی به سامانه‌ی تحت وب پروژه‌ی desertco-gitbucket

• به منظور دسترسی به سامانه‌ی تحت وب پروژه‌ی desertco-gitbucket کافیست یک مرورگر باز نموده و وارد آدرس زیر شوید.

https://desertco.homayouni.info

• لطفا توجه نمایید که آدرس desertco.homayouni.info ذکر شده در این بخش مثال بوده و باید متناسب با سناریو موجود تغییر یابد.

تصاویر پروژه‌ی desertco-gitbucket

• در ادامه تعدادی از تصاویر قرار داده شده است.

---

• این مستند تحت شرایط سیستم‌عامل Ubuntu 20.04 – Focal در سمت Server و Client بررسی شده است.