Kuendesha mazingira ya dev

Ikiwa unataka kuchangia Climweb unahitaji kusanidi mazingira ya ukuzaji kwenye kompyuta yako ya karibu. Njia bora ya kufanya hivyo ni kupitia Docker kutunga ili uweze kuanza programu na kiasi kidogo cha shida.

Note

Kwa usambazaji wa uzalishaji, tafadhali tembelea https://github.com/wmo-raf/climweb-docker

Kufunga hazina

Hatua ya kwanza ni kuiga hazina ya Climweb kutoka GitHub. Unaweza kufanya hivyo kwa kuendesha amri ifuatayo kwenye terminal yako:

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

Unda faili ya .env

Ifuatayo, unahitaji kuunda faili ya mazingira ambayo ina usanidi muhimu kwa mazingira ya maendeleo. Unaweza kufanya hivyo kwa kunakili faili ya sampuli ya mazingira ya dev iliyotolewa kwenye hazina:

$ cp .env.dev.sample .env

Sasisha faili ya .env kwa usanidi unaohitajika. Tazama sehemu ya Vigezo vya Mazingira kwa marejeleo juu ya vigeu vya mazingira vinavyopatikana na maelezo yao.

Anza haraka

Ikiwa unaifahamu git na Docker Compose endesha amri hizi ili kuzindua mazingira ya usanifu ya Climweb ndani ya nchi, vinginevyo tafadhali anza kutoka sehemu ya Mahitaji ya Kusakinisha hapa chini.

$ 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

Mahitaji ya ufungaji

Ikiwa bado hujasakinisha docker na Docker Compose kwenye kompyuta yako unaweza kufanya hivyo kwa kufuata maagizo kwenye https://docs.docker.com/desktop na https://docs.docker.com/compose/install

Note

Toleo la Docker 19.03 ndio kiwango cha chini kinachohitajika kuunda Climweb. Inashauriwa sana hata hivyo kwamba usakinishe toleo la hivi karibuni la Docker linalopatikana. Tafadhali hakikisha kuwa docker yako imesasishwa kwa kuendesha docker -v.

Utahitaji pia git kusakinishwa ambayo unaweza kufanya kwa kufuata maagizo kwenye https://www.linode.com/docs/development/version-control/how-to-install-git-on-linux-mac-and-windows.-

Mara baada ya kumaliza kusakinisha programu zote zinazohitajika unapaswa kuwa na uwezo wa kuendesha amri zifuatazo katika terminal yako.

$ 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

Ikiwa amri zote zitarudisha kitu sawa kama ilivyoelezewa katika mfano, basi uko tayari kuendelea!

Kuanzisha mazingira ya maendeleo

Kwanza, unahitaji kuiga hazina. Tekeleza amri zifuatazo ili kuiga tawi kuu. Ikiwa haujui git clone, hii itapakua nakala ya nambari ya Climweb kwenye kompyuta yako.

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

Sasa kwa kuwa tunayo nakala yetu ya repo na tumebadilisha saraka hadi climweb mpya iliyoundwa, tunaweza kuleta vyombo.

Ikiwa hutaki kutumia hati ya dev.sh iliyotolewa, unaweza kutekeleza amri ifuatayo ili kuanza mazingira ya uendelezaji:

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

Note

Kumbuka kuwa faili ya docker-compose.dev.yml inatumika kubatilisha faili chaguo-msingi docker-compose.yml kwa mipangilio mahususi ya usanidi.

Kufikia programu ya wavuti

Mara tu vyombo vinapoanza kutumika, unaweza kufikia programu ya Climweb katika kivinjari chako cha wavuti katika http://localhost:8000. Lango linaweza kubadilishwa katika faili ya .env ikihitajika kwa kurekebisha kigezo cha CLIMWEB_DEV_PORT.

Kuunda mtumiaji mkuu

Ili kuunda mtumiaji mkuu kwa programu ya Climweb, unaweza kuendesha amri ifuatayo kwenye dirisha tofauti la terminal:

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

Weka chombo kukimbia

Vyombo vinahitaji kuendelea kukimbia wakati unatengeneza. Pia hufuatilia mabadiliko ya faili na kusasisha kiotomatiki, kwa hivyo huna haja ya kuwa na wasiwasi kuhusu kupakia upya. Mabadiliko yoyote kwenye msimbo yataanzisha upakiaji upya na unaweza kuona mabadiliko mara moja.