የዴቭ አካባቢን በማሄድ ላይ¶

ለ Climweb አስተዋፅዖ ማድረግ ከፈለጉ በአከባቢዎ ኮምፒውተር ላይ ያለውን የእድገት አካባቢ ማዋቀር ያስፈልግዎታል። ይህን ለማድረግ በጣም ጥሩው መንገድ በ Docker compose በኩል መተግበሪያውን በትንሹ ጣጣ መጀመር ይችላሉ።

Note

ለምርት ማሰማራት፣ እባክዎን https://github.com/wmo-raf/climweb-docker ይጎብኙ።

ማከማቻውን መዝጋት¶

የመጀመሪያው እርምጃ የClimweb ማከማቻውን ከ GitHub መዝጋት ነው። በተርሚናልዎ ውስጥ የሚከተለውን ትዕዛዝ በማሄድ ይህንን ማድረግ ይችላሉ-

$ git clone https://github.com/wmo-raf/climweb.git
$ cd climweb

የ`.env` ፋይል ይፍጠሩ¶

በመቀጠል ለልማት አካባቢ አስፈላጊውን ውቅር የያዘ የአካባቢ ፋይል መፍጠር ያስፈልግዎታል. በማጠራቀሚያው ውስጥ የቀረበውን የናሙና ዲቪ አካባቢ ፋይል በመቅዳት ይህንን ማድረግ ይችላሉ፡-

$ cp .env.dev.sample .env

የ.env ፋይልን በሚፈለገው ውቅር ያዘምኑ። ያሉትን የአካባቢ ተለዋዋጮች እና መግለጫዎቻቸውን ለማጣቀሻ የአካባቢ ተለዋዋጮች ክፍልን ይመልከቱ።

ፈጣን ጅምር¶

Git እና Docker Compose የሚያውቁት ከሆነ የClimweb's dev አካባቢን በአገር ውስጥ ለማስጀመር እነዚህን ትዕዛዞች ያሂዱ፣ ካልሆነ እባክዎን ከታች ካለው የመጫኛ መስፈርቶች ክፍል ይጀምሩ።

$ git clone https://github.com/wmo-raf/climweb.git

# Our supplied ./dev.sh script wraps Docker Compose setting the correct env vars for

# you to get hot code reloading working well.

$ ./dev.sh

# Run ./dev.sh help for further details.

$ ./dev.sh help

የመጫኛ መስፈርቶች¶

አስቀድመህ በኮምፒውተርህ ላይ ዶከር እና ዶከር አዘጋጅን ካልጫንክ በhttps://docs.docker.com/desktop እና https://docs.docker.com/compose/install ላይ ያሉትን መመሪያዎች በመከተል ማድረግ ትችላለህ።

Note

ክሊምዌብን ለመገንባት Docker ስሪት 19.03 ዝቅተኛው የሚያስፈልገው ነው። ነገር ግን የቅርብ ጊዜውን የዶከር ስሪት እንዲጭኑ በጥብቅ ይመከራል። እባኮትን docker -vን በማሄድ ዶከርዎ የተዘመነ መሆኑን ያረጋግጡ።

እንዲሁም በhttps://www.linode.com/docs/development/version-control/how-to-install-git-on-linux-mac-and-windows ላይ በመከተል ሊያደርጉት የሚችሉት git መጫን ያስፈልግዎታል።

ሁሉንም አስፈላጊ ሶፍትዌሮች ከጫኑ በኋላ የሚከተሉትን ትዕዛዞች በተርሚናልዎ ውስጥ ማስኬድ አለብዎት።

$ docker -v
Docker version 28.1.1, build 4eba377
$ docker compose version
Docker Compose version v2.35.1-desktop.1
$ git --version
git version 2.37.1

ሁሉም ትዕዛዞች በምሳሌው ላይ እንደተገለጸው ተመሳሳይ ነገር ከመለሱ፣ ለመቀጠል ዝግጁ ነዎት!

የልማት አካባቢን መጀመር¶

በመጀመሪያ, ማከማቻውን መዝጋት ያስፈልግዎታል. ዋናውን ቅርንጫፍ ለመዝጋት የሚከተሉትን ትዕዛዞችን ያከናውኑ። ስለ git clone የማያውቁት ከሆነ፣ ይህ የClimweb ኮድ ቅጂ ወደ ኮምፒውተርዎ ያወርዳል።

$ git clone https://github.com/wmo-raf/climweb.git
Cloning into 'climweb'...
...
$ cd climweb

አሁን የኛን ሪፖ ቅጂ አግኝተናል እና ማውጫዎችን ወደ አዲስ የተፈጠረ ክሊምዌብ ቀይረናል፣ እቃዎቹን ማምጣት እንችላለን።

የቀረበውን dev.sh ስክሪፕት ለመጠቀም ካልፈለጉ፣ የእድገት አካባቢውን ለመጀመር የሚከተለውን ትዕዛዝ ማሄድ ይችላሉ።

$ docker compose -f docker-compose.yml -f docker-compose.dev.yml up

Note

የdocker-compose.dev.yml ፋይል ነባሪውን docker-compose.yml ፋይል ከግንባታ ልዩ ቅንጅቶች ጋር ለመሻር ጥቅም ላይ እንደሚውል ልብ ይበሉ።

የድር መተግበሪያን መድረስ¶

ኮንቴይነሮቹ አንዴ ከሰሩ እና ሲሰሩ የClimweb መተግበሪያን በድር አሳሽዎ ውስጥ በhttp://localhost:8000 ማግኘት ይችላሉ። አስፈላጊ ከሆነ የCLIMWEB_DEV_PORT ተለዋዋጭን በማሻሻል ወደቡ በ.env ፋይል ውስጥ ሊቀየር ይችላል።

ሱፐር ተጠቃሚ መፍጠር¶

ለ Climweb መተግበሪያ ሱፐር ተጠቃሚ ለመፍጠር፣ የሚከተለውን ትዕዛዝ በተለየ ተርሚናል መስኮት ማሄድ ይችላሉ።

$ docker compose -f docker-compose.yml -f docker-compose.dev.yml exec climweb climweb createsuperuser

መያዣው እንዲሠራ ያድርጉት¶

በማደግ ላይ እያሉ መያዣዎቹ መሮጥ አለባቸው። እንዲሁም የፋይል ለውጦችን ይቆጣጠራሉ እና በራስ-ሰር ያዘምኑ፣ ስለዚህ እንደገና ስለ መጫን መጨነቅ አያስፈልገዎትም። በኮዱ ላይ የሚደረግ ማንኛውም ለውጥ ዳግም መጫንን ያስነሳል እና ለውጦቹን ወዲያውኑ ማየት ይችላሉ።

የዴቭ አካባቢን በማሄድ ላይ¶

ማከማቻውን መዝጋት¶

የ.env ፋይል ይፍጠሩ¶

ፈጣን ጅምር¶

የመጫኛ መስፈርቶች¶

የልማት አካባቢን መጀመር¶

የድር መተግበሪያን መድረስ¶

ሱፐር ተጠቃሚ መፍጠር¶

መያዣው እንዲሠራ ያድርጉት¶

የ`.env` ፋይል ይፍጠሩ¶