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

Článek
08/26/2021

Platí pro: IoT Edge 1.4

Důležité

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

Azure Pipelines zahrnuje integrovanou úlohu Azure IoT Edge, která vám pomůže s přechodem DevOps s aplikacemi Azure IoT Edge. Tento článek ukazuje, jak pomocí funkcí kontinuální integrace a průběžného nasazování služby Azure Pipelines rychle a efektivně nasazovat aplikace do Azure IoT Edge pomocí klasického editoru. Alternativně můžete použít YAML.

Diagram kontinuální integrace a větví průběžného vývoje pro vývoj a produkci

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
Upřesnit – Pokud je to možné, zadejte moduly, které nechcete sestavit.
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.

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 a publikoval protokoly sestavení při každém vrácení změn do řešení IoT Edge.

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.
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 .
V dolní části stránky Kde je váš kód? vyberte Použít klasický editor. Pokud chcete k vytvoření kanálů sestavení projektu použít YAML, prohlédni si průvodce YAML.
Podle pokynů vytvořte kanál.
1. Zadejte informace o zdroji nového kanálu buildu. Jako zdroj vyberte Git Azure Repos a pak vyberte projekt, úložiště a větev, ve které se nachází váš kód řešení IoT Edge. Pak vyberte Pokračovat.
2. Místo šablony vyberte prázdnou úlohu .
Po vytvoření kanálu přejdete do editoru kanálů. Tady můžete změnit název kanálu, fond agentů a specifikaci agenta.

Můžete vybrat fond hostovaný Microsoftem nebo fond v místním prostředí, který spravujete.

V popisu kanálu zvolte správnou specifikaci agenta na základě cílové platformy:
- Pokud chcete vytvořit moduly na platformě amd64 pro linuxové kontejnery, zvolte ubuntu-18.04.
- Pokud chcete vytvořit moduly na platformě amd64 pro kontejnery Windows 1809, musíte ve Windows nastavit agenta v místním prostředí.
- Pokud chcete vytvořit moduly v platformě arm32v7 nebo arm64 pro linuxové kontejnery, musíte nastavit agenta v místním prostředí v Linuxu.
Váš kanál je předem nakonfigurovaný s úlohou s názvem Agent job 1. Vyberte znaménko plus (+) a přidejte do úlohy čtyři úkoly: Azure IoT Edge dvakrát, jednou kopírovat soubory a publikovat artefakty sestavení jednou. Vyhledejte každý úkol a najeďte myší na název úkolu a zobrazte tlačítko Přidat .

Po přidání všech čtyř úkolů bude vaše úloha agenta vypadat jako v následujícím příkladu:

Vyberte první úlohu Azure IoT Edge , která ji chcete upravit. Tato úloha sestaví všechny moduly v řešení s cílovou platformou, kterou zadáte. Upravte úkol 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 Sestavení imagí modulů.
.template.json soubor	Vyberte tři tečky (...) a přejděte do 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.
Výstupní proměnné	Zadejte název odkazu, který se přidruží k cestě k souboru, kde deployment.json soubor generuje, například hranu.

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

Tyto konfigurace používají úložiště imagí a značky definované v module.json souboru k pojmenování a označení image modulu. Image modulu sestavení také pomáhají nahradit proměnné přesnou hodnotou, kterou definujete v module.json souboru. V sadě Visual Studio nebo Visual Studio Code zadáte skutečnou .env hodnotu v souboru. V Azure Pipelines nastavíte hodnotu na kartě Proměnné kanálu. V nabídce editoru kanálů vyberte 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. Hodnotu přihlašovacího serveru najdete na stránce přehledu registru kontejneru na webu Azure Portal.

Pokud máte v projektu jiné proměnné, můžete zadat název a hodnotu na této kartě. Image modulu sestavení rozpoznávají pouze proměnné ve ${VARIABLE} formátu. Ujistěte se, že tento formát používáte ve svých **/module.json souborech.

Vyberte druhou úlohu Azure IoT Edge a upravte ji. Tato úloha odešle všechny image modulů do registru kontejneru, který vyberete.

Parametr	Popis
Zobrazovaný název	Zobrazovaný název se automaticky aktualizuje při změně pole akce.
Akce	Vyberte obrázky modulu Push.
Typ registru kontejneru	Použijte výchozí typ: `Azure Container Registry`.
Předplatné Azure	Zvolte vaše předplatné.
Azure Container Registry	Vyberte typ registru kontejneru, který používáte k ukládání imagí modulů. V závislosti na tom, jaký typ registru zvolíte, se formulář změní. Pokud zvolíte Azure Container Registry, pomocí rozevíracích seznamů vyberte předplatné Azure a název vašeho registru kontejneru. Pokud zvolíte Generic Container Registry, vyberte Možnost Nový a vytvořte připojení služby registru.
.template.json soubor	Vyberte tři tečky (...) a přejděte do 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.
Přidání přihlašovacích údajů registru do manifestu nasazení	Zadejte true pro přidání přihlašovacích údajů registru pro nabízení imagí Dockeru do manifestu nasazení.

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

Pokud máte k hostování imagí modulů více registrů kontejnerů, musíte tuto úlohu duplikovat, vybrat jiný registr kontejneru a pomocí modulů Bypass v rozšířených nastaveních obejít image, které nejsou pro tento konkrétní registr.

Vyberte úlohu Kopírovat soubory a upravte ji. Tuto úlohu použijte ke kopírování souborů do přípravného adresáře artefaktů.

Parametr	Popis
Zobrazovaný název	Použití výchozího názvu nebo přizpůsobení
Zdrojová složka	Složka se soubory, které se mají zkopírovat.
Obsah	Přidejte dva řádky: `deployment.template.json` a `**/module.json`. Tyto dva soubory slouží jako vstupy pro generování manifestu nasazení IoT Edge.
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.

Vyberte úlohu Publikovat artefakty sestavení a upravte ji. Zadejte cestu k pracovnímu adresáři artefaktů k úloze, aby se cesta mohla publikovat do kanálu verze.

Parametr	Popis
Zobrazovaný název	Použijte výchozí název nebo přizpůsobte.
Cesta k publikování	Zadejte proměnnou `$(Build.ArtifactStagingDirectory)`. Další informace najdete v tématu Vytváření proměnných .
Název artefaktu	Použijte výchozí název: drop
Umístění publikování artefaktů	Použít 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í.

Otevřete kartu Triggery a zaškrtněte políčko Povolit kontinuální integraci. Ujistěte se, že je zahrnutá větev obsahující váš kód.

Snímek obrazovky znázorňující, jak zapnout trigger kontinuální integrace

V rozevíracím seznamu Uložit a frontu vyberte Uložit.

Tento kanál je teď nakonfigurovaný tak, aby se spouštěl automaticky, když do úložiště odešlete nový kód. Poslední úloha, publikování artefaktů kanálu, aktivuje kanál verze. 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ý se nakonfiguruje tak, aby se spouštěl automaticky, když kanál buildu zahodí artefakty, a zobrazí se protokoly nasazení v Azure Pipelines.

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

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.
Po zobrazení výzvy k výběru šablony zvolte, že chcete začít s prázdnou úlohou.
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.
Propojte verzi s artefakty sestavení, které jsou publikovány kanálem buildu. Klikněte na Přidat v oblasti artefaktů.
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.
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.
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ů.
V úloze pro kontrolu kvality vyberte znaménko plus (+) a přidejte dva úkoly. Vyhledejte a přidejte Azure IoT Edge dvakrát.

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}"
  }
}

Konfigurace proměnných pro kanál verze na kartě Proměnné

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.

Přidání úloh Azure IoT Edge pro vývojovou fázi

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 .

Poznámka:

V úlohách Azure IoT Edge v Azure DevOps se zatím nepodporují vrstvené nasazení.

K vytvoření nasazení jako vrstveného nasazení ale můžete použít úlohu Azure CLI v Azure DevOps . Pro hodnotu Vložený skript můžete použít příkaz az iot edge deployment create:

az iot edge deployment create -d {deployment_name} -n {hub_name} --content modules_content.json --layered true

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ě.

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.
Úlohu sestavení v kanálu buildu můžete aktivovat výběrem tlačítka Spustit kanál v pravém horním rohu.
Zkontrolujte nastavení kanálu spuštění. Pak vyberte Spustit.
Vyberte úlohu agenta 1 a sledujte průběh spuštění. Výběrem úlohy můžete zkontrolovat protokoly výstupu úlohy.
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.
Kliknutím na fázi vývoje zobrazíte protokoly vydaných verzí.
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.

Sdílet prostřednictvím