====== 10. Azure cloud ======

===== Cíle cvičení =====




<note tip>Zaregistrujte se do služby Microsoft Azure na adrese https://azure.microsoft.com/cs-cz/. Při registraci použijte mail ve formátu ''login@cvut.cz''.</note>

===== Propojení s Azure IoT Hub =====

==== Vytvoření instance IoT Hub ====

  * V sekci **Azure services** vyberte IoT Hub a klikněte na tlačítko "Create IoT hub"
  * Basics:
    * Subscribtion: Azure pro studenty
    * Resource group: vytvořte novou skupinu a vhodně ji pojmenujte
    * IoT Hub name: vhodně pojmenujte (třeba nsi-[login], kde [login] je vaše přihlašovací ČVUT jméno)
    * Region: West Europe
  * Networking: vše default
  * Management: 
    * Pricing and scale tier: F1: free tier
  *Review + Create

==== Vytvoření nového zařízení ====

  * Klikněte na **IoT Devices** a poté na **New** (ikona ''+'')
  * Vyplňte pole **Device ID**, ostatní pole nechte, jak jsou a klikněte na **Save**
  * Když je zařízení vytvořeno, v sekci **Primary Connection String** jsou informace potřebné k připojení

==== Připojení simulovaného zařízení ====

  * Nainstalujte si Pyhon modul ''azure-iot-device''
  * Z gitlabu předmětu si stáhněte [[https://gitlab.fel.cvut.cz/viteks/nsi-codes/-/blob/main/tut-10-azure/iot-hub-client.py|kód]].
  * Skript pusťte tak, že parametrem příkazové řádky je textový řetězec z **Primary Connection String**
  * Ověřte, že zařízení posílá data do Azure cloudu


===== Vytvoření Azure Blob Storage =====

  * Ve vyhledávacím okně zadejte **Storage Account**
  * Vytvořte nový účet, zvolte již vytvořenou **Resource Group** a **Replication** zvolte **LRS**

==== Vytvoření kontejneru ====

  * V sekci **Containers** vytvořte nový kontejner
  * Kontejner pojmenujte třeba **sensordata** a nastavte úroveň přístupu

===== Směrování zpráv z IoT Hub =====

==== Vytvoření koncového bodu ====

  * Jděte do modulu **IoT Hub**
  * Vyberte **Message Routing** -> **Custom Endpoint** -> **Add** a vyberte **Storage**
  * Pojmenujte koncový bod **storage** 
  * Zvolte **Encoding** JSON
  * Klikněte na **Pick containter** a vyberte kontejner vytvořený v minulém kroku
  * Klikněte na **Create**

==== Směrování zpráv ====

  * Na záložce **Routes** klikněte na **Add**
  * Vyberte vhodný název propojení a vyberte kliknutím na **Add endpoint** koncový bod vytvořený minulém bodu

==== Vizualizace zpráv ====

  * Připravte nové směrování do vestavěného koncového bodu **events**
  * Do vyhledávacího okna zadejte **Time Series Insights environments**
  * Kliknutím na **Create** otevřete nový dialog
  * Zvolte **Subscription** a **Resource Group** stejné jako v předchozích bodech
  * Vyberte vhodný název **Environment name**
  * V sekci **Property name** vložte **temperature** a **heart_rate**
  * Vytvořte nový **Storage account** a zbytek možností nechte, jak je
  * Přesuňte se na záložku **Next: Event Source**
  * V **Create and event Source?** nechte **Yes**
  * Nechte **Source Type** nastaven na **IoT Hub**
  * Pojmenujte např. jako **iot-hub**
  * Zvolte **Subscription** a vyberte váš **IoT Hub**
  * Nastavte **IoT Hub access policy name** na **iothubowner**
  * V **IoT Hub consumer group** vytvořte novou položku a pojmenujte ji
  * Nechte ostatní možnosti tak, jak jsou
  * Klikněte na **Create**