diff --git a/README.md b/README.md index c93fd0bfbdc4d3408688f944d544454a06d336bc..5a19921112a5441d06891543d12cc2a37e8a8f40 100644 --- a/README.md +++ b/README.md @@ -3,6 +3,8 @@ https://gitlab.presov.sk/ria/int/prirucky/tvorba-suborov-readme/-/blob/main/READ Viac informáciĂ: https://gitlab.presov.sk/ria/int/prirucky/tvorba-suborov-readme --> +<!-- DátovĂ˝ sklad mesta Prešov, MQTT protokol, dátovĂ˝ sklad, MQTT broker mesta Prešov --> + # InformaÄŤnĂ˝ balĂk pre prácu s MQTT brokerom DátovĂ©ho skladu mesta Prešov Rozvojová implementaÄŤná agentĂşra mesta Prešov, n. o. (v skratke RIA, n. o.) @@ -33,20 +35,34 @@ Dokumentácia je urÄŤená pre vĂ˝vojárov, architektov, produktovĂ˝ch manažéro [Protokol MQTT](https://en.wikipedia.org/wiki/MQTT) prináša dodávateÄľom hardvĂ©ru a softvĂ©rovĂ˝ch sluĹľieb mnoho prĂleĹľitostĂ a vĂ˝hod. Tento **otvorenĂ˝** ÄľahkĂ˝ _publish-subscribe_ protokol je uĹľ viac ako 25 rokov základom spoÄľahlivej vĂ˝meny dát v rĂ´znych odvetviach, od kritickĂ˝ch priemyselnĂ˝ch aplikáciĂ aĹľ po hobby projekty. Na trhu ho nájdete v mnoĹľstve hardvĂ©rovĂ˝ch a softvĂ©rovĂ˝ch produktov. -Jeho vĂ˝znam podÄŤiarkuje aj medzinárodná štandardizácia v podobe normy [ISO/IEC 20922:2016](https://www.iso.org/standard/69466.html). Je podporovaná mnoĹľstvom overenĂ˝ch implementáciĂ s otvorenĂ˝m zdrojovĂ˝m kĂłdom pre všetky beĹľnĂ© platformy. - Mesto Prešov si uvedomuje vĂ˝hody protokolu MQTT. Preto ho zvolilo ako kľúčovĂ˝ integraÄŤnĂ˝ protokol pre svoj dátovĂ˝ sklad. ## SĂş vaše produkty pripravenĂ© na protokol MQTT? -Ak chcete integrovaĹĄ vaše riešenia s našĂm dátovĂ˝m skladom, je potrebnĂ©, aby podporovali komunikáciu prostrednĂctvom MQTT. +Pri diskusiách o moĹľnostiach spolupráce s mestom Prešov sa nevyhnutne stretávame s dvoma kľúčovĂ˝mi tĂ©mami: DátovĂ˝ sklad mesta Prešov a jeho integraÄŤnĂ˝ protokol MQTT. + +DátovĂ˝ sklad mesta Prešov je centrálna platforma na zber, spracovanie a integráciu dát z rĂ´znych mestskĂ˝ch informaÄŤnĂ˝ch systĂ©mov a infraštruktĂşrnych prvkov. Ăšlohou dátovĂ©ho skladu je zabezpeÄŤiĹĄ jednotnĂş a spoÄľahlivĂş vĂ˝menu Ăşdajov medzi technolĂłgiami vyuĹľĂvanĂ˝mi mestom, jeho organizáciami a partnermi. + +DátovĂ˝ sklad mesta Prešov vyuĹľĂva MQTT ako svoj štandardnĂ˝ integraÄŤnĂ˝ protokol. UmoĹľĹuje flexibilnĂş integráciu s rĂ´znymi druhmi softvĂ©rovĂ˝ch a hardvĂ©rovĂ˝ch riešenĂ. + +VĂ˝znam protokolu MQTT podÄŤiarkuje jeho štandardizácia v podobe normy [ISO/IEC 20922:2016](https://www.iso.org/standard/69466.html). Tento medzinárodne uznávanĂ˝ štandard zabezpeÄŤuje spoÄľahlivĂş, škálovateÄľnĂş a otvorenĂş vĂ˝menu dát medzi rĂ´znymi systĂ©mami. Je podporovanĂ˝ mnoĹľstvom overenĂ˝ch implementáciĂ s otvorenĂ˝m zdrojovĂ˝m kĂłdom pre všetky beĹľnĂ© platformy. + +Aby sme zabezpeÄŤili bezproblĂ©movĂş spoluprácu a integráciu, kladieme našim partnerom dve základnĂ© otázky: + +1. SĂş vaše produkty pripravenĂ© na protokol MQTT? +2. Vie váš systĂ©m komunikovaĹĄ s MQTT brokerom mesta Prešov? + +Ak potrebujete viac informáciĂ o implementácii protokolu MQTT, pripravili sme **InformaÄŤnĂ˝ balĂk pre prácu s MQTT brokerom DátovĂ©ho skladu mesta Prešov**. BalĂk obsahuje všetky potrebnĂ© podklady, prĂklady a návody na zabezpeÄŤenie hladkej komunikácie vašich riešenĂ s mestskou infraštruktĂşrou. -## Vedia komunikovaĹĄ s MQTT brokerom mesta Prešov? +InformaÄŤnĂ˝ balĂk nájdete na tejto adrese: +https://gitlab.presov.sk/datovy-sklad/mqtt-dev -Preto sme pre vás pripravili tento **InformaÄŤnĂ˝ balĂk pre prácu s MQTT brokerom DátovĂ©ho skladu mesta Prešov**. Obsahuje všetky potrebnĂ© informácie a nástroje, ktorĂ© vám pomĂ´Ĺľu zabezpeÄŤiĹĄ hladkĂş komunikáciu vašich riešenĂ s našou mestskou infraštruktĂşrou. +Táto stránka poskytuje aktuálnu verziu dokumentácie, ktorĂş mĂ´Ĺľete priamo pouĹľiĹĄ pri prĂprave vašich riešenĂ pre mesto Prešov a jeho organizácie. ## Obsah informaÄŤnĂ©ho balĂka +BalĂk poskytuje všetky potrebnĂ© materiály na efektĂvne vyuĹľitie MQTT v rámci integrácie s mestom Prešov. Obsahuje nasledujĂşce zdroje: + - **Dokumentácia**: <!--Návody a p-->PrĂruÄŤky pre rĂ´zne cieÄľovĂ© skupiny. - **PrĂklady**: Ukážky komunikácie pomocou MQTT. - **KonfiguraÄŤnĂ© sĂşbory**: PrĂklady ACL pravidiel a konfiguraÄŤnĂ˝ch sĂşborov pre mestskĂ˝ broker. @@ -63,6 +79,10 @@ Preto sme pre vás pripravili tento **InformaÄŤnĂ˝ balĂk pre prácu s MQTT brok - **Pre produktovĂ˝ch manažérov**: PreÄŤĂtajte si [Ăšvod do MQTT](/dokumentacia/produktovi_manazeri/uvod_do_mqtt.md). - **Pre manažérov organizácii**: ZaÄŤnite na stránke [MQTT v riadenĂ organizáciĂ](/dokumentacia/produktovi_manazeri/mqtt_v_riadeni.md). +## ArchitektĂşra integrácie s mestskĂ˝m MQTT brokerom + +Pre efektĂvnu a spoÄľahlivĂş vĂ˝menu dát medzi systĂ©mami mesta Prešov je nutnĂ© dodrĹľiavaĹĄ osvedÄŤenĂş architektĂşru komunikácie cez MQTT broker. SchĂ©ma ilustruje tzv. centrickĂ˝ model tejto architektĂşry, kde všetky zariadenia a subsystĂ©my komunikujĂş vĂ˝hradne prostrednĂctvom MQTT brokeru. Tento prĂstup zabezpeÄŤuje jednotnosĹĄ, bezpeÄŤnosĹĄ a jednoduchĂş škálovateÄľnosĹĄ mestskĂ©ho ekosystĂ©mu. +  ## Ĺ tandardy a prĂruÄŤky @@ -79,26 +99,26 @@ https://gitlab.presov.sk/datovy-sklad/mqtt-dev/-/blob/main/standardy/standard-tv ## Potrebujete testovacĂ prĂstup k mestskĂ©mu MQTT brokeru? -Ak máte záujem o doÄŤasnĂ˝ testovacĂ prĂstup k mestskĂ©mu MQTT brokeru, poskytnite nám technickĂ© informácie o vašom projekte, vrátane popisu dát a MQTT tĂ©m, ktorĂ© plánujete odoberaĹĄ a publikovaĹĄ. Podrobnosti o podmienkach a postupe zĂskania prĂstupu nájdete na stránke [podrobnosti o postupe udelenia testovacieho prĂstupu](konfiguracie/testovaci_pristup.md). +Ak potrebujete overiĹĄ kompatibilitu vášho riešenia s mestskĂ˝m MQTT brokerom, mĂ´Ĺľete poĹľiadaĹĄ o testovacĂ prĂstup. UmoĹľnĂ vám prakticky otestovaĹĄ komunikáciu a pripraviĹĄ vaše riešenie na bezproblĂ©movĂş integráciu. Poskytnite nám technickĂ© informácie o vašom projekte alebo systĂ©me, vrátane popisu dát a MQTT tĂ©m, ktorĂ© plánujete odoberaĹĄ a publikovaĹĄ. Podrobnosti o podmienkach a postupe zĂskania prĂstupu nájdete na stránke [podrobnosti o postupe udelenia testovacieho prĂstupu](konfiguracie/testovaci_pristup.md). -Pre viac informáciĂ o dátovom sklade mesta Prešov a jeho špecifikáciách navštĂvte [gitlab.presov.sk/datovy-sklad](https://gitlab.presov.sk/datovy-sklad). +## Dokumentácia dátovĂ©ho skladu mesta Prešov + +Ak potrebujete hlbšie porozumieĹĄ architektĂşre, technickĂ˝m špecifikáciám a moĹľnostiam integrácie s DátovĂ˝m skladom mesta Prešov, mĂ´Ĺľete vyuĹľiĹĄ jeho dokumentáciu. Poskytuje dĂ´leĹľitĂ© informácie o princĂpoch fungovania dátovĂ©ho skladu, jeho komponentoch a ÄŹalšĂch štandardoch pouĹľĂvanĂ˝ch pri vĂ˝mene a spracovanĂ dát. Pre viac informáciĂ o dátovom sklade mesta Prešov a jeho špecifikáciách navštĂvte [gitlab.presov.sk/datovy-sklad](https://gitlab.presov.sk/datovy-sklad).  ## Ako zaÄŤaĹĄ s integráciou? -### Integrácie +NasledujĂşca dokumentácia je vo vyvoji podÄľa aktuálnych potrieb a prebiehajĂşcich integraÄŤnĂ˝ch projektov. MĂ´Ĺľe vyĹľadovaĹĄ prihlásenie. -IntegraÄŤná dokumentácia pre rĂ´zne segmenty a kategĂłrie informaÄŤnĂ˝ch systĂ©mov mesta Prešov. Je urÄŤená predovšetkĂ˝m pre integrátorov a dodávateÄľov, aby zabezpeÄŤili, Ĺľe ich systĂ©my dokážu efektĂvne komunikovaĹĄ s dátovĂ˝m skladom a ÄŹalšĂmi komponentami informaÄŤnĂ˝ch systĂ©mov mesta. +### Integrácie -Dokumentácia obsahuje podrobnĂ© špecifikácie a pokyny, ktorĂ© podporujĂş interoperabilitu a zabezpeÄŤujĂş jednotnĂ˝ prĂstup k informaÄŤnej infraštruktĂşre mesta. +IntegraÄŤná dokumentácia pre rĂ´zne segmenty informaÄŤnĂ˝ch systĂ©mov mesta. Je urÄŤená pre integrátorov a dodávateÄľov, aby zabezpeÄŤili, Ĺľe ich systĂ©my dokážu efektĂvne komunikovaĹĄ s dátovĂ˝m skladom a ÄŹalšĂmi komponentami systĂ©mov mesta. Dokumentácia obsahuje špecifikácie a pokyny, ktorĂ© podporujĂş interoperabilitu a zabezpeÄŤujĂş jednotnĂ˝ prĂstup k informaÄŤnej infraštruktĂşre mesta: - https://gitlab.presov.sk/datovy-sklad/integracie ### InformaÄŤnĂ˝ balĂk pre nasadzovanie softvĂ©ru do dátovĂ©ho skladu mesta Prešov -Nástroje a osvedÄŤenĂ© postupy pre správu a nasadzovanie softvĂ©ru v rámci DátovĂ©ho skladu mesta Prešov. - -DetailnĂ© návody na inštaláciu a nasadzovanie softvĂ©rovĂ˝ch komponentov v rĂ´znych prostrediach, od lokálneho vĂ˝voja aĹľ po produkÄŤnĂ© nasadenie: +Nástroje a osvedÄŤenĂ© postupy pre správu a nasadzovanie softvĂ©ru v rámci DátovĂ©ho skladu mesta Prešov. DetailnĂ© návody na inštaláciu a nasadzovanie softvĂ©rovĂ˝ch komponentov v rĂ´znych prostrediach, od lokálneho vĂ˝voja aĹľ po produkÄŤnĂ© nasadenie: - https://gitlab.presov.sk/datovy-sklad/ops