Introduzzjoni tal-Wiki

Settijiet ta 'dejta

Funzjonalitajiet u struttura tal-għodda ġenerali

Moduli ta 'kalkolu (CM)

Kif tapplika l-kaxxa tal-għodda Hotmaps

Għall-Iżviluppaturi

Hotmaps Logo

Werrej

Introduzzjoni

Din il-paġna fiha l-informazzjoni kollha meħtieġa għall-iżviluppaturi biex jikkontribwixxu għall-Pjattaforma Hotmaps jew biex jifhmu kif qed taħdem.

To Top

Integrazzjoni tas-sett tad-dejta

L-integrazzjoni ta 'settijiet ta' dejta pubbliċi ġodda hija ttrattata kif ġej:

  1. settijiet ta 'dejta għandhom jiġu mbuttati għal repożitorju ta' git ( Żid is-settijiet ta 'dejta tiegħek fuq GitLab )
  2. kull lejl skript jintegra s-settijiet tad-dejta ġodda / aġġornati mal-pjattaforma DEV
  3. jekk kollox ħadem tajjeb, is-sett tad-dejta issa huwa disponibbli fuq il-pjattaforma DEV u l-iżviluppaturi jistgħu jintegrawh fil-kodiċi tagħhom
  4. Ladarba l-kodifikazzjoni tintemm il-karatteristiċi l-ġodda huma miżjuda mal-pjattaforma tal-produzzjoni permezz ta 'ħarġa ġdida

Integrazzjoni tad-dejta

Jekk sett ta 'dejta jonqos waqt l-integrazzjoni, tinħoloq kwistjoni fuq Taiga (pjattaforma ta' ġestjoni tal-proġett). Il-kwistjoni turi l-iżball imqajjem u l-iżviluppatur għandu jirranġaha u jimbotta x-xogħol tiegħu għal Git sabiex l-iskript ikun jista 'jipprova jintegrah mill-ġdid filgħaxija ta' wara.

Il-kodiċi tas-sors tal-iskript tal-integrazzjoni huwa disponibbli fuq din il-link: Integrazzjoni tad-dejta

To Top

Żid is-settijiet tad-dejta tiegħek fuq GitLab

Biex iżżid settijiet ta 'dejta fuq il-lista ta' settijiet ta 'dejta pubbliċi, għandhom jiġu mbuttati lejn repożitorju ġdid ta' Git fuq GitLab. Hawn hi l-Organizzazzjoni GitLab fejn għandhom jiġu mbuttati s-settijiet tad- dejta : Settijiet tad-dejta fuq il-GitLab .

Darba kuljum ir-repożitorji jiġu kkontrollati għal impenji ġodda u integrati jekk iva. Il-proċess ta 'integrazzjoni jivverifika jekk id-dejta tikkonformax mal-ispeċifikazzjoni jew le.

Hawn hi l-ispeċifikazzjoni: Hotmaps_Data-upload-on-Gitlab_2017-12-04_V4.pdf

To Top

Lista tar-repożitorji ewlenin

Il-kodiċi tal-applikazzjoni jinsab fuq GitHub taħt l- organizzazzjoni Hotmaps . Din l-organizzazzjoni għandha diversi repożitorji

  • Hotmaps-toolbox-client fih il-frontend tal-applikazzjoni tagħna. Huwa proġett Angulari (JavaScript)
  • Hotmaps-toolbox-service fih l-API għall-applikazzjoni tagħna. Huwa bbażat fuq Flask (Python)
  • bażi-kalkolu-modulu huwa l-mudell bażiku li tista 'tuża biex toħloq il-moduli tal-kalkolu tiegħek stess għal Hotmaps
  • lista ta 'moduli ta' kalkoli

To Top

Kif tikkontribwixxi kodiċi

Jekk trid iżżid xi kodiċi mal-Hotmaps għandek żewġ possibbiltajiet: jekk trid taġġorna l-interface jew il-backend direttament, trid timmodifika l-klijent jew ir-repożitorju tas-servizz tal-kaxxa tal-għodda. Jekk trid iżżid il-modulu tal-kalkolu tiegħek stess, tista 'toħloq ir-repożitorju tiegħek billi ssegwi r-readme tar-repożitorju base_calculation_module

Jekk trid twettaq xi xogħol fuq ir-repożitorju Git, jekk jogħġbok ma taħdimx direttament mal-fergħa ewlenija. Oħloq fergħa ġdida mill-fergħa ta 'żvilupp, għamel ix-xogħol tiegħek fuq din il-fergħa u meta l-karatteristika tiegħek tiġi ttestjata, tista' tgħaqqad ix-xogħol tiegħek mal-fergħa ta 'żvilupp kif muri fil-graff li ġej.

Git_workflow

Sabiex timbotta xi ħaġa lejn xi repożitorju tal-Hotmaps trid tkun membru tat-tim tal-Hotmaps, jekk m'intix xorta tista 'twettaq furketta tal-għodda tagħna biex tiżviluppa l-għodda tiegħek stess.

Tista 'ssib aktar informazzjoni dwar kif taħdem f'dawn id-dokumenti:

To Top

Deskrizzjoni tal-infrastruttura tal-IT

ReverseProxy_architecture_latest

Is-servizzi u l-komponenti kollha jintużaw permezz tal-kontenitur Docker tagħhom stess. Dawn il-kontenituri kollha huma ddefiniti f'fajl wieħed ta 'kompożizzjoni ta' docker. L-immaġni ta 'hawn fuq tirrappreżenta l-arkitettura tal-IT tal-Hotmaps

Xi organizzazzjonijiet imsieħba llimitaw il-komunikazzjoni għall-port 80 biss. Biex jiġu evitati l-problemi kkawżati minn din il-limitazzjoni, sar il-ħolqien ta 'prokura inversa. Dan ir-reverse proxy joffri punt ta 'dħul wieħed u mbagħad iqassam it-talba mibgħuta mill-klijent lis-servizz ikkonċernat. Ir-reverse proxy huwa magħmul minn tliet komponenti:

  1. Reverse proxy server: iservi bħala punt ta 'dħul uniku u jqassam talbiet lis-servizzi t-tajba.
  2. Proxy-gen: huwa servizz li awtomatikament jimmappja s-servizzi kollha fir-reverse proxy. Għalhekk, mhux meħtieġ li żżid manwalment servizz ġdid mal-konfigurazzjoni tal-prokura
  3. let-kriptaġġ: huwa servizz li jippermetti l-użu tal-protokoll SSL. Huwa meħtieġ sabiex jiġi attivat il-protokoll https. Iċ-ċertifikati SSL huma ffirmati b'indirizz elettroniku kkonfigurat f'dan is-servizz.

Jeżistu tliet netwerks:

  • hotmaps_nginx jippermetti lir-reverse proxy jikkomunika mal-API, il-frontend u l-GeoServer. Tippermetti prinċipalment li tqassam talba lis-servizz korrett fost it-tlieta.
  • hotmaps_backend jippermetti l-komunikazzjoni bejn il-komponenti kollha tal-backend: API, frontend, GeoServer u d-database PostgreSQL.
  • hotmaps_cm-net jippermetti l-komunikazzjoni bejn kull modulu ta 'kalkolu u l-API.

Kull modulu ta 'kalkolu għandu l-kontenitur Docker tiegħu stess.

To Top

Mexxi ma 'Docker

Hotmaps tuża s-softwer Docker u l - għodda Docker-Compose biex timmaniġġja l-kontenituri. Fajl docker-compose.yml fih il-konfigurazzjoni sħiħa tal-arkitettura Docker (konfigurazzjoni ta ’kontejners, netwerks, links, ...). Dan jippermetti li l-kontenituri jitħaddmu b'kmand wieħed sempliċi:

 docker-compose up

Hemm aktar dwar docker-compose fuq il-websajt ta ’Docker: Compose reference-line line u Compose file reference .

Hemm kontenitur wieħed biss li jitmexxa separatament minn oħrajn: hija d-database minħabba li teħtieġ tibqa 'l-ħin kollu. Huwa għalhekk li mhuwiex fil-fajl tal-konfigurazzjoni tad-docker-compose.

To Top

Infrastruttura tas-server

Infrastruttura

Għalissa, is-server huwa ospitat fil-HES-SO fl-Iżvizzera. Hemm 2 magni disponibbli: waħda għall-iżvilupp (żvilupp u ttestjar) u waħda għall-produzzjoni (il-kaxxa tal-għodda attwali, disponibbli fuq www.hotmaps.eu ).

Iż-żewġ magni għandhom l-istess speċifikazzjoni:

  • CPU: Intel Xeon E5-2680 v4 (8) @ 2.4GHz)
  • RAM: 16GB
  • HDD: 500GB
  • OS: Ubutnu 16.04 LTS

Prestazzjoni

Ħafna drabi nagħmlu testijiet tal-prestazzjoni fuq is-server tal-iżvilupp sabiex niggarantixxu ċertu ammont ta 'utenti fl-istess ħin.

Bħala eżempju, hawn taħt jinsabu r-riżultati tal-ewwel beta release kontra testijiet futuri ta 'release. Ir-rilaxx il-ġdid jinkludi xi titjib fil-prestazzjoni.

Dan l-eżempju juri t-testijiet tal-prestazzjoni ta 'utenti konkorrenti li jużaw l-istess funzjoni: "kurva tat-tul għall-għażla tal-ettaru". Il-linja grassa turi l-limitu fejn is-server jibda jqajjem żbalji. L-għażla tal-ettari hija eżempju tajjeb għax turi l-mistoqsijiet li jeħtieġu l-aktar riżorsi.

Ħruġ Beta ta 'Marzu 2019

| Numru ta 'utenti simulati | Ħin medju | Medjan | Ħin massimu | Ħin minimu | Perċentwal ta 'żbalji | --------------------- | ------------ | ------ | -------- | -------- | -------------------- | | 1 | 1042 | 1042 | 1042 | 1042 | 0 | | 20 | 3608 | 3858 | 4475 | 2156 | 0 | | 50 | 7337 | 7595 | 11791 | 1568 | 0 | | 100 | 13897 | 13644 | 24492 | 1875 | 0 | | 200 | 27135 | 26380 | 51967 | 3045 | 0 | | 300 | 41237 | 43083 | 73245 | 3223 | 10.67 |

Rilaxx finali (Awwissu 2020)

| Numru ta 'utenti simulati | Ħin medju | Medjan | Ħin massimu | Ħin minimu | Perċentwal ta 'żbalji | --------------------- | ------------ | ------ | -------- | -------- | -------------------- | | 1 | 1025 | 970 | 1151 | 956 | 0 | | 20 | 1671 | 1732 | 2085 | 1113 | 0 | | 50 | 3527 | 3622 | 5593 | 982 | 0 | | 100 | 6648 | 6764 | 11854 | 1118 | 0 | | 200 | 12904 | 12801 | 24163 | 1192 | 0 | | 300 | 19521 | 19382 | 38116 | 1060 | 0 |

To Top

AQRA.ME

Aqra.ME

To Top

Kif jiġu definiti l-indikaturi

Definizzjoni tal-Indikatur

To Top

Kif tikkwota

Daniel Hunacek, Lucien Zuber, Matthieu Dayer, fil-Hotmaps Wiki, Sezzjoni tal-Iżviluppaturi (Settembru 2020)

To Top

Awturi u reviżuri

Din il-paġna ġiet miktuba minn Daniel Hunacek, Lucien Zuber, u Matthieu Dayer ( HES-SO ).

☑ Din il-paġna ġiet riveduta minn Mostafa Fallahnejad ( EEG - TU Wien ).

To Top

Liċenzja

Copyright © 2016-2020: Daniel Hunacek, Lucien Zuber, u Matthieu Dayer

Liċenzja Internazzjonali Creative Commons Attribution 4.0

Dan ix-xogħol huwa liċenzjat taħt Liċenzja Internazzjonali Creative Commons CC BY 4.0.

Identifikatur tal-Liċenzja SPDX: CC-BY-4.0

Test tal-Liċenzja: https://spdx.org/licenses/CC-BY-4.0.html

To Top

Rikonoxximent

Nixtiequ nwasslu l-apprezzament profond tagħna għall- Proġett Hotmaps ta ' Orizzont 2020 (Grant Agreement number 723677), li pprovda l-finanzjament biex titwettaq l-investigazzjoni preżenti

To Top

This page was automatically translated. View in another language:

English (original) Bulgarian* Czech* Danish* German* Greek* Spanish* Estonian* Finnish* French* Irish* Croatian* Hungarian* Italian* Lithuanian* Latvian* Dutch* Polish* Portuguese (Portugal, Brazil)* Romanian* Slovak* Slovenian* Swedish*

* machine translated