Cvičení – nastavení prostředí Azure DevOps

  • 15 min

V této části se ujistěte, že je vaše organizace Azure DevOps nastavená tak, aby dokončila zbytek tohoto modulu. Vytvoříte také prostředí Aplikace Azure Service, do kterých nasadíte.

Pokud chcete nastavit systém, budete:

  • Přidejte uživatele, abyste měli jistotu, že se Azure DevOps může připojit k vašemu předplatnému Azure.
  • Nastavte pro tento modul projekt Azure DevOps.
  • V Azure Boards přesuňte pracovní položku pro tento modul do sloupce Probíhá .
  • Pomocí Azure CLI v Azure Cloud Shellu vytvořte prostředí služby Aplikace Azure Service.
  • Vytvořte proměnné kanálu, které definují názvy prostředí App Service.
  • Vytvořte připojení služby, které službě Azure Pipelines umožňuje zabezpečený přístup k vašemu předplatnému Azure.

Přidání uživatele do Azure DevOps

K dokončení tohoto modulu potřebujete vlastní předplatné Azure. S Azure můžete začít zdarma.

I když k práci s Azure DevOps nepotřebujete předplatné Azure, v tomto modulu použijete Azure DevOps k nasazení do prostředků, které existují ve vašem předplatném Azure. Pokud chcete tento proces zjednodušit, měli byste k přihlášení k předplatnému Azure i k organizaci Azure DevOps použít stejný účet Microsoft.

Pokud k přihlášení k Azure a Azure DevOps používáte různé účty Microsoft, přidejte uživatele do vaší organizace DevOps pod účet Microsoft, který používáte pro přihlášení k Azure. Další informace najdete v tématu Přidání uživatelů do organizace nebo projektu. Když přidáte uživatele, zvolte úroveň základního přístupu.

Pak se odhlaste z Azure DevOps a znovu se přihlaste pod účtem Microsoft, který používáte k přihlášení ke svému předplatnému Azure.

Získání projektu Azure DevOps

Tady se ujistěte, že je vaše organizace Azure DevOps nastavená tak, aby dokončila zbytek tohoto modulu. Začnete spuštěním šablony, která vytvoří váš projekt v Azure DevOps.

Moduly v tomto studijním programu jsou součástí postupu, který se řídí webovým týmem Tailspin prostřednictvím své cesty DevOps. Pro účely výuky má každý modul přidružený projekt Azure DevOps.

Spustit šablonu

Spusťte šablonu, která nastaví vaši organizaci Azure DevOps.

Spustit šablonu

Na webu Azure DevOps Demo Generator spusťte šablonu podle těchto kroků.

  1. Vyberte Přihlásit se a přijměte podmínky použití.

  2. Na stránce Vytvořit nový projekt vyberte svoji organizaci Azure DevOps a zadejte název projektu, například Space Game – web – Nefunkční testy.

    Screenshot for Creating a project through the Azure DevOps Demo Generator.

  3. Vyberte Ano, chci vytvořit fork tohoto úložiště a pak vyberte Autorizovat.

  4. Vyberte Vytvořit projekt.

    Spuštění šablony chvíli trvá.

  5. Výběrem možnosti Přejít na projekt přejdete do projektu v Azure DevOps.

Důležité

Stránka o vyčištění prostředí Azure DevOps v tomto modulu obsahuje důležité kroky pro vyčištění. Vyčištěním pomůžete zajistit, abyste nevyčerpali bezplatné minuty sestavení. Postup pro vyčištění proveďte i v případě, že tento modul nedokončíte.

Nastavení viditelnosti projektu

Na začátku je váš fork úložiště Space Game na GitHubu nastavený na veřejný, zatímco projekt vytvořený šablonou Azure DevOps je nastavený na privátní. K veřejnému úložišti na GitHubu může přistupovat kdokoli, zatímco soukromé úložiště je přístupné jenom vám a lidem, se kterými ho chcete sdílet. Podobně veřejné projekty v Azure DevOps poskytují přístup jen pro čtení neověřených uživatelům, zatímco soukromé projekty vyžadují, aby měli uživatelé udělený přístup a ověřili přístup ke službám.

V tuto chvíli není nutné upravovat žádná z těchto nastavení pro účely tohoto modulu. U vašich osobních projektů však musíte určit viditelnost a přístup, který chcete udělit ostatním. Pokud je váš projekt například opensourcový, můžete se rozhodnout, že své úložiště GitHub i projekt Azure DevOps zveřejníte. Pokud je váš projekt proprietární, obvykle byste své úložiště GitHub i projekt Azure DevOps mohli nastavit jako soukromé.

Později můžete najít následující zdroje informací, které vám pomůžou určit, která možnost je pro váš projekt nejvhodnější:

Místní nastavení projektu

Tady načtete projekt Space Game v editoru Visual Studio Code, nakonfigurujete Git, místně naklonujete úložiště a nastavíte upstreamový vzdálený, abyste mohli stáhnout počáteční kód.

Poznámka:

Pokud už máte nastavený projekt mslearn-tailspin-spacegame-web-deploy místně, můžete přejít k další části.

Otevření integrovaného terminálu

Visual Studio Code se dodává s integrovaným terminálem. Tady můžete upravovat soubory i pracovat z příkazového řádku.

  1. Spusťte Visual Studio Code.

  2. V nabídce Zobrazení vyberte Terminál.

  3. V rozevíracím seznamu vyberte Git Bash. Pokud znáte jiné prostředí unixu, které chcete použít, vyberte místo toho toto prostředí.

    A screenshot of Visual Studio Code showing the location of the Git Bash shell.

    V okně terminálu můžete zvolit libovolné prostředí nainstalované ve vašem systému. Můžete například zvolit Git Bash nebo PowerShell nebo jiné prostředí.

    Tady použijete Git Bash, který je součástí Gitu pro Windows, což usnadňuje spouštění příkazů Gitu.

    Poznámka:

    Pokud ve Windows nevidíte Git Bash uvedený jako možnost, ujistěte se, že jste nainstalovali Git, a restartujte Visual Studio Code.

  4. Spuštěním cd příkazu přejděte do adresáře, do kterého chcete pracovat. Pokud chcete, zvolte svůj domovský adresář (~) nebo jiný adresář.

    cd ~

Konfigurace Gitu

Pokud s Gitem a GitHubem teprve začínáte, nejprve spusťte několik příkazů, které přidruží vaši identitu k Gitu a ověří se pomocí GitHubu. Další informace najdete v tématu Nastavení Gitu.

Minimálně je potřeba provést následující kroky. Spusťte příkazy z integrovaného terminálu.

  1. Nastavte své uživatelské jméno.
  2. Nastavte e-mailovou adresu potvrzení.
  3. Heslo GitHubu si můžete uložit do mezipaměti.

Poznámka:

Pokud už s GitHubem používáte dvojúrovňové ověřování, vytvořte osobní přístupový token. Po zobrazení výzvy použijte token místo hesla.

Zacházejte s přístupovým tokenem jako s heslem. Udržujte ho na bezpečném místě.

Nastavení projektu v editoru Visual Studio Code

Ve studijním programu Vytváření aplikací pomocí Azure DevOps jste vytvořili fork a pak naklonovali úložiště Git. Úložiště obsahuje zdrojový kód pro web Space Game . Váš fork byl připojený k vašim projektům v Azure DevOps, aby se sestavení spustilo při nasdílení změn do GitHubu.

Důležité

V tomto studijním programu přejdeme do jiného úložiště Git mslearn-tailspin-spacegame-web-deploy. Když jste spustili šablonu pro nastavení projektu Azure DevOps, proces automaticky rozvětvoval úložiště za vás.

V této části naklonujete fork místně, abyste mohli změnit a sestavit konfiguraci kanálu.

Místní klonování forku

Nyní máte kopii webového projektu Space Game na účtu GitHub. Teď si stáhnete nebo naklonujete kopii do počítače, abyste s ní mohli pracovat.

Klon, stejně jako fork, je kopií úložiště. Při klonování úložiště můžete provádět změny, ověřit, že fungují podle očekávání, a pak tyto změny nahrát do GitHubu. Místní kopii můžete také synchronizovat se změnami, které jiní ověření uživatelé provedli v kopii vašeho úložiště Na GitHubu.

Webový projekt Space Game naklonujete do svého počítače takto:

  1. Přejděte na svůj fork webového projektu Space Game (mslearn-tailspin-spacegame-web-deploy) na GitHubu.

  2. Vyberte Kód. Potom na kartě HTTPS vyberte tlačítko vedle adresy URL, která se zobrazí, a zkopírujte adresu URL do schránky.

    Screenshot that shows how to locate the URL and copy button from the GitHub repository.

  3. V editoru Visual Studio Code přejděte do okna terminálu.

  4. V terminálu přejděte do adresáře, kam chcete pracovat. Pokud chcete, zvolte svůj domovský adresář (~) nebo jiný adresář.

    cd ~

  5. Spusťte příkaz git clone. Nahraďte adresu URL zobrazenou tady obsahem schránky:

    git clone https://github.com/your-name/mslearn-tailspin-spacegame-web-deploy.git

  6. Přejděte do adresáře mslearn-tailspin-spacegame-web-deploy. Toto je kořenový adresář vašeho úložiště.

    cd mslearn-tailspin-spacegame-web-deploy

Nastavení upstreamového vzdáleného úložiště

Vzdálené je úložiště Git, ve kterém členové týmu spolupracují (například úložiště na GitHubu). Tady zobrazíte seznam vzdálených zařízení a přidáte vzdálený odkaz, který odkazuje na kopii úložiště Microsoftu, abyste mohli získat nejnovější ukázkový kód.

  1. Spuštěním tohoto git remote příkazu zobrazte seznam vzdálených zařízení:

    git remote -v

    Uvidíte, že máte k úložišti přístup k načtení (stažení) i nahrání (nahrání):

    origin  https://github.com/username/mslearn-tailspin-spacegame-web-deploy.git (fetch)
origin  https://github.com/username/mslearn-tailspin-spacegame-web-deploy.git (push)

    Origin určuje vaše úložiště na GitHubu. Když forkujete kód z jiného úložiště, původní vzdálený (ten, ze které jste forkovali) se často nazývá upstream.

  2. Spuštěním tohoto git remote add příkazu vytvořte vzdálený pojmenovaný upstream , který odkazuje na úložiště Microsoftu:

    git remote add upstream https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web-deploy.git

  3. Znovu spusťte git remote , abyste viděli změny:

    git remote -v

    Vidíte, že stále máte k úložišti přístup k načtení (stahování) i přístup k nahrání (nahrání). Teď máte také přístup k úložišti Microsoftu:

    origin  https://github.com/username/mslearn-tailspin-spacegame-web-deploy.git (fetch)
origin  https://github.com/username/mslearn-tailspin-spacegame-web-deploy.git (push)
upstream        https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web-deploy.git (fetch)

Otevření projektu v Průzkumníkovi souborů

V nástroji Visual Studio Code směřuje okno terminálu do kořenového adresáře webového projektu Space Game. Pokud chcete zobrazit jeho strukturu a pracovat se soubory, otevřete projekt v Průzkumníkovi souborů.

  1. Nejjednodušším způsobem, jak otevřít projekt, je znovu otevřít Visual Studio Code v aktuálním adresáři. Provedete to spuštěním následujícího příkazu z integrovaného terminálu:

    code -r .

    V průzkumníkovi souborů se zobrazí stromová struktura adresářů a souborů.

  2. Znovu otevřete integrovaný terminál. Terminál vás umístí do kořenového adresáře webového projektu.

Pokud se code příkaz nezdaří, musíte do systémové CESTY přidat Visual Studio Code. Postup:

  1. V editoru Visual Studio Code vyberte F1 nebo vyberte Zobrazit>paletu příkazů pro přístup k paletě příkazů.
  2. Na paletě příkazů zadejte příkaz shellu: Nainstalujte v cestě PATH příkaz code.
  3. Opakujte předchozí postup a otevřete projekt v Průzkumníku souborů.

Teď jste nastavili, abyste mohli pracovat se zdrojovým kódem Space Game a konfigurací Služby Azure Pipelines z místního vývojového prostředí.

Vytvoření prostředí služby Aplikace Azure Service

Tady vytvoříte prostředí, která definují fáze kanálu. Vytvoříte jednu instanci služby App Service, která odpovídá každé fázi: vývoj, testování a příprava.

V předchozíchmodulech Tady to uděláte stejně.

Důležité

Nezapomeňte, že k dokončení cvičení v tomto modulu potřebujete vlastní předplatné Azure.

Vyvolání Cloud Shellu prostřednictvím webu Azure Portal

  1. Přejděte na web Azure Portal a přihlaste se.
  2. Na řádku nabídek vyberte Cloud Shell. Po zobrazení výzvy vyberte prostředí Bash .

Výběr oblasti Azure

Tady zadáte výchozí oblast nebo geografické umístění, kde se mají prostředky Azure vytvořit.

  1. Spuštěním následujícího az account list-locations příkazu v Cloud Shellu zobrazte seznam oblastí dostupných z vašeho předplatného Azure.

    az account list-locations \
  --query "[].{Name: name, DisplayName: displayName}" \
  --output table

  2. Ve výstupu ve sloupci Název zvolte oblast, která je blízko vás. Můžete například zvolit eastasia nebo westus2.

  3. Spuštěním az configure nastavíte výchozí oblast. > Oblast nahraďte <názvem oblasti, kterou jste zvolili.

    az configure --defaults location=<REGION>

    Tady je příklad, který nastaví westus2 jako výchozí oblast:

    az configure --defaults location=westus2

Vytvoření instancí služby App Service

Tady vytvoříte instance služby App Service pro tři fáze, do kterých nasadíte: Vývoj, Testování a Příprava.

Poznámka:

Pro účely výuky použijte výchozí nastavení sítě. Díky těmto nastavením bude váš web přístupný z internetu. V praxi byste mohli nakonfigurovat virtuální síť Azure, která umístí váš web do sítě, která není směrovatelná z internetu a která je přístupná jenom vašemu týmu. Až budete připravení, můžete síť překonfigurovat tak, aby byl web dostupný uživatelům.

  1. V Cloud Shellu vygenerujte náhodné číslo, které vytvoří jedinečný název domény vaší webové aplikace.

    webappsuffix=$RANDOM

  2. Spuštěním následujícího az group create příkazu vytvořte skupinu prostředků s názvem tailspin-space-game-rg.

    az group create --name tailspin-space-game-rg

  3. Spuštěním následujícího az appservice plan create příkazu vytvořte plán služby App Service s názvem tailspin-space-game-asp.

    az appservice plan create \
  --name tailspin-space-game-asp \
  --resource-group tailspin-space-game-rg \
  --sku B1 \
  --is-linux

    Argument --sku určuje plán B1 , který běží na úrovni Basic . Argument --is-linux určuje, že se mají používat linuxové pracovní procesy.

    Důležité

    Pokud skladová položka B1 není dostupná jako součást předplatného Azure, zvolte jiný plán, například S1 (Standard).

  4. Spuštěním následujících az webapp create příkazů vytvořte tři instance služby App Service, jednu pro každé pracovní prostředí pro vývoj, testování a přípravu .

    az webapp create \
  --name tailspin-space-game-web-dev-$webappsuffix \
  --resource-group tailspin-space-game-rg \
  --plan tailspin-space-game-asp \
  --runtime "DOTNET|6.0"

az webapp create \
  --name tailspin-space-game-web-test-$webappsuffix \
  --resource-group tailspin-space-game-rg \
  --plan tailspin-space-game-asp \
  --runtime "DOTNET|6.0"

az webapp create \
  --name tailspin-space-game-web-staging-$webappsuffix \
  --resource-group tailspin-space-game-rg \
  --plan tailspin-space-game-asp \
  --runtime "DOTNET|6.0"

    Pro účely výuky tady použijete stejný plán služby App Service B1 Basic pro každou instanci služby App Service. V praxi byste přiřadili plán, který odpovídá očekávané úloze.

  5. Spuštěním následujícího az webapp list příkazu vypíšete název hostitele a stav každé instance služby App Service.

    az webapp list \
  --resource-group tailspin-space-game-rg \
  --query "[].{hostName: defaultHostName, state: state}" \
  --output table

    Poznamenejte si název hostitele pro každou spuštěnou službu. Tyto názvy hostitelů budete potřebovat později, když ověříte svou práci. Tady je příklad:

    HostName                                                 State
-------------------------------------------------------  -------
tailspin-space-game-web-dev-21017.azurewebsites.net      Running
tailspin-space-game-web-test-21017.azurewebsites.net     Running
tailspin-space-game-web-staging-21017.azurewebsites.net  Running

  6. Jako volitelný krok přejděte k jednomu nebo několika uvedeným názvům a ověřte, že jsou spuštěné a že se zobrazí výchozí domovská stránka.

    Zobrazí se tato stránka:

    Screenshot of the default home page on Azure App Service.

Důležité

Stránka o vyčištění prostředí Azure DevOps v tomto modulu obsahuje důležité kroky pro vyčištění. Vyčištění pomáhá zajistit, abyste po dokončení tohoto modulu neúčtovaly poplatky za prostředky Azure. Nezapomeňte postupovat podle kroků čištění, i když tento modul nedokončíte.

Vytváření proměnných kanálu v Azure Pipelines

Při spouštění funkčních testů v Azure Pipelines jste přidali jednu proměnnou pro každou instanci služby App Service. Instance odpovídají fázím vývoje, testování a přípravy ve vašem kanálu. Tady budete postupovat podle stejného vzoru.

Každá fáze konfigurace kanálu používá proměnné k identifikaci instance služby App Service, do které se má nasadit.

Přidání proměnných:

  1. V Azure DevOps přejděte do space game – web – nefunkční testovací projekt.

  2. V části Pipelines (Kanály) vyberte Library (Knihovna).

    Screenshot of Azure Pipelines, showing the Library menu option.

  3. Vyberte + Proměnná skupina.

  4. Jako název skupiny proměnných v části Vlastnosti zadejte Release.

  5. V části Proměnné vyberte + Přidat.

  6. Jako název proměnné zadejte WebAppNameDev. Jako hodnotu zadejte název instance služby App Service, která odpovídá vašemu vývojovému prostředí, například tailspin-space-game-web-dev-1234.

  7. Opakováním kroků 5 a 6 dvakrát vytvořte proměnné pro testovací a přípravná prostředí, jak je znázorněno v této tabulce:

    Název proměnné Příklad hodnoty
    WebAppNameTest tailspin-space-game-web-test-1234
    WebAppNameStaging tailspin-space-game-web-staging-1234

    Nezapomeňte nahradit každou ukázkovou hodnotu instancí služby App Service, která odpovídá vašemu prostředí.

    Důležité

    Ujistěte se, že jste nastavili název instance služby App Service, ne její název hostitele. V tomto příkladu byste zadali tailspin-space-game-web-dev-1234 a ne tailspin-space-game-web-dev-1234.azurewebsites.net.

  8. Pokud chcete uložit proměnnou do kanálu, vyberte Uložit v horní části stránky.

    Vaše skupina proměnných se podobá této:

    Screenshot of Azure Pipelines, showing the variable group. The group contains three variables.

Vytvoření vývojového, testovacího a přípravného prostředí

Ve spuštění funkčních testů v Azure Pipelines jste vytvořili prostředí pro vývojová, testovací a přípravná prostředí. Tady tento proces zopakujete.

Vytvoření vývojového, testovacího a přípravného prostředí:

  1. V Azure Pipelines vyberte Prostředí.

    Screenshot of Azure Pipelines showing the location of the Environments menu option.

  2. Vytvoření vývojového prostředí:

    1. Vyberte Vytvořit prostředí.
    2. V části Název zadejte dev.
    3. Zbývající pole ponechte na výchozích hodnotách.
    4. Vyberte Vytvořit.

  3. Vytvoření testovacího prostředí:

    1. Vraťte se na stránku Prostředí .
    2. Vyberte Nové prostředí.
    3. V části Název zadejte test.
    4. Vyberte Vytvořit.

  4. Vytvoření přípravného prostředí:

    1. Vraťte se na stránku Prostředí .
    2. Vyberte Nové prostředí.
    3. V části Název zadejte přípravný příkaz.
    4. Vyberte Vytvořit.

Vytvoření připojení služby

Tady vytvoříte připojení služby, které službě Azure Pipelines umožní přístup k vašemu předplatnému Azure. Azure Pipelines používá toto připojení služby k nasazení webu do služby App Service. V předchozím modulu jste vytvořili podobné připojení služby.

Důležité

Ujistěte se, že jste přihlášení k webu Azure Portal i k Azure DevOps pod stejným účtem Microsoft.

  1. V Azure DevOps přejděte do space game – web – nefunkční testovací projekt.

  2. V dolním rohu stránky vyberte Nastavení projektu.

  3. V části Pipelines (Kanály) vyberte Service connections (Připojení ke službám).

  4. Vyberte Nové připojení služby a pak zvolte Azure Resource Manager a pak vyberte Další.

  5. V horní části stránky instanční objekt (automatický) Pak vyberte Další.

  6. Vyplňte tato pole:

    Pole Hodnota
    Úroveň oboru Předplatné
    Předplatné Vaše předplatné Azure.
    Skupina prostředků tailspin-space-game-rg
    Název připojení služby Resource Manager - Tailspin - Space Game

    Během tohoto procesu se může zobrazit výzva, abyste se přihlásili ke svému účtu Microsoft.

  7. Ujistěte se, že je vybraná možnost Udělit přístup všem kanálům .

  8. Zvolte Uložit.

    Azure DevOps provede testovací připojení a ověří, že se může připojit k vašemu předplatnému Azure. Pokud se Azure DevOps nemůže připojit, máte možnost se přihlásit podruhé.