Cvičení – vytvoření a spuštění základního kanálu

  • 7 min

Důležité

K provedení tohoto cvičení potřebujete vlastní předplatné Azure a mohou se vám účtovat poplatky. Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet, než začnete.

Chcete automatizovat nasazení aktualizací na web vaší společnosti. Jako první krok vytvoříte základní kanál v Azure DevOps.

V tomto cvičení:

  • Vytvořte organizaci a projekt Azure DevOps.
  • Vytvořte základní kanál.
  • Spusťte svůj základní kanál.

Vytvoření projektu v Azure DevOps

  1. V prohlížeči přejděte na dev.azure.com. Přihlaste se nebo vytvořte nový účet.

  2. Pokud jste vytvořili nový účet, postupujte podle pokynů k vytvoření organizace Azure DevOps. Azure DevOps vás pak vyzve k vytvoření nového projektu. Pokračujte dalším krokem a nastavte projekt.

    Pokud jste se přihlásili k existující organizaci Azure DevOps, vyberte Nový projekt a vytvořte nový projekt.

    Snímek obrazovky Azure DevOps se zvýrazněným tlačítkem Nový projekt

  3. V podokně Vytvořit projekt, abyste mohli začít, zadejte následující podrobnosti pro nový projekt:

    • Název projektu: Použijte smysluplný, ale krátký název. Pro účely tohoto cvičení zadejte web toy-website.
    • Popis: Zadejte popis účelu projektu. V tomto cvičení zadejte web společnosti Toy.
    • Viditelnost: K vytvoření veřejných a privátních úložišť můžete použít Azure DevOps. V takovém případě by úložiště mělo být soukromé, protože k souborům webu vaší společnosti by měli přistupovat jenom lidé ve vaší organizaci. Přístup můžete udělit dalším uživatelům později.

    Konfigurace projektu by měla vypadat jako v tomto příkladu:

    Snímek obrazovky Azure DevOps – Vytvoření projektu pro začátek se zvýrazněnými možnostmi názvu projektu a viditelnosti

  4. Vyberte příkaz Vytvořit projekt.

Klonování úložiště

  1. V uvítacím podokně nebo v nabídce prostředků vyberte Úložiště.

    Snímek obrazovky s úvodním podoknem se zvýrazněnými ikonami Úložiště v podokně a v nabídce prostředků

  2. Pokud používáte macOS, potřebujete k klonování úložiště Git speciální heslo. Vyberte Vygenerovat přihlašovací údaje Gitu a zkopírujte uživatelské jméno a heslo zobrazené na bezpečné místo.

  3. V části Clone to your computer (Klonovat do počítače) vyberte Clone in VS Code (Klonovat v nástroji VS Code). Pokud se zobrazí výzva k povolení otevření editoru Visual Studio Code, vyberte Otevřít.

    Snímek obrazovky zobrazující nastavení úložiště se zvýrazněným tlačítkem Clone in VS Code

  4. Pokud se zobrazí dialogové okno, zobrazí se výzva, abyste rozšíření povolili otevření identifikátoru URI úložiště, vyberte Otevřít.

  5. Na místním zařízení vytvořte složku, která se má použít pro toto úložiště, a pak vyberte Vybrat jako umístění úložiště.

  6. Pokud toto úložiště používáte poprvé, zobrazí se výzva k přihlášení.

    V případě Windows zadejte stejné přihlašovací údaje, které jste použili k přihlášení k Azure DevOps dříve v tomto cvičení.

    V případě macOS zadejte uživatelské jméno a heslo Gitu, které jste vygenerovali před pár okamžiky.

  7. Visual Studio Code vás vyzve k otevření úložiště. Vyberte Otevřít.

    Snímek obrazovky s dialogovým oknem editoru Visual Studio Code pro otevření klonovaného úložiště se zvýrazněným tlačítkem Otevřít

Instalace rozšíření Azure Pipelines

Microsoft publikuje rozšíření Azure Pipelines pro Visual Studio Code. Rozšíření vám může pomoct psát soubory YAML kanálu. Je vhodné nainstalovat toto rozšíření, takže se soubory YAML ověřují při práci.

  1. V editoru Visual Studio Code vyberte Zobrazit>rozšíření (zkratka je Ctrl+Shift+x).

  2. Do vyhledávacího pole zadejte Azure Pipelines a pak vyberte rozšíření Azure Pipelines publikované Microsoftem. Vyberte volbu Instalovat.

    Snímek obrazovky s nabídkou Rozšíření editoru Visual Studio Code s rozšířením Azure Pipelines od Microsoftu a zvýrazněným tlačítkem Nainstalovat

Vytvoření definice kanálu YAML

Teď, když jste vytvořili organizaci, projekt a úložiště, jste připraveni vytvořit základní definici kanálu.

  1. V editoru Visual Studio Code otevřete Průzkumníka.

  2. V Průzkumníku najeďte myší na složku projektu TOY-WEBSITE a vyberte ikonu Nová složka . Pojmenujte ji.

  3. Vyberte složku deploy a v projektu TOY-WEBSITE vyberte ikonu Nový soubor. Pojmenujte tento soubor azure-pipelines.yml.

    Snímek obrazovky Průzkumníka editoru Visual Studio Code zobrazující složku nasazení a soubor azure-pipelines dot Y M L, který byl právě vytvořen

  4. Soubor YML je otevřen na hlavním panelu. Do souboru vložte následující kód definice kanálu:

    trigger: none

pool:
  vmImage: ubuntu-latest

jobs:
- job:
  steps:
  - script: echo Hello world!
    displayName: 'Placeholder step'

  5. Uložte změny souboru.

  6. Výběrem možnosti Terminálový>nový terminál otevřete okno terminálu editoru Visual Studio Code.

    Otevře se okno terminálu, obvykle v dolní polovině obrazovky.

  7. Pokud chcete potvrdit a odeslat soubor azure-pipelines.yml do úložiště Git, vložte tento kód na panel terminálu a stiskněte Enter.

    git add deploy/azure-pipelines.yml
git commit -m "Add initial pipeline definition"
git push

Nastavení kanálu v Azure Pipelines

Vytvořili jste definici kanálu. V dalším kroku zaregistrujte kanál ve službě Azure Pipelines.

  1. V nabídce prostředků relace Azure DevOps vyberte Kanály a v podokně Vytvořit první kanál vyberte Vytvořit kanál.

    Snímek obrazovky s vytvořením prvního podokna kanálu se zvýrazněným tlačítkem Vytvořit kanál v nabídce prostředků

  2. Na kartě Připojení je podokno Kde je váš kód? vyberte Git Azure Repos.

    Snímek obrazovky s podoknem Kde je váš kód a vybranou možností Git Azure Repos

  3. Na kartě Vybrat vyberte podokno Vybrat úložiště a vyberte toy-website.

    Snímek obrazovky znázorňující kartu Konfigurace kanálu s vybraným úložištěm toy-website

  4. Na kartě Konfigurace podokna Konfigurovat kanál vyberte Existující soubor YAML služby Azure Pipelines.

    Snímek obrazovky znázorňující zvýrazněnou možnost Existující soubor YAML služby Azure Pipelines

  5. V rozevíracím seznamu Cesta k existujícímu podoknu souborů YAML vyberte /deploy/azure-pipelines.yml a pak vyberte Pokračovat.

    Snímek obrazovky Azure DevOps s podoknem Vybrat existující soubor YAML s cestou nastavenou na soubor kanálu a zvýrazněným tlačítkem Pokračovat

    V podokně Kontrola kanálu YAML na kartě Revize se zobrazuje definice kanálu YAML jako nový kanál.

    Tip

    Webové rozhraní Azure Pipelines poskytuje editor, který můžete použít ke správě definice kanálu. V tomto modulu pracujete s definičním souborem v editoru Visual Studio Code, ale můžete prozkoumat editor Azure Pipelines a podívat se, jak funguje.

  6. Vyberte Spustit.

    Snímek obrazovky znázorňující krok Revize toku vytvořit kanál se zvýrazněným tlačítkem Spustit

    Azure Pipelines vytvoří kanál a spustí první spuštění.

Ověření spuštění kanálu

Důležité

Pokud používáte kanály v této organizaci Azure DevOps poprvé, může se zobrazit chybová zpráva:

Nebyl zakoupen ani udělen žádný hostovaný paralelismus.

Aby bylo možné chránit před zneužitím, Azure DevOps vyžaduje, aby nové organizace byly schváleny dříve, než budou moct používat agenty kanálu hostované Microsoftem bez poplatků.

Pokud chcete požádat, aby vaše organizace Azure DevOps získala přístup k bezplatným agentům kanálů, vyplňte tento formulář.

  1. Po spuštění kanálu se na stránce zobrazí informace o spuštění.

    Snímek obrazovky znázorňující kanál s úlohou ve stavu ve frontě

    Každé spuštění kanálu obsahuje identifikátor. Tento identifikátor můžete použít k vyhledání konkrétního spuštění kanálu.

    Stav úlohy se zpočátku zobrazí jako zařazený do fronty. Kanál se nemusí spustit okamžitě. Vaše úloha se přidá do fronty pro agenta. Pokud je agent k dispozici, Azure Pipelines přiřadí agenta a spustí úlohu. Stav úlohy se pak změní na Spuštěno.

    Stránka obsahuje název větve a identifikátor potvrzení gitu použitého spuštění. Tyto informace označují verzi obsahu úložiště, který kanál použil.

  2. Aktualizujte stránku, dokud se stav úlohy nezmění na Úspěch. Potom v části Úlohy vyberte Job (Úloha).

    Snímek obrazovky znázorňující kanál se zvýrazněným názvem úlohy se stavem Úspěch a názvem úlohy

  3. Na stránce s informacemi o úloze se zobrazí protokol kroků, které kanál spustil. Váš zástupný krok je uvedený v krocích v nabídce vlevo.

    Snímek obrazovky znázorňující protokol úlohy kanálu se zvýrazněným krokem Zástupný symbol

    Seznam kroků v úloze obsahuje kroky, které jste nevytvořili. Tyto kroky se automaticky vytvářejí službou Azure Pipelines. V některých organizacích se také můžou zobrazit kroky, které vaše organizace automaticky zahrne do všech svých kanálů. Pokud chcete zobrazit soubor protokolu tohoto kroku, můžete vybrat libovolný krok.

  4. Vyberte website@main Checkout toy-toy-s.

    Snímek obrazovky znázorňující protokol úlohy kanálu se zvýrazněným krokem Rezervovat

    Protokol pro každý krok poskytuje podrobnosti o tom, co se stalo během spuštění kanálu. Informace protokolu jsou užitečné, pokud potřebujete diagnostikovat problém s kanálem. Nemáte přímý přístup k agentovi, který provedl váš postup.

    V tomto případě se obsah úložiště stáhl z Azure Repos do systému souborů agenta.

  5. Vyberte zástupný krok.

    Snímek obrazovky znázorňující protokol úlohy kanálu se zvýrazněným krokem Zástupný krok a zobrazenými podrobnostmi

    Protokol pro tento krok obsahuje obsah skriptu, který jste vytvořili v souboru YAML kanálu, a Hello world! textový výstup ze spuštění skriptu.

Je dobré pochopit, jak křížově odkazovat na spuštění kanálu na potvrzení, že spuštění obsahovalo. Propojení spuštění kanálu s potvrzením vám může pomoct sledovat historii nasazení a diagnostikovat problémy. Azure DevOps nabízí několik způsobů propojení spuštění kanálu s potvrzením. V tomto postupu ručně zkontrolujete historii potvrzení.

  1. Pokud se chcete vrátit do přehledu úložiště, v nabídce prostředků DevOps vyberte >.

    Snímek obrazovky znázorňující podokno potvrzení se zvýrazněným identifikátorem potvrzení a úspěšným stavem

    Identifikátor potvrzení je stejný jako identifikátor potvrzení, který jste si poznamenali při spuštění kanálu. Azure Pipelines také zobrazuje stav spuštění kanálu přidruženého k potvrzení.

  2. Vyberte potvrzení. Seznam souborů, které byly změněny, a změny z potvrzení se zobrazí zeleně, označený veškerý text je nový.