የDocker መተግበሪያ ዝርጋታ መመሪያ (Production Runbook)

ይህ መመሪያ የስርዓት አስተዳዳሪዎች የYeneSchoolን መድረክ በይፋዊ የDocker Compose ስብስብ አማካኝነት በሰርቨር ላይ እንዲዘረጉ ደረጃ በደረጃ ይመራል።

1. ቅድመ-ሁኔታዎች

ስራውን ከመጀመርዎ በፊት ሰርቨሩ የሚከተሉትን ማሟላቱን ያረጋግጡ፦

• ስርዓተ-ክወና፦ Ubuntu 22.04 LTS፣ Debian 12፣ ወይም AlmaLinux 9።
• Docker Engine፦ ስሪት 24.0+ የተጫነ እና የሚሰራ።
• Docker Compose፦ ስሪት v2.20+ (docker compose version)።
• ሃርድዌር፦ ቢያንስ 4 vCPUs፣ 16 GB RAM እና 50 GB ነጻ SSD ቦታ።
• ፋየርዎል፦ ወደቦች 80 (HTTP) እና 443 (HTTPS) ክፍት መሆናቸውን ያረጋግጡ።

2. የአካባቢ ተለዋዋጮችን (Environment) ማዋቀር

የኮድ ማከማቻውን ያውርዱ እና የቅንብር ፋይሉን ያዘጋጁ፦

git clone https://github.com/your-org/YeneSchool-School-Management-System.git
cd YeneSchool-School-Management-System

# የቅንብር ፋይሉን ይቅዱ
cp .env.example .env

በ.env ፋይል ውስጥ ትክክለኛ ሚስጥራዊ ቁልፎችን ያስገቡ፦

• ጠንካራ የዳታቤዝ የይለፍ ቃል
• የJWT እና የRefresh ቶከን ሚስጥራዊ ቁልፎች
• የRedis እና የAI ኤፒአይ ቁልፎች

3. ስርዓቱን ማስጀመር

ሁሉንም አገልግሎቶች በአንድ ላይ ይገንቡ እና ያስጀምሩ፦

docker compose up -d --build

የአገልግሎቶቹን ሁኔታ ያረጋግጡ፦

docker compose ps

4. የዳታቤዝ መዋቅር ማመንጨት (Prisma Migrations)

ዳታቤዙ በተሳካ ሁኔታ ሲጀምር የPrisma ፍልሰቶችን ያስፈጽሙ፦

# የዳታቤዝ ፍልሰት ማከናወን
docker compose exec backend npx prisma migrate deploy

# (አስፈላጊ ከሆነ) የመጀመሪያ መረጃዎችን እና ሱፐር አድሚንን መዝሩ
docker compose exec backend npx prisma db seed