Sdílet prostřednictvím


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:

  1. 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).

  2. Vytvořte připojení mezi pracovním prostorem a úložištěm Git v Azure DevOps.

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

Vytvoření pracovního prostoru aplikace logiky, projektu a pracovního postupu

  1. V editoru Visual Studio Code na panelu aktivit vyberte ikonu Azure.

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

    Snímek obrazovky znázorňující Visual Studio Code, ikonu Azure vybranou v nabídce vlevo, oddíl Pracovní prostor a vybranou možnost Pro vytvoření nového pracovního prostoru aplikace logiky

  3. Postupujte podle pokynů a dokončete následující úlohy:

    1. Vyberte složku, do které chcete vytvořit pracovní prostor.

    2. Zadejte název pracovního prostoru.

    3. Vyberte typ projektu: Aplikace logiky

    4. Zadejte název projektu aplikace logiky.

    5. Vyberte šablonu pracovního postupu. Zadejte název pracovního postupu.

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

  4. Pomocí následujícího postupu otevřete návrháře pracovního postupu:

    1. V projektu aplikace logiky rozbalte složku s názvem pracovního postupu.

    2. Pokud ještě není otevřený, otevřete soubor workflow.json , otevřete místní nabídku souboru a vyberte Otevřít Návrhář.

    3. 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í.

    4. 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:

        1. Otevřete místní nabídku pro soubor workflow.json a v Azure vyberte Použít konektory.

        2. Vyberte existující skupinu prostředků Azure, kterou chcete použít pro aplikaci logiky.

        3. Znovu načtěte návrháře pracovního postupu.

      • Existující skupina prostředků Azure, kterou chcete použít pro aplikaci logiky

  5. Až budete hotovi, znovu načtěte návrháře pracovního postupu. Pokud se zobrazí výzva, přihlaste se k Azure.

    Snímek obrazovky znázorňující Visual Studio Code, ikonu Průzkumníka vybranou v nabídce vlevo, projekt aplikace logiky a návrhář pracovního postupu

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

  1. V prázdné oblasti ve všech souborech projektu otevřete místní nabídku projektu a vyberte Vygenerovat skripty nasazení.

    Snímek obrazovky znázorňující Visual Studio Code, ikonu Průzkumníka vybranou v nabídce vlevo, projekt aplikace logiky, místní nabídku otevřeného okna projektu a vybranou možnost Generovat skripty nasazení

  2. Postupujte podle pokynů a proveďte tyto kroky:

    1. Vyberte existující skupinu prostředků Azure, která se má použít pro vaši aplikaci logiky.

    2. Zadejte jedinečný název prostředku aplikace logiky.

    3. Zadejte jedinečný název prostředku účtu úložiště.

    4. Zadejte jedinečný název, který se má použít pro plán služby App Service.

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

    Snímek obrazovky ukazuje Visual Studio Code, ikonu Průzkumníka vybranou v nabídce vlevo, projekt aplikace logiky a zvýrazněnou složku skriptů nasazení s obsahem.

    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

  1. Následujícím postupem inicializujete úložiště:

    1. V editoru Visual Studio Code na panelu aktivit vyberte ikonu Správy zdrojového kódu .

    2. V okně Správy zdrojového kódu vyberte Inicializovat úložiště.

    3. V nabídce výzvy vyberte Zvolit složku. Vyberte kořenovou složku pracovního prostoru a pak vyberte Inicializovat úložiště.

      Snímek obrazovky ukazuje Visual Studio Code, okno Správy zdrojového kódu a vybranou možnost s názvem Initialize Repository (Inicializovat úložiště).

    4. V okně Správy zdrojového kódu vyberte Otevřít úložiště.

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

  2. Pokud chcete získat adresu URL úložiště Git, abyste mohli přidat vzdálené úložiště, postupujte takto:

    1. V Azure DevOps otevřete týmový projekt pro vaši organizaci Azure DevOps.

    2. V nabídce vlevo rozbalte úložiště a vyberte Soubory.

    3. Na panelu nástrojů podokna Soubory vyberte Klonovat.

      Snímek obrazovky znázorňující týmový projekt Azure DevOps, úložiště Git a vybranou možnost Klon

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

  3. Pokud chcete přidat vzdálené úložiště Git, postupujte takto:

    1. Vraťte se do editoru Visual Studio Code a do okna Správy zdrojového kódu .

    2. V části Úložiště správy zdrojového kódu na panelu nástrojů úložiště otevřete nabídku se třemi tečkami (...) a vyberte Vzdálené přidání vzdáleného>úložiště.

      Snímek obrazovky ukazuje Visual Studio Code, okno správy zdrojového kódu a vybranou možnost s názvem Přidat vzdálený přístup.

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

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

    Snímek obrazovky znázorňující Visual Studio Code, okno správy zdrojového kódu, otevřený soubor CD-pipeline.yml a zvýrazněné zdrojové pole pro název kanálu CI

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

  1. V Azure DevOps se vraťte do týmového projektu a do podokna Soubory úložiště>.

  2. V podokně Soubory vyberte Nastavit sestavení.

    Snímek obrazovky znázorňující týmový projekt Azure DevOps, úložiště Git a vybranou možnost s názvem Nastavit sestavení

  3. V podokně Inventář kanálu potvrďte informace o úložišti a vyberte Konfigurovat kanál.

    Snímek obrazovky znázorňující stránku Inventář s informacemi o úložišti pro váš kanál

  4. V podokně Konfigurace kanálu vyberte Existující soubor YAML služby Azure Pipelines.

    Snímek obrazovky znázorňující stránku Konfigurovat pro výběr typu kanálu

  5. V podokně Vybrat existující soubor YAML vyberte soubor Infrastructure-pipeline.yml následujícím postupem:

    1. Ve větvi vyberte větev, ve které jste potvrdili změny, například hlavní větev nebo větev vydané verze.

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

    3. Až budete připraveni, vyberte Pokračovat.

      Snímek obrazovky s podoknem Pro výběr existujícího souboru YAML

  6. V podokně Konfigurace kanálu vyberte Zkontrolovat kanál.

  7. 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.
  8. Až budete hotovi, zvolte tlačítko Uložit.

    Snímek obrazovky zobrazuje podokno s názvem Zkontrolovat řízený kanál.

Zobrazení a spuštění kanálu

Pokud chcete kanál najít a spustit, postupujte takto:

  1. V levé nabídce týmového projektu rozbalte kanály a vyberte Kanály.

  2. Výběrem karty Vše zobrazíte všechny dostupné kanály. Najděte a vyberte svůj kanál.

  3. Na panelu nástrojů kanálu vyberte Spustit kanál.

    Snímek obrazovky znázorňuje podokno vytvořeného kanálu a vybranou možnost pro spuštění kanálu.

Další informace najdete v tématu Vytvoření prvního kanálu.

Viz také