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

Dokončeno

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

K dosažení těchto cílů:

• Přidejte uživatele, aby se Azure DevOps mohl 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á .
• Ujistěte se, že je projekt nastavený místně, abyste mohli odesílat změny do kanálu.
• Pomocí Azure CLI v Azure Cloud Shellu vytvořte aplikaci Aplikace Azure Service a Azure Functions.
• Vytvořte proměnné kanálu, které definují názvy vaší služby App Service a instance Azure Functions.
• Vytvořte připojení služby, které umožňuje službě Azure Pipelines bezpečně přistupovat 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, toto cvičení používá Azure DevOps k nasazení do prostředků Azure ve vašem předplatném Azure. Pokud chcete tento proces zjednodušit, přihlaste se ke svému předplatnému Azure i k organizaci Azure DevOps pomocí stejného účtu Microsoft.

Důležité

Pokud se přihlásíte pomocí různých účtů, měli byste přidat uživatele do vaší organizace DevOps pod účtem Microsoft, který používáte k přihlášení do 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 přihlaste se pomocí nového uživatelského účtu. Použijte účet Microsoft, který používáte k přihlášení k předplatnému Azure.

Získání projektu Azure DevOps

Ujistěte se, že je vaše organizace Azure DevOps nastavená tak, aby dokončila zbytek tohoto modulu. Uděláte to tak, že spustíte šablonu, která vytvoří projekt v Azure DevOps.

Moduly v tomto studijním programu tvoří průběh při sledování webového týmu Tailspin prostřednictvím své cesty DevOps. Pro účely výuky má každý modul svůj vlastní projekt Azure DevOps.

Spustit šablonu

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

   Spustit šablonu

2. Na webu Azure DevOps Demo Generator vyberte Přihlásit se. Pokud se zobrazí výzva, přijměte podmínky použití. Zobrazí se stránka Vytvořit nový projekt .

3. Na stránce Vytvořit nový projekt zadejte název projektu, například Space Game – web – Azure Functions, a pak v části Vybrat organizaci vyberte organizaci, kterou používáte pro předplatné Azure.

   

4. V další části vyberte Ano, chci vytvořit fork tohoto úložiště a pak vybrat Autorizovat.

   Pokud se zobrazí okno, autorizujte přístup k vašemu účtu GitHub.

   Důležité

   Povolení této možnosti forku je nezbytné, aby se šablona připojila k úložišti GitHub. Vyberte ho i v případě, že jste už rozvětvovali projekt webu Space Game . Šablona použije existující fork.

5. Vyberte Vytvořit projekt.

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

6. Po úspěšném zřízení projektu vyberte Přejít k projektu a přejděte do projektu v Azure DevOps.

Důležité

Stránka Vyčistit prostředí Azure DevOps v tomto modulu obsahuje důležité kroky , které musíte dokončit, i když tento modul nedokončíte. Vyčištěním pomůžete zajistit, abyste nevyčerpali bezplatné minuty sestavení.

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ší:

• Použití soukromých a veřejných projektů
• Rychlý start: Nastavení privátního projektu jako veřejného
• Nastavení viditelnosti úložiště

Přiřazení pracovní položky a jeho přesunutí do stavu Provádění

Tady přiřadíte pracovní položku sami sobě ve službě Azure Boards a nastavíte stav pracovní položky na Hodnotu Probíhá. V praxi byste vy a váš tým vytvořili pracovní položky na začátku každého sprintu nebo iterace práce.

Toto cvičení vytvoří kontrolní seznam, ze kterého se má pracovat. Umožňuje ostatním členům týmu zjistit, na čem pracujete a kolik práce zbývá. Pracovní položka také pomáhá vynucovat limity probíhající práce (WIP), aby tým najednou nepřebíhal příliš mnoho práce.

1. V Azure DevOps přejděte do kategorie Boards a pak v nabídce vyberte Boards .

   

2. Výběrem názvu otevřete rozhraní API pro tabulku výsledků refaktoringu jako pracovní položku funkce Azure Functions. Tuto pracovní položku přiřaďte sami sobě a pak vyberte Uložit a zavřít.

3. Vyberte šipku dolů v dolní části karty a vyberte Kartu a přetáhněte ji do sloupce Probíhá.

   

4. Pracovní položka se přesune ze sloupce Úkol do sloupce Probíhá .

   

Na konci tohoto modulu po dokončení úkolu přesunete kartu do sloupce Hotovo .

Vytvoření prostředí Aplikace Azure Service a Azure Functions

Tady vytvoříte aplikaci App Service a Azure Functions potřebnou k nasazení nové verze webu a rozhraní API.

V modulu Vytvoření kanálu verze pomocí azure Pipelines Learn jste službu App Service vytvořili prostřednictvím webu Azure Portal. I když je portál skvělým způsobem, jak prozkoumat, co je dostupné v Azure nebo provádět základní úlohy, může být zdlouhavé vyvolání komponent, jako je App Service.

V tomto modulu použijete Azure CLI k vyvolání instance služby App Service. Azure CLI je dostupné z terminálu nebo přes Visual Studio Code. Tady budeme přistupovat k Azure CLI z Azure Cloud Shellu. Toto příkazové prostředí v prohlížeči je hostované v cloudu. Azure CLI je v Cloud Shellu nakonfigurováno pro použití s vaším předplatným Azure.

Důležité

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řihlaste se k portálu Azure.

2. V globálních ovládacích prvcích v záhlaví stránky vyberte Cloud Shell.

   

   Otevře se terminál a připojí se k Azure Cloud Shellu.

3. V případě potřeby vyberte Bash z nabídky terminálu.

   Poznámka:

   Cloud Shell vyžaduje, aby prostředek úložiště Azure uchovával všechny soubory, které vytvoříte v Cloud Shellu. Při prvním otevření Cloud Shellu se zobrazí výzva k vytvoření skupiny prostředků, účtu úložiště a sdílené složky Azure Files. Toto nastavení se automaticky použije pro všechny budoucí relace Cloud Shellu.

Výběr oblasti Azure

Oblast je jedno nebo více datacenter Azure v rámci geografického umístění. Příklady oblastí jsou Východní USA, Západní USA a Severní Evropa. Každému prostředku Azure, včetně instance služby App Service, je přiřazena oblast.

Abychom usnadnili spouštění příkazů, začněme nastavením výchozí oblasti. Jakmile zadáte výchozí oblast, příkazy, které zadáte, použijí tuto oblast, dokud nezadáte jinou oblast.

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. Name Ve sloupci ve výstupu 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. Nahraďte <REGION> názvem oblasti, kterou jste zvolili.

   az configure --defaults location=<REGION>
   

   Tento příklad nastaví westus2 jako výchozí oblast:

   az configure --defaults location=westus2
   

Vytvoření proměnných Bash

V této části vytvoříte proměnné Bash, aby byl proces nastavení pohodlnější a méně náchylný k chybám. Použití proměnných pro sdílené textové řetězce pomáhá vyhnout se náhodným překlepům.

1. V Cloud Shellu vygenerujte náhodné číslo, které použijeme k vytvoření globálně jedinečných názvů pro určité služby v dalším kroku.

   resourceSuffix=$RANDOM
   

2. Vytvořte tři globálně jedinečné názvy pro účty služby App Service, Funkce Azure a úložiště. Tyto příkazy používají dvojité uvozovky, které dávají Bash pokyn k překladu proměnných pomocí vložené syntaxe.

   webName="tailspin-space-game-web-${resourceSuffix}"
   leaderboardName="tailspin-space-game-leaderboard-${resourceSuffix}"
   storageName="tailspinspacegame${resourceSuffix}"
   

3. Vytvořte dvě další proměnné Bash pro uložení názvů vaší skupiny prostředků a plánu služby.

   rgName='tailspin-space-game-rg'
   planName='tailspin-space-game-asp'
   

Vytvoření požadovaných prostředků Azure

Naše řešení vyžaduje pro nasazení několik prostředků Azure, které teď vytvoříme.

Poznámka:

Toto cvičení používá výchozí nastavení sítě, aby byla vaše lokalita přístupná z internetu. V praxi můžete nakonfigurovat virtuální síť Azure tak, aby váš web umístil do sítě, ke které máte přístup jenom vy a váš tým. Později můžete virtuální síť překonfigurovat tak, aby byl web dostupný vašim uživatelům.

1. Spuštěním následujícího az group create příkazu vytvořte skupinu prostředků s použitím názvu definovaného dříve:

   az group create --name $rgName
   

2. Spuštěním následujícího az appservice plan create příkazu vytvořte plán služby App Service s použitím názvu definovaného v předchozí úloze:

   az appservice plan create \
     --name $planName \
     --resource-group $rgName \
     --sku B1 \
     --is-linux
   

   Parametr --sku určuje plán B1. Tento plán běží na úrovni Basic. Parametr --is-linux určuje linuxové pracovní procesy (vlákna použitá v událostech a plánování úkolů).

   Důležité

   Pokud skladová položka B1 není ve vašem předplatném Azure dostupná, zvolte jiný plán, například S1 (Standard).

3. Spuštěním následujícího az webapp create příkazu vytvořte instanci služby App Service:

   az webapp create \
     --name $webName \
     --resource-group $rgName \
     --plan $planName \
     --runtime "DOTNETCORE|6.0"
   

4. Azure Functions vyžaduje účet úložiště pro nasazení. Spuštěním následujícího az storage account create příkazu ho vytvořte:

   az storage account create \
     --name $storageName \
     --resource-group $rgName \
     --sku Standard_LRS
   

5. Spuštěním následujícího az functionapp create příkazu vytvořte instanci aplikace Azure Functions. <region> Nahraďte upřednostňovanou oblast.

   az functionapp create \
     --name $leaderboardName \
     --resource-group $rgName \
     --storage-account $storageName \
     --functions-version 4 \
     --consumption-plan-location <region>
   

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

   az webapp list \
     --resource-group $rgName \
     --query "[].{hostName: defaultHostName, state: state}" \
     --output table
   

   Poznamenejte si název hostitele vaší spuštěné služby. Měl by vypadat podobně jako v následujícím příkladu, ale identifikátor náhodného čísla se bude lišit. Po ověření práce budete později potřebovat název webového hostitele.

   HostName                                        State
   ----------------------------------------------  -------
   tailspin-space-game-web-4692.azurewebsites.net  Running
   

7. Spuštěním následujícího az functionapp list příkazu vypíšete název hostitele a stav instance Azure Functions.

   az functionapp list \
     --resource-group $rgName \
     --query "[].{hostName: defaultHostName, state: state}" \
     --output table
   

   Poznamenejte si název hostitele vaší spuštěné služby. Měl by vypadat podobně jako v následujícím příkladu, ale identifikátor náhodného čísla se bude lišit. Po ověření práce budete později potřebovat název hostitele tabulky výsledků.

   HostName                                                State
   ------------------------------------------------------  -------
   tailspin-space-game-leaderboard-4692.azurewebsites.net  Running
   

8. Zkopírujte tyto dva názvy hostitelů do umístění, ke které budete mít snadný přístup později.

9. Jako volitelný krok otevřete prohlížeč a zadejte název hostitele, abyste ověřili, že je spuštěný. Zobrazí se výchozí domovská stránka.

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. Postup pro vyčištění proveďte i v případě, že tento modul nedokončíte.

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

V modulu Vytvořit kanál verze pomocí modulu Azure Pipelines jste do kanálu přidali proměnnou, která ukládá název vaší webové aplikace ve službě App Service. Tady to uděláte stejně. Kromě toho přidáte název aplikace tabulky výsledků pro instanci Azure Functions.

Tyto názvy můžete pevně zakódovat v konfiguraci kanálu, ale pokud je definujete jako proměnné, bude vaše konfigurace opakovaně použitelná. Navíc, pokud se změní názvy instancí, můžete aktualizovat proměnné a aktivovat kanál beze změny konfigurace.

Pojďme do projektu přidat skupinu proměnných.

1. Váš space game – web – projekt Azure Functions by měl být otevřený v Azure DevOps.

2. V nabídce vyberte Kanály a potom v části Kanály vyberte Knihovna. Zobrazí se podokno Knihovna.

   

3. Na panelu příkazů nebo uprostřed podokna vyberte skupinu proměnných. Zobrazí se stránka Nová skupina proměnných.

4. Jako název skupiny proměnných zadejte Release.

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

6. Jako název proměnné zadejte Název webové aplikace. Jako hodnotu zadejte název instance služby App Service, která byla vytvořena pro vaši webovou aplikaci, například tailspin-space-game-web-4692.

   Důležité

   Nastavte název instance služby App Service, nikoli úplný název hostitele. V tomto cvičení je například část názvu hostitele tailspin-space-game-web-4692.azurewebsites.net tailspin-space-game-web-4692.

7. Přidejte další proměnnou s názvem LeaderboardAppName s hodnotou vaší instance tabulky výsledků, například tailspin-space-game-leaderboard-4692.

8. Přidejte konečnou proměnnou s názvem ResourceGroupName s hodnotou tailspin-space-game-rg.

9. Na panelu příkazů v horní části stránky vyberte Uložit a uložte skupinu proměnných verze do kanálu.

   Proměnné ve vaší skupině proměnných by měly být podobné:

   

Vytvoření prostředí špičky

V předchozíchmodulech Tady to uděláte stejně. Tentokrát vytvoříte prostředí s názvem špička.

1. V nabídce Azure DevOps v části Pipelines (Kanály) vyberte Environment (Prostředí).

   

2. Vyberte Vytvořit prostředí. Zobrazí se podokno Nové prostředí .

3. Do pole Název zadejte špičku.

4. Zbývající pole ponechte na výchozích hodnotách.

5. 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 , Space Game – web – projekt kanálu Azure Functions , pod nabídkou vyberte Nastavení projektu. Zobrazí se podokno podrobností projektu.

2. V nabídce v části Kanály vyberte Připojení služeb.

3. Na stránce Připojení služby vyberte Nové připojení služby a potom v podokně Připojení k nové službě vyberte Azure Resource Manager a pak vyberte Další.

4. V podokně Nové připojení služby vyberte Instanční objekt (automatický) a pak vyberte Další.

5. V podokně Připojení k nové službě Azure vyberte nebo zadejte následující nastavení:

   Pole	Hodnota
   Úroveň oboru	Předplatné
   Předplatné	Vybrat 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.

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

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