Kurz: průběžná integrace šablon ARM pomocí Azure Pipelines

V předchozím kurzunasadíte propojenou šablonu. V tomto kurzu se naučíte, jak používat Azure Pipelines k průběžnému sestavování a nasazování projektů šablon Azure Resource Manager (šablony ARM).

Azure DevOps poskytuje Vývojářské služby pro podporu týmů pro plánování práce, spolupráci na vývoji kódu a sestavování a nasazování aplikací. Vývojáři můžou pracovat v cloudu pomocí Azure DevOps Services. Azure DevOps poskytuje integrovanou sadu funkcí, ke kterým můžete přistupovat prostřednictvím webového prohlížeče nebo klienta IDE. Kanál Azure je jednou z těchto funkcí. Azure Pipelines je plně funkční služba pro průběžnou integraci (CI) a průběžné doručování (CD). Funguje s vaším preferovaným poskytovatelem Git a může se nasadit do většiny hlavních cloudových služeb. Potom můžete automatizovat sestavení, testování a nasazení kódu pro Microsoft Azure, Google Cloud Platform nebo Amazon Web Services.

Poznámka

Vyberte název projektu. Když projdete kurz, nahraďte AzureRmPipeline názvem vašeho projektu. Tento název projektu se používá ke generování názvů prostředků. Jedním z prostředků je účet úložiště. Názvy účtů úložiště musí mít délku 3 až 24 znaků a musí obsahovat jenom číslice a malá písmena. Název musí být jedinečný. V šabloně je název účtu úložiště název projektu s připojeným úložištěm a název projektu musí být dlouhý 3 až 11 znaků. Proto název projektu musí splňovat požadavky na název účtu úložiště a má méně než 11 znaků.

Tento kurz se zabývá následujícími úkony:

  • Příprava úložiště GitHub
  • Vytvoření projektu Azure DevOps
  • Vytvoření kanálu Azure
  • Ověření nasazení kanálu
  • Aktualizujte šablonu a znovu nasaďte
  • Vyčištění prostředků

Pokud předplatné Azure ještě nemáte, napřed si vytvořte bezplatný účet.

Požadavky

K dokončení tohoto článku potřebujete:

Příprava úložiště GitHub

GitHub slouží k uložení zdrojového kódu projektu, včetně šablon Správce prostředků. Další podporovaná úložiště najdete v tématu úložiště podporovaná službou Azure DevOps.

Vytvoření úložiště GitHub

Pokud nemáte účet GitHubu, přečtěte si téma požadavky.

  1. Přihlaste se k GitHubu.

  2. V pravém horním rohu vyberte svůj obrázek účtu a pak vyberte svoje úložiště.

    Azure Resource Manager Azure DevOps Azure Pipelines vytvoření úložiště GitHubu

  3. Vyberte nové a zelené tlačítko.

  4. Do název úložiště zadejte název úložiště. Například AzureRmPipeline-úložiště. Nezapomeňte nahradit libovolný z AzureRmPipeline názvem vašeho projektu. V rámci tohoto kurzu můžete vybrat buď veřejné , nebo soukromé . A pak vyberte vytvořit úložiště.

  5. Zapište adresu URL. Adresa URL úložiště má následující formát: https://github.com/[YourAccountName]/[YourRepositoryName] .

Toto úložiště se označuje jako vzdálené úložiště. Každý z vývojářů stejného projektu může klonovat své vlastní místní úložiště a sloučit změny do vzdáleného úložiště.

Klonování vzdáleného úložiště

  1. Otevřete prostředí Git nebo Git bash. Viz Požadavky.

  2. Ověřte, jestli je aktuální složka GitHub.

  3. Spusťte následující příkaz:

    git clone https://github.com/[YourAccountName]/[YourGitHubRepositoryName]
    cd [YourGitHubRepositoryName]
    mkdir CreateWebApp
    cd CreateWebApp
    pwd
    

    Nahraďte [YourAccountName] názvem vašeho účtu GitHub a nahraďte [YourGitHubRepositoryName] názvem vašeho úložiště, který jste vytvořili v předchozím postupu.

Složka CreateWebApp je složka, ve které je šablona uložena. pwdPříkaz zobrazuje cestu ke složce. Cesta je místo, kam šablonu uložíte, do následujícího postupu.

Stažení šablony pro rychlé zprovoznění

Místo vytváření šablon můžete stáhnout šablony a uložit je do složky CreateWebApp .

Název složky i názvy souborů se používají tak, jak jsou v kanálu. Pokud tyto názvy změníte, je nutné aktualizovat názvy používané v kanálu.

Vložení šablony do vzdáleného úložiště

azuredeploy.jsv byla přidána do místního úložiště. V dalším kroku nahrajete šablonu do vzdáleného úložiště.

  1. Otevřete prostředí Git nebo Git bash, pokud není otevřené.

  2. Změňte adresář na složku CreateWebApp v místním úložišti.

  3. Ověřte, že azuredeploy.js v souboru je ve složce.

  4. Spusťte následující příkaz:

    git add .
    git commit -m "Add web app templates."
    git push origin main
    

    Může se zobrazit upozornění na LF. Upozornění můžete ignorovat. Main je hlavní větev. Pro každou aktualizaci obvykle vytvoříte větev. Pro zjednodušení tohoto kurzu použijete hlavní větev přímo.

  5. Přejděte do úložiště GitHub z prohlížeče. Adresa URL je https://github.com/[YourAccountName]/[YourGitHubRepository] . V rámci této složky se zobrazí složka CreateWebApp a dva soubory.

  6. Vyberte azuredeploy.js pro otevření šablony.

  7. Vyberte tlačítko nezpracované . Adresa URL začíná https://raw.githubusercontent.com .

  8. Zkopírujte adresu URL. Tuto hodnotu musíte zadat při konfiguraci kanálu později v tomto kurzu.

Zatím jste vytvořili úložiště GitHub a nahráli šablony do úložiště.

Vytvoření projektu DevOps

Aby bylo možné přejít k dalšímu postupu, je nutné, aby byla DevOps organizace. Pokud ho nemáte, přečtěte si téma požadavky.

  1. Přihlaste se k Azure DevOps.

  2. Vyberte DevOps organizaci vlevo.

    Azure Resource Manager Azure DevOps Azure Pipelines vytvoření projektu Azure DevOps

  3. Vyberte Nový projekt. Pokud nemáte žádné projekty, otevře se stránka vytvořit projekt automaticky.

  4. Zadejte tyto hodnoty:

    • Název projektu: zadejte název projektu. Můžete použít název projektu, který jste vybrali na začátku kurzu.
    • Správa verzí: vyberte Git. Pro zobrazení správy verzí možná budete muset rozbalit možnost Upřesnit .

    Pro ostatní vlastnosti použijte výchozí hodnotu.

  5. Vyberte Vytvořit.

Vytvořte připojení služby, které se používá k nasazení projektů do Azure.

  1. V dolní části nabídky vlevo vyberte nastavení projektu .

  2. V části kanály vyberte připojení služby .

  3. Vyberte vytvořit připojení služby, vyberte Azure Resource Manager a pak vyberte Další.

  4. Vyberte instanční objekt a pak vyberte Další.

  5. Zadejte tyto hodnoty:

    • Úroveň oboru: vyberte předplatné.
    • Předplatné: Vyberte předplatné.
    • Skupina prostředků: ponechte pole prázdné.
    • Název připojení: zadejte název připojení. Například AzureRmPipeline-připojeno. Poznamenejte si tento název. při vytváření kanálu budete potřebovat název.
    • Udělte přístupová oprávnění všem kanálům. Vyberte
  6. Vyberte Uložit.

Vytvoření kanálu

Až do této chvíle jste dokončili následující úlohy. Pokud přeskočíte předchozí oddíly, protože jste obeznámeni s GitHubem a DevOps, musíte před pokračováním dokončit úkoly.

  • Vytvořte úložiště GitHub a uložte šablony do složky CreateWebApp v úložišti.
  • Vytvořte projekt DevOps a vytvořte připojení služby Azure Resource Manager.

Vytvoření kanálu s krokem pro nasazení šablony:

  1. V nabídce vlevo vyberte kanály .

  2. Vyberte vytvořit kanál.

  3. Na kartě Connect (Připojit) vyberte GitHub. Pokud se zobrazí výzva, zadejte svoje přihlašovací údaje k GitHubu a pak postupujte podle pokynů. Pokud se zobrazí následující obrazovka, vyberte jenom možnost vybrat úložiště a ověřte, jestli je vaše úložiště v seznamu, než vyberete schválit & nainstalovat.

    Azure Resource Manager Azure DevOps Azure Pipelines vybrat jenom úložiště

  4. Na kartě Vybrat vyberte své úložiště. Výchozí název je [YourAccountName]/[YourGitHubRepositoryName] .

  5. Na kartě Konfigurace vyberte Počáteční kanál. Zobrazuje soubor kanálu Azure-Pipelines. yml se dvěma kroky skriptu.

  6. Odstraňte dva kroky skriptu ze souboru . yml .

  7. Přesuňte kurzor na řádek za kroků:.

  8. Vyberte Zobrazit pomocníka na pravé straně obrazovky a otevřete podokno úlohy .

  9. Vyberte nasazení šablony ARM.

  10. Zadejte tyto hodnoty:

    • deploymentScope: vyberte skupinu prostředků. Další informace o oborech najdete v tématu obory nasazení.
    • Azure Resource Manager připojení: vyberte název připojení služby, který jste vytvořili dříve.
    • Předplatné: Zadejte ID cílového předplatného.
    • Akce: vyberte akci vytvořit nebo aktualizovat skupinu prostředků 2 akce-1. Pokud je zadaný název nové skupiny prostředků, vytvořte skupinu prostředků. odst. Nasaďte zadanou šablonu.
    • Skupina prostředků: zadejte nový název skupiny prostředků. Například AzureRmPipeline-RG.
    • Umístění: vyberte umístění pro skupinu prostředků, například střed USA.
    • Umístění šablony: vyberte adresu URL souboru, což znamená, že úloha vyhledá soubor šablony pomocí adresy URL. Vzhledem k tomu, že se v hlavní šabloně používá RelativePath a RelativePath se podporuje jenom u nasazení na základě identifikátorů URI, musíte místo toho použít adresu URL.
    • Odkaz na šablonu: zadejte adresu URL, kterou jste dostali na konci oddílu Příprava úložiště GitHub . Začíná na https://raw.githubusercontent.com .
    • Odkaz na parametry šablony: ponechte toto pole prázdné. Hodnoty parametrů budete zadávat v parametrech přepsání šablony.
    • Přepsat parametry šablony: zadejte -projectName [EnterAProjectName] .
    • Režim nasazení: vyberte přírůstkové.
    • Název nasazení: zadejte DeployPipelineTemplate. Než uvidíte název nasazení, vyberte Upřesnit .

    Snímek obrazovky zobrazující stránku nasazení šablony ARM s zadanými požadovanými hodnotami.

  11. Vyberte Přidat.

    Další informace o úloze najdete v tématu Úloha nasazení skupiny prostředků Azurea úloha nasazení šablony Azure Resource Manager .

    Soubor . yml by měl vypadat nějak takto:

    Snímek obrazovky zobrazující stránku recenze s novým kanálem s názvem zkontrolujte YAML kanálu.

  12. Vyberte Uložit a spustit.

  13. V podokně Uložit a spustit vyberte Uložit a spustit znovu. Kopie souboru YAML se uloží do připojeného úložiště. Soubor YAML můžete zobrazit tak, že přejdete do úložiště.

  14. Ověřte, že se kanál úspěšně spustil.

    Azure Resource Manager Azure DevOps Azure Pipelines YAML

Ověření nasazení

  1. Přihlaste se na Azure Portal.
  2. Otevřete skupinu prostředků. Název je to, co jste zadali v souboru YAML kanálu. Uvidíte, že se vytvořil jeden účet úložiště. Název účtu úložiště začíná na Storu.
  3. Vyberte název účtu úložiště, který chcete otevřít.
  4. Vyberte Vlastnosti. Všimněte si, že replikace je místně redundantní úložiště (LRS).

Aktualizace a opětovné nasazení

Když aktualizujete šablonu a nahrajete změny do vzdáleného úložiště, kanál v tomto případě automaticky aktualizuje prostředky a účet úložiště.

  1. Otevřete linkedStorageAccount.js z místního úložiště v Visual Studio Code nebo v libovolném textovém editoru.

  2. Aktualizujte hodnotu DefaultValue storageAccountType na Standard_GRS. Viz následující snímek obrazovky:

    Azure Resource Manager Azure DevOps Azure Pipelines Update YAML

  3. Uložte změny.

  4. Dodejte změny do vzdáleného úložiště spuštěním následujících příkazů z Gitu bash/shell.

    git pull origin main
    git add .
    git commit -m "Update the storage account type."
    git push origin main
    

    První příkaz ( pull ) synchronizuje místní úložiště se vzdáleným úložištěm. Soubor YAML kanálu se přidal jenom do vzdáleného úložiště. Spuštění pull příkazu stáhne kopii souboru YAML do místní větve.

    Čtvrtý příkaz ( push ) nahraje revidované linkedStorageAccount.js souboru do vzdáleného úložiště. Když se hlavní větev vzdáleného úložiště aktualizuje, kanál se znovu aktivuje.

Chcete-li ověřit změny, můžete zkontrolovat vlastnost replikace účtu úložiště. Viz Ověření nasazení.

Vyčištění prostředků

Pokud už nasazené prostředky Azure nepotřebujete, vyčistěte je odstraněním skupiny prostředků.

  1. Z Azure Portal v nabídce vlevo vyberte Skupina prostředků .
  2. Do pole Filtrovat podle názvu zadejte název skupiny prostředků.
  3. Vyberte název skupiny prostředků.
  4. V horní nabídce vyberte Odstranit skupinu prostředků .

Možná budete chtít odstranit i úložiště GitHub a projekt Azure DevOps.

Další kroky

Gratulujeme, dokončili jste tento Správce prostředků kurz nasazení šablony. Dejte nám vědět, pokud máte komentáře a návrhy v části věnované zpětné vazbě. Díky! Jste připraveni přejít k pokročilejším koncepcím o šablonách. V dalším kurzu se dozvíte víc o používání Referenční dokumentace k šablonám, které vám pomůžou definovat prostředky k nasazení.