Kontinuální integrace a průběžné nasazování do zařízení Azure IoT Edge

Platí pro: IoT Edge 1.5 IoT Edge 1.4

Důležité

Podporované verze ioT Edge 1.5 LTS a IoT Edge 1.4 LTS. IoT Edge 1.4 LTS je konec životnosti 12. listopadu 2024. Pokud používáte starší verzi, podívejte se na článek Aktualizace IoT Edge.

DevOps můžete snadno přijmout s aplikacemi Azure IoT Edge pomocí integrovaných úloh Azure IoT Edge v Azure Pipelines. Tento článek ukazuje, jak pomocí Azure Pipelines vytvářet, testovat a nasazovat moduly Azure IoT Edge pomocí YAML. Případně můžete použít klasický editor.

V tomto článku se dozvíte, jak pomocí integrovaných úloh Azure IoT Edge pro Azure Pipelines vytvořit kanály sestavení a verze pro vaše řešení IoT Edge. Každá úloha Azure IoT Edge přidaná do vašeho kanálu implementuje jednu z následujících čtyř akcí:

Akce	Popis
Vytváření imagí modulů	Vezme kód řešení IoT Edge a sestaví image kontejneru.
Nabízení imagí modulů	Nasdílí image modulů do zadaného registru kontejneru.
Generování manifestu nasazení	Vezme deployment.template.json soubor a proměnné a pak vygeneruje konečný soubor manifestu nasazení IoT Edge.
Nasazení do zařízení IoT Edge	Vytvoří nasazení IoT Edge na jedno nebo více zařízení IoT Edge.

Pokud není uvedeno jinak, postupy v tomto článku nevybídají všechny funkce dostupné prostřednictvím parametrů úlohy. Další informace naleznete v následujících zdrojích:

• Verze úlohy
• Možnosti ovládacího prvku
• Proměnné prostředí
• Výstupní proměnné

Požadavky

• Úložiště Azure Repos. Pokud ho nemáte, můžete ve svém projektu vytvořit nové úložiště Git. Pro účely tohoto článku jsme vytvořili úložiště s názvem IoTEdgeRepo.

• Řešení IoT Edge se potvrdilo a odeslalo do úložiště. Pokud chcete vytvořit nové ukázkové řešení pro testování tohoto článku, postupujte podle kroků v části Vývoj modulů Azure IoT Edge pomocí editoru Visual Studio Code. V tomto článku jsme vytvořili řešení v našem úložišti s názvem IoTEdgeSolution, které obsahuje kód modulu s názvem filtermodule.

  V tomto článku potřebujete jenom složku řešení vytvořenou šablonami IoT Edge v editoru Visual Studio Code nebo Visual Studio. Před pokračováním nemusíte tento kód sestavovat, nasdílovat, nasazovat ani ladit. Tyto procesy nastavíte v Azure Pipelines.

  Zjistěte cestu k souboru deployment.template.json ve vašem řešení, který se používá v několika krocích. Pokud neznáte roli šablony nasazení, přečtěte si, jak nasazovat moduly a navazovat trasy.

  Tip

  Pokud vytváříte nové řešení, nejprve naklonujte úložiště místně. Když pak vytvoříte řešení, můžete ho vytvořit přímo ve složce úložiště. Nové soubory odtud můžete snadno potvrdit a odeslat.

• Registr kontejneru, kde můžete odesílat image modulů. Službu Azure Container Registry nebo registr třetí strany můžete použít.

• Aktivní centrum Azure IoT s alespoň dvěma zařízeními IoT Edge pro testování samostatných fází testovacího a produkčního nasazení. Podle článků rychlého startu můžete vytvořit zařízení IoT Edge v Linuxu nebo Windows.

Další informace o používání Azure Repos najdete v tématu Sdílení kódu se sadou Visual Studio a Azure Repos.

Vytvoření kanálu buildu pro kontinuální integraci

V této části vytvoříte nový kanál buildu. Kanál nakonfigurujete tak, aby se spouštěl automaticky, když se přihlásíte ke změnám ukázkového řešení IoT Edge a publikujete protokoly sestavení.

1. Přihlaste se k organizaci Azure DevOps (https://dev.azure.com/{your organization}) a otevřete projekt, který obsahuje vaše úložiště řešení IoT Edge.

   

2. V nabídce levého podokna v projektu vyberte Kanály. Vyberte Vytvořit kanál uprostřed stránky. Pokud už kanály buildu máte, vyberte v pravém horním rohu tlačítko Nový kanál .

   

3. Na stránce Kde je váš kód? vyberte Git YAMLAzure Repos . Pokud chcete k vytvoření kanálů buildu projektu použít klasický editor, prohlédněte si průvodce klasickým editorem.

4. Vyberte úložiště, pro které vytváříte kanál.

   

5. Na stránce Konfigurace kanálu vyberte Počáteční kanál. Pokud máte existující soubor YAML služby Azure Pipelines, který chcete použít k vytvoření tohoto kanálu, můžete vybrat existující soubor YAML služby Azure Pipelines a zadat větev a cestu v úložišti k souboru.

   

6. Na stránce Kontrola kanálu YAML můžete vybrat výchozí název azure-pipelines.yml a přejmenovat konfigurační soubor kanálu.

   Výběrem možnosti Zobrazit asistenta otevřete paletu Úkoly .

   

7. Pokud chcete přidat úkol, umístěte kurzor na konec YAML nebo na místo, kde chcete přidat pokyny pro úkol. Vyhledejte a vyberte Azure IoT Edge. Parametry úkolu vyplňte následujícím způsobem. Pak vyberte Přidat.

   Parametr	Popis
   Akce	Vyberte Sestavení imagí modulů.
   .template.json soubor	Zadejte cestu k souboru deployment.template.json v úložišti, které obsahuje vaše řešení IoT Edge.
   Výchozí platforma	Vyberte odpovídající operační systém pro moduly na základě cílového zařízení IoT Edge.

   Další informace o této úloze a jejích parametrech najdete v úloze Azure IoT Edge.

   

   Tip

   Po přidání každého úkolu editor automaticky zvýrazní přidané řádky. Pokud chcete zabránit náhodnému přepsání, zrušte výběr řádků a před přidáním dalších úkolů zadejte nový prostor pro další úkol.

8. Opakováním tohoto procesu přidejte tři další úlohy s následujícími parametry:

   • Úloha: Azure IoT Edge

     Parametr	Popis
     Akce	Vyberte obrázky modulu Push.
     Typ registru kontejneru	Použijte výchozí typ: Azure Container Registry.
     Předplatné Azure	Vyberte své předplatné.
     Azure Container Registry	Zvolte registr, který chcete pro kanál použít.
     .template.json soubor	Zadejte cestu k souboru deployment.template.json v úložišti, které obsahuje vaše řešení IoT Edge.
     Výchozí platforma	Vyberte odpovídající operační systém pro moduly na základě cílového zařízení IoT Edge.

     Další informace o této úloze a jejích parametrech najdete v úloze Azure IoT Edge.

   • Úkol: Kopírování souborů

     Parametr	Popis
     Zdrojová složka	Zdrojová složka, ze které se má kopírovat. Prázdný je kořen úložiště. Proměnné použijte, pokud soubory nejsou v úložišti. Příklad: $(agent.builddirectory).
     Obsah	Přidejte dva řádky: deployment.template.json a **/module.json.
     Cílová složka	Zadejte proměnnou $(Build.ArtifactStagingDirectory). Další informace o popisu najdete v tématu Sestavení proměnných .

     Další informace o této úloze a jejích parametrech naleznete v tématu Kopírování souborů úloha.

   • Úloha: Publikování artefaktů sestavení

     Parametr	Popis
     Cesta k publikování	Zadejte proměnnou $(Build.ArtifactStagingDirectory). Další informace o popisu najdete v tématu Sestavení proměnných .
     Název artefaktu	Zadejte výchozí název: drop
     Umístění publikování artefaktů	Použijte výchozí umístění: Azure Pipelines

     Další informace o této úloze a jejích parametrech najdete v tématu Publikování úlohy artefaktů sestavení.

9. V rozevíracím seznamu Uložit a spustit v pravém horním rohu vyberte Uložit a spustit.

10. Trigger pro kontinuální integraci je ve výchozím nastavení povolený pro váš kanál YAML. Pokud chcete tato nastavení upravit, vyberte kanál a v pravém horním rohu vyberte Upravit . Vyberte Další akce vedle tlačítka Spustit v pravém horním rohu a přejděte na Aktivační události. Průběžná integrace se pod názvem kanálu zobrazuje jako povolená. Pokud chcete zobrazit podrobnosti o triggeru, zaškrtněte políčko Přepsat trigger kontinuální integrace YAML odsud .

Pokračujte k další části a sestavte kanál verze.

Vytvoření kanálu verze pro průběžné nasazování

V této části vytvoříte kanál verze, který je nakonfigurovaný tak, aby se spouštěl automaticky, když kanál buildu zahodí artefakty, a zobrazí protokoly nasazení v Azure Pipelines.

Vytvořte nový kanál a přidejte novou fázi:

1. Na kartě Vydané verze v části Kanály zvolte + Nový kanál. Pokud už kanály verze máte, zvolte tlačítko + Nový a vyberte + Nový kanál verze.

   

2. Po zobrazení výzvy k výběru šablony zvolte, že chcete začít s prázdnou úlohou.

   

3. Váš nový kanál verze inicializuje jednu fázi s názvem Fáze 1. Přejmenujte fázi 1 na vývoj a zacházejte s ním jako s kanálem průběžného nasazování pro vaše vývojové prostředí. Kanály průběžného nasazování mají obvykle několik fází, včetně vývoje, přípravy a testování. Můžete použít různé názvy a vytvořit více na základě vašeho postupu DevOps. Po přejmenování okna podrobností fáze zavřete.

   Kanál verze můžete také přejmenovat výběrem textu "Nový kanál verze" v horní části.

4. Propojte verzi s artefakty sestavení, které jsou publikovány kanálem buildu. Vyberte Přidat v oblasti artefaktů.

   

5. Na stránce Přidat artefakt vyberte Vytvořit jako typ Zdroj. Zvolte projekt a kanál buildu, který jste vytvořili. Pokud chcete, můžete změnit alias zdroje na něco popisnějšího. Pak vyberte Přidat.

   

6. Otevřete triggery artefaktů a výběrem přepínače povolte trigger průběžného nasazování. Teď se vytvoří nová verze pokaždé, když bude k dispozici nový build.

   

7. Fáze vývoje je předem nakonfigurovaná s jednou úlohou a nulovými úkoly. V nabídce kanálu vyberte Úkoly a pak zvolte fázi vývoje . Vyberte úlohu agenta a změňte její zobrazovaný název na kontrolu kvality. Můžete nakonfigurovat podrobnosti o úloze agenta, ale úloha nasazení je nerozlišující platformu, takže můžete použít jakoukoli specifikaci agenta ve zvoleném fondu agentů.

   

8. V úloze pro kontrolu kvality vyberte znaménko plus (+) a přidejte dva úkoly. Vyhledejte a přidejte Azure IoT Edge dvakrát.

9. Vyberte první úlohu Azure IoT Edge a nakonfigurujte ji s následujícími hodnotami:

   Parametr	Popis
   Zobrazovaný název	Zobrazovaný název se automaticky aktualizuje při změně pole akce.
   Akce	Vyberte možnost Generate deployment manifest.
   .template.json soubor	Zadejte cestu: $(System.DefaultWorkingDirectory)/Drop/drop/deployment.template.json. Cesta se publikuje z kanálu buildu.
   Výchozí platforma	Vyberte odpovídající operační systém pro moduly na základě cílového zařízení IoT Edge.
   Výstupní cesta	Vložte cestu $(System.DefaultWorkingDirectory)/Drop/drop/configs/deployment.json. Tato cesta je posledním souborem manifestu nasazení IoT Edge.

   Tyto konfigurace pomáhají nahradit adresy URL obrázků modulu v deployment.template.json souboru. Manifest pro generování nasazení také pomáhá nahradit proměnné přesnou hodnotou, kterou jste definovali v deployment.template.json souboru. V nástroji Visual Studio/Visual Studio Code zadáváte skutečnou .env hodnotu v souboru. V Azure Pipelines nastavíte hodnotu na kartě Proměnné kanálu verze. Přejděte na kartu Proměnné a nakonfigurujte název a hodnotu následujícím způsobem:

   • ACR_ADDRESS: Hodnota přihlašovacího serveru služby Azure Container Registry. Přihlašovací server můžete načíst ze stránky Přehled registru kontejneru na webu Azure Portal.
   • ACR_PASSWORD: Vaše heslo služby Azure Container Registry.
   • ACR_USER: Vaše uživatelské jméno služby Azure Container Registry

   Pokud máte v projektu jiné proměnné, můžete zadat název a hodnotu na této kartě. Manifest pro generování nasazení dokáže rozpoznat pouze proměnné, které jsou v ${VARIABLE} příchuti. Ujistěte se, že ve svých *.template.json souborech používáte tuto příchuť.

   "registryCredentials": {
     "<ACR name>": { // Your Azure Container Registry **Registry name** value
       "username": "${ACR_USER}",
       "password": "${ACR_PASSWORD}",
       "address": "${ACR_ADDRESS}"
     }
   }
   

   

10. Vyberte druhou úlohu Azure IoT Edge a nakonfigurujte ji s následujícími hodnotami:

    Parametr	Popis
    Zobrazovaný název	Zobrazovaný název se automaticky aktualizuje při změně pole akce.
    Akce	Vyberte možnost Deploy to IoT Edge devices.
    Soubor nasazení	Vložte cestu $(System.DefaultWorkingDirectory)/Drop/drop/configs/deployment.json. Tato cesta je soubor manifestu nasazení IoT Edge.
    Předplatné Azure	Vyberte předplatné, které obsahuje ioT Hub.
    Název centra IoT Hub	Vyberte centrum IoT.
    Volba jednoho nebo více zařízení	Zvolte, jestli chcete, aby se kanál verze nasadil do jednoho nebo několika zařízení. Pokud nasadíte na jedno zařízení, zadejte ID zařízení IoT Edge. Pokud nasazujete na více zařízení, zadejte cílovou podmínku zařízení. Cílová podmínka je filtr, který odpovídá sadě zařízení IoT Edge ve službě IoT Hub. Pokud chcete jako podmínku použít značky zařízení, musíte aktualizovat odpovídající značky zařízení pomocí dvojčete zařízení IoT Hubu. Aktualizujte ID nasazení IoT Edge a prioritu nasazení IoT Edge v upřesňujícím nastavení. Další informace o vytvoření nasazení pro více zařízení najdete v tématu Vysvětlení automatických nasazení IoT Edge.
    ID zařízení nebo cílová podmínka	V závislosti na předchozím výběru zadejte ID zařízení nebo cílovou podmínku , která se má nasadit do více zařízení.
    Rozšířený	Pro ID nasazení IoT Edge zadejte $(System.TeamProject)-$(Release.EnvironmentName). Tato proměnná mapuje název projektu a verze s ID nasazení IoT Edge.

    Pokud váš úkol zahrnuje použití image, která se nachází v privátním důvěryhodném registru Dockeru, který není viditelný pro veřejný cloud, můžete nastavit proměnnou prostředí SKIP_MODULE_IMAGE_VALIDATION tak, aby true přeskočí ověření image.

    

11. Výběrem možnosti Uložit uložte změny v novém kanálu verze. Vraťte se do zobrazení kanálu tak , že v nabídce vyberete kartu Kanál .

Ověření CI/CD ioT Edge s využitím kanálů buildu a verze

Pokud chcete aktivovat úlohu sestavení, můžete buď odeslat potvrzení do úložiště zdrojového kódu, nebo ji aktivovat ručně. V této části ručně aktivujete kanál CI/CD a otestujete, že funguje. Pak ověřte, že nasazení proběhne úspěšně.

1. V nabídce levého podokna vyberte Kanály a otevřete kanál buildu, který jste vytvořili na začátku tohoto článku.

2. Úlohu sestavení v kanálu buildu můžete aktivovat výběrem tlačítka Spustit kanál v pravém horním rohu.

   

3. Zkontrolujte nastavení kanálu spuštění. Pak vyberte Spustit.

   

4. Vyberte úlohu agenta 1 a sledujte průběh spuštění. Výběrem úlohy můžete zkontrolovat protokoly výstupu úlohy.

   

5. Pokud se kanál buildu úspěšně dokončí, aktivuje vydání fáze vývoje . Úspěšná verze pro vývoj vytvoří nasazení IoT Edge pro cíl na zařízení IoT Edge.

   

6. Výběrem vývojové fáze zobrazíte protokoly vydaných verzí.

   

7. Pokud váš kanál selhává, začněte tím, že se podíváte na protokoly. Protokoly můžete zobrazit tak, že přejdete do souhrnu spuštění kanálu a vyberete úlohu a úlohu. Pokud se určitá úloha nedaří, zkontrolujte protokoly pro danou úlohu. Podrobné pokyny ke konfiguraci a používání protokolů najdete v tématu Kontrola protokolů pro diagnostiku problémů s kanály.

Další kroky

• Vysvětlení nasazení IoT Edge v principech nasazení IoT Edge pro jednotlivá zařízení nebo ve velkém měřítku
• Projděte si postup vytvoření, aktualizace nebo odstranění nasazení v nasazení a monitorování modulů IoT Edge ve velkém měřítku.