Automatizace sestavení a nasazení pro pracovní postupy standardní aplikace logiky pomocí Azure DevOps
V případě pracovních postupů standardních aplikací logiky, které běží v Azure Logic Apps s jedním tenantem, můžete použít Visual Studio Code s rozšířením Azure Logic Apps (Standard) k místnímu vývoji, testování a ukládání projektu aplikace logiky pomocí libovolného systému správy zdrojového kódu. Pokud ale chcete získat úplné výhody snadného a konzistentního nasazování pracovních postupů napříč různými prostředími a platformami, musíte také automatizovat proces sestavení a nasazení.
Rozšíření Azure Logic Apps (Standard) poskytuje nástroje pro vytváření a údržbu automatizovaných procesů sestavení a nasazení pomocí Azure DevOps. Než ale začnete s touto automatizací, zvažte následující prvky:
Prostředek aplikace logiky Azure, ve kterém vytváříte pracovní postupy
Připojení hostovaná v Azure, která používají pracovní postupy a jsou vytvořená z konektorů spravovaných Microsoftem.
Tato připojení se liší od připojení, která se spouští přímo a nativně s modulem runtime Azure Logic Apps.
Konkrétní nastavení a parametry pro různá prostředí, ve kterých chcete nasadit
Rozšíření vám pomůže dokončit následující požadované úlohy pro automatizaci sestavení a nasazení:
Parametrizovat odkazy na připojení v době návrhu. Tato úloha zjednodušuje proces aktualizace odkazů v různých prostředích, aniž by došlo k narušení místních funkcí vývoje.
Vygenerujte skripty, které automatizují nasazení pro prostředek aplikace logiky Standard, včetně všech závislých prostředků.
Vygenerujte skripty, které automatizují nasazení pro připojení hostovaná v Azure.
Připravte parametry specifické pro prostředí, které můžete vkládat do balíčku Azure Logic Apps během procesu sestavení, aniž by došlo k narušení místních funkcí vývoje.
Generování kanálů na vyžádání pomocí Azure DevOps pro podporu nasazení infrastruktury spolu s procesy sestavení a vydávání.
Tento průvodce ukazuje, jak provést následující úlohy:
Vytvořte pracovní prostor aplikace logiky a projekt v editoru Visual Studio Code, který obsahuje soubory, které vytvářejí kanály pro nasazení infrastruktury, kontinuální integraci (CI) a průběžné nasazování (CD).
Vytvořte připojení mezi pracovním prostorem a úložištěm Git v Azure DevOps.
Vytváření kanálů v Azure DevOps
Další informace najdete v následující dokumentaci:
Známé problémy a omezení
Tato funkce podporuje pouze projekty standardních aplikací logiky. Pokud váš pracovní prostor editoru Visual Studio Code obsahuje projekt standardní aplikace logiky i projekt vlastního kódu Functions, oba mají vygenerované skripty nasazení, ale projekty vlastního kódu se v současné době ignorují. Možnost vytvářet kanály buildu pro vlastní kód je v plánu.
Rozšíření vytvoří kanály pro nasazení infrastruktury, kontinuální integraci (CI) a průběžné nasazování (CD). Zodpovídáte ale za připojení kanálů k Azure DevOps a vytvoření relevantních triggerů.
V současné době rozšíření podporuje pouze šablony Azure Resource Management (šablony ARM) pro skripty nasazení infrastruktury. Další šablony se plánují.
Požadavky
Účet a předplatné Azure. Pokud předplatné nemáte, zaregistrujte si bezplatný účet Azure.
Visual Studio Code s rozšířením Azure Logic Apps (Standard). Pokud chcete tyto požadavky splnit, podívejte se na požadavky pro vytváření standardních pracovních postupů pomocí editoru Visual Studio Code.
Úlohy sestavení a vydání Azure Logic Apps (Standard) pro úlohy Azure DevOps Tyto úlohy najdete na Azure DevOps Marketplace.
Existující úložiště Git v Azure DevOps , kde můžete uložit projekt aplikace logiky.
Připojení služby Azure Resource Manager k existujícímu instančnímu objektu
Existující skupina prostředků Azure, do které chcete nasadit aplikaci logiky.
Vytvoření pracovního prostoru aplikace logiky, projektu a pracovního postupu
V editoru Visual Studio Code na panelu aktivit vyberte ikonu Azure.
V okně Azure na panelu nástrojů Pracovního prostoru otevřete nabídku Azure Logic Apps a vyberte Vytvořit nový pracovní prostor aplikace logiky.
Postupujte podle pokynů a dokončete následující úlohy:
Vyberte složku, do které chcete vytvořit pracovní prostor.
Zadejte název pracovního prostoru.
Vyberte typ projektu: Aplikace logiky
Zadejte název projektu aplikace logiky.
Vyberte šablonu pracovního postupu. Zadejte název pracovního postupu.
Vyberte, jestli chcete otevřít pracovní prostor v aktuálním okně editoru Visual Studio Code nebo v novém okně.
Visual Studio Code zobrazuje nový pracovní prostor a projekt aplikace logiky.
Pomocí následujícího postupu otevřete návrháře pracovního postupu:
V projektu aplikace logiky rozbalte složku s názvem pracovního postupu.
Pokud ještě není otevřený, otevřete soubor workflow.json , otevřete místní nabídku souboru a vyberte Otevřít Návrhář.
Po zobrazení výzvy k povolení parametrizací pro připojení při načítání projektu vyberte Ano.
Tento výběr umožňuje projektu používat parametry v definicích připojení, abyste mohli automatizovat sestavování a nasazení pro různá prostředí.
Podle pokynů vyberte tyto položky:
Použití konektorů z Azure
Poznámka:
Pokud tento krok přeskočíte, můžete použít jenom integrované konektory hostované za běhu. Pokud chcete konektory hostované Microsoftem povolit později, postupujte takto:
Otevřete místní nabídku pro soubor workflow.json a v Azure vyberte Použít konektory.
Vyberte existující skupinu prostředků Azure, kterou chcete použít pro aplikaci logiky.
Znovu načtěte návrháře pracovního postupu.
Existující skupina prostředků Azure, kterou chcete použít pro aplikaci logiky
Až budete hotovi, znovu načtěte návrháře pracovního postupu. Pokud se zobrazí výzva, přihlaste se k Azure.
Teď můžete pracovní postup upravit libovolným způsobem a místně otestovat pracovní postup. Pokud chcete vytvořit a otestovat ukázkový pracovní postup, přečtěte si téma Vytvoření standardních pracovních postupů pomocí editoru Visual Studio Code.
Generování skriptů nasazení
Po vytvoření a místním testování pracovního postupu vytvořte skripty nasazení.
V prázdné oblasti ve všech souborech projektu otevřete místní nabídku projektu a vyberte Vygenerovat skripty nasazení.
Postupujte podle pokynů a proveďte tyto kroky:
Vyberte existující skupinu prostředků Azure, která se má použít pro vaši aplikaci logiky.
Zadejte jedinečný název prostředku aplikace logiky.
Zadejte jedinečný název prostředku účtu úložiště.
Zadejte jedinečný název, který se má použít pro plán služby App Service.
Vyberte složku pracovního prostoru, do které chcete soubory vygenerovat.
Umístění složky nasazení Popis Nová složka nasazení (výchozí) V aktuálním pracovním prostoru vytvořte novou složku. Volba jiné složky Vyberte v aktuálním pracovním prostoru jinou složku.
Až budete hotovi, Visual Studio Code vytvoří v kořenovém adresáři vašeho pracovního prostoru složku s názvem deployment/{logic-app-name} . Tato složka používá stejný název aplikace logiky, který jste zadali v tomto postupu.
Poznámka:
Hodnoty proměnných, nastavení aplikace a parametrů v následujících souborech jsou předem vyplněné na základě vstupu, který jste zadali v těchto krocích. Při cílení na jiné prostředí se ujistěte, že aktualizujete hodnoty pro vytvořené parametry a soubory proměnných.
Ve složce {logic-app-name} máte následující strukturu:
Název složky Název a popis souboru ADOPipelineScripts - CD-pipeline.yml: Kanál průběžného doručování, který obsahuje pokyny k nasazení kódu aplikace logiky do prostředku aplikace logiky v Azure.
- CD-pipeline-variables.yml: Soubor YAML, který obsahuje proměnné používané souborem CD-pipeline.yml.
- CI-pipeline.yml: Kanál kontinuální integrace, který obsahuje pokyny k sestavení a generování artefaktů potřebných k nasazení prostředku aplikace logiky do Azure.
- CI-pipeline-variables.yml: Soubor YAML, který obsahuje proměnné používané souborem CI-pipeline.yml.
- infrastructure-pipeline.yml: Kanál YAML "Infrastruktura jako kód", který obsahuje pokyny k načtení všech šablon ARM do Azure a provedení kroků v souboru infrastructure-pipeline-template.yml.
- infrastructure-pipeline-template.yml: Soubor kanálu YAML, který obsahuje kroky nasazení prostředku aplikace logiky se všemi požadovanými závislostmi a nasazení každého spravovaného připojení vyžadovaného zdrojovým kódem.
- infrastructure-pipeline-variables.yml: Kanál YAML, který obsahuje všechny proměnné potřebné k provedení kroků v souboru infrastructure-pipeline-template.yml.ArmTemplates - {typ připojení}.parameters.json: Soubor parametrů Resource Manageru, který obsahuje parametry potřebné k nasazení připojení hostovaného v Azure s názvem {connection-type} do Azure. Tento soubor existuje pro každé připojení hostované v Azure ve vašem pracovním postupu.
- {connection-type}.template.json: Soubor šablony Resource Manageru, který představuje připojení hostované v Azure s názvem {connection-reference} a obsahuje informace použité k nasazení odpovídajícího prostředku připojení do Azure. Tento soubor existuje pro každé připojení hostované v Azure ve vašem pracovním postupu.
- {logic-app-name}.parameters.json: Soubor parametrů Resource Manageru, který obsahuje parametry potřebné k nasazení prostředku aplikace logiky Standard s názvem {logic-app-name} do Azure, včetně všech závislostí.
- {název_aplikace_logiky}.template.json: Soubor šablony Resource Manageru, který představuje prostředek standardní aplikace logiky s názvem {logic-app-name} a obsahuje informace použité k nasazení prostředku aplikace logiky do Azure.WorkflowParameters parameters.json: Tento soubor JSON je kopií místního souboru parametrů a obsahuje kopii všech uživatelem definovaných parametrů a cloudovou verzi všech parametrů vytvořených rozšířením pro parametrizaci připojení hostovaných v Azure. Tento soubor slouží k sestavení balíčku, který se nasadí do Azure.
Připojení pracovního prostoru k úložišti Git
Následujícím postupem inicializujete úložiště:
V editoru Visual Studio Code na panelu aktivit vyberte ikonu Správy zdrojového kódu .
V okně Správy zdrojového kódu vyberte Inicializovat úložiště.
V nabídce výzvy vyberte Zvolit složku. Vyberte kořenovou složku pracovního prostoru a pak vyberte Inicializovat úložiště.
V okně Správy zdrojového kódu vyberte Otevřít úložiště.
V nabídce výzvy vyberte úložiště, které jste právě vytvořili.
Další informace najdete v tématu Visual Studio Code – Inicializace úložiště v místní složce.
Pokud chcete získat adresu URL úložiště Git, abyste mohli přidat vzdálené úložiště, postupujte takto:
V Azure DevOps otevřete týmový projekt pro vaši organizaci Azure DevOps.
V nabídce vlevo rozbalte úložiště a vyberte Soubory.
Na panelu nástrojů podokna Soubory vyberte Klonovat.
V okně Klonovat úložiště zkopírujte verzi HTTPS adresy URL klonu.
Další informace najdete v tématu Získání adresy URL pro klonování úložiště Git v Azure Repos.
Pokud chcete přidat vzdálené úložiště Git, postupujte takto:
Na příkazovém řádku vložte zkopírovanou adresu URL a zadejte název vzdáleného umístění, což je obvykle původ.
Teď jste vytvořili propojení mezi editorem Visual Studio Code a vaším úložištěm.
Před nastavením kanálů v další části otevřete soubor CD-pipeline.yml a přejmenujte kanál CI v atributu
source
tak, aby odpovídal názvu kanálu CI, který chcete použít.V okně Správy zdrojového kódu potvrďte změny a publikujte je do úložiště.
Další informace najdete v tématu Fáze a potvrzení změn kódu.
Vytváření kanálů v Azure DevOps
Pokud chcete vytvořit infrastrukturu spolu s kanály CI a CD v Azure DevOps, opakujte následující kroky pro každý z následujících souborů kanálu:
- infrastructure-pipeline.yml pro kanál "Infrastruktura jako kód".
- CI-pipeline.yml pro kanál kontinuální integrace.
- CD-pipeline.yml pro kanál průběžného doručování.
Nastavení kanálu
V Azure DevOps se vraťte do týmového projektu a do podokna Soubory úložiště>.
V podokně Soubory vyberte Nastavit sestavení.
V podokně Inventář kanálu potvrďte informace o úložišti a vyberte Konfigurovat kanál.
V podokně Konfigurace kanálu vyberte Existující soubor YAML služby Azure Pipelines.
V podokně Vybrat existující soubor YAML vyberte soubor Infrastructure-pipeline.yml následujícím postupem:
Ve větvi vyberte větev, ve které jste potvrdili změny, například hlavní větev nebo větev vydané verze.
V části Cesta vyberte cestu, kterou chcete použít pro váš kanál. Výchozí hodnota je následující cesta:
deployment/{logic-app-name}/ADOPipelineScripts/{infrastructure-pipeline-name}.yml
Až budete připraveni, vyberte Pokračovat.
V podokně Konfigurace kanálu vyberte Zkontrolovat kanál.
V podokně Kontrola řízeného kanálu zadejte následující informace:
- Název kanálu: Zadejte název kanálu.
- Složka kanálu: Vyberte složku, do které chcete kanál uložit, a pojmenujte ji ./deployment/{logic-app-name}/pipelines.
Až budete hotovi, zvolte tlačítko Uložit.
Zobrazení a spuštění kanálu
Pokud chcete kanál najít a spustit, postupujte takto:
V levé nabídce týmového projektu rozbalte kanály a vyberte Kanály.
Výběrem karty Vše zobrazíte všechny dostupné kanály. Najděte a vyberte svůj kanál.
Na panelu nástrojů kanálu vyberte Spustit kanál.
Další informace najdete v tématu Vytvoření prvního kanálu.