Editor kanálů YAML

  • Článek

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Služba Azure Pipelines obsahuje editor kanálů YAML, který můžete použít k vytváření a úpravám kanálů. Editor YAML je založený na editoru Monaco. Součástí editoru jsou nástroje, jako je podpora IntelliSense a pomocník s úlohami, které vám pomáhají při úpravách kanálu.

V tomto článku se dozvíte, jak upravovat kanály pomocí editoru kanálů YAML, ale kanály můžete upravovat také úpravou souboru azure-pipelines.yml přímo v úložišti kanálu pomocí libovolného textového editoru nebo pomocí nástroje, jako je Visual Studio Code a rozšíření Azure Pipelines for VS Code .

Důležité

Editor kanálů YAML byl představen v Azure DevOps Serveru 2019 Update 1. Pokud používáte Azure DevOps Server 2019 RTW, editor kanálů YAML popsaný v tomto článku není k dispozici, ale můžete upravit YAML pomocí textového editoru podle vašeho výběru a zkontrolovat ho v úložišti kanálu.

Úprava kanálu YAML

Pokud chcete získat přístup k editoru kanálů YAML, proveďte následující kroky.

  1. Přihlaste se ke své organizaci (https://dev.azure.com/{yourorganization}).

  2. Vyberte projekt, zvolte Pipelines Pipelines> a pak vyberte kanál, který chcete upravit.

    Buildy Azure Pipelines v Azure DevOps Serveru 2019 Update 1

  3. Zvolte položku Upravit.

    Tlačítko upravit YAML pro Azure Pipelines v Azure DevOps Serveru 2019 Update 1

  4. Upravte kanál pomocí klávesových zkratek IntelliSense a pomocníka s úlohami, kde najdete pokyny.

    Editor kanálů YAML v Azure DevOps Serveru 2019.1

Pokud chcete získat přístup k editoru kanálů YAML, proveďte následující kroky.

  1. Přihlaste se ke své organizaci (https://dev.azure.com/{yourorganization}).

  2. Vyberte projekt, zvolte Kanály a pak vyberte kanál, který chcete upravit. Kanály můžete procházet podle posledních, všech a spuštění. Další informace najdete v tématu zobrazení a správa kanálů.

    Cílová stránka Azure Pipelines

  3. Zvolte položku Upravit.

    Tlačítko pro úpravy YAML v Azure Pipelines

  4. Upravte kanál pomocí IntelliSense a pomocníka s úlohami, kde najdete pokyny.

    Editor kanálů YAML.

  1. Vyberte Uložit. Můžete provést potvrzení přímo do větve nebo vytvořit novou větev a volitelně zahájit žádost o přijetí změn.

    Okno pro uložení editoru kanálů YAML

  1. Zvolte Ověřit a uložit. Můžete provést potvrzení přímo do větve nebo vytvořit novou větev a volitelně zahájit žádost o přijetí změn.

    Snímek obrazovky znázorňující okno ověření a uložení editoru kanálů YAML

Používání klávesových zkratek

Editor kanálů YAML poskytuje několik klávesových zkratek, které si ukážeme v následujících příkladech.

  • Při úpravách kanálu YAML zvolte mezerník Ctrl+pro podporu IntelliSense.

    Intellisense editoru kanálů YAML

  • Zvolte F1 (Fn+F1 na Macu) a zobrazte paletu příkazů a zobrazte dostupné klávesové zkratky.

    Paleta příkazů editoru kanálů YAML

Použití pomocníka pro úkoly

Pomocník úloh poskytuje metodu pro přidávání úkolů do kanálu YAML.

  • Pokud chcete zobrazit asistenta úloh, upravte kanál YAML a zvolte Zobrazit asistenta.

    Show ask assistant for editing YAML pipelines.

  • Pokud chcete pomocníka s úkolem skrýt, zvolte Skrýt asistenta.

    Skryjte pomocníka úloh pro úpravy kanálů YAML.

  • Pokud chcete použít pomocníka s úlohami, procházejte nebo hledejte úkoly v podokně Úkoly .

    Hledání pomocníka s úkoly

  • Vyberte požadovanou úlohu a nakonfigurujte její vstupy.

    Přidejte pomocníka pro úkoly.

  • Zvolte Přidat , aby se úloha YAML vložil do kanálu.

Pomocník pro úlohy přidaný v Azure DevOps Serveru 2019

  • Upravte vložený YAML, aby se v úloze změnily další změny konfigurace.

Přidán pomocník pro úkoly.

  • YAML můžete upravit, aby se v úloze změnily další změny konfigurace, nebo můžete zvolit Nastavení nad úkolem v editoru kanálů YAML a nakonfigurovat vloženou úlohu v pomocníkovi úloh.

Ověřit

Ověřte změny a zachyťte chyby syntaxe v kanálu, které brání jeho spuštění. Zvolte Ověřit další akce>.

Ověřte a stáhněte si úplný YAML.

Azure Pipelines ověří vaše kanály pokaždé, když ušetříte. Před uložením zvolte Ověřit a uložit a ověřte kanál. Pokud dojde k nějakým chybám, můžete přesto zrušit nebo uložit. Pokud chcete kanál uložit bez ověření, zvolte Uložit bez ověření.

Snímek obrazovky s tlačítkem Ověřit a uložit

Azure Pipelines detekuje nesprávné definice proměnných definované na úrovni kanálu, fáze a úlohy a detekuje nesprávné podmínky YAML definované na úrovni kanálu, fáze a úlohy.

Stáhnout úplné YAML

Můžete zobrazit náhled plně analyzovaného dokumentu YAML bez potvrzení nebo spuštění kanálu. Zvolte Další akce>Stáhnout úplné YAML.

Ověřte a stáhněte si úplný YAML.

Stáhněte si úplný YAML, spustí rozhraní AZURE DevOps REST API pro Azure Pipelines a zahájí stažení vykresleného YAML z editoru.

Správa proměnných kanálu

Proměnné kanálu můžete spravovat jak z kanálu YAML, tak z uživatelského rozhraní nastavení kanálu.

S azure DevOps 2019 Update 1 můžete spravovat proměnné kanálu pomocí uživatelského rozhraní nastavení kanálu.

Pokud chcete spravovat proměnné kanálu, proveďte následující kroky.

  1. Upravte kanál YAML a zvolte Proměnné pro správu proměnných kanálu.

    Tlačítko Spravovat proměnné kanálu

  2. Vyberte si z následujících funkcí:

    • Nová proměnná: přidání první proměnné.
    • Přidat : pro přidání následných proměnných.
    • Název proměnné pro úpravu proměnné
    • Odstranit : k odstranění proměnné.

    Správa proměnných kanálu v editoru YAML

Pokud chcete spravovat proměnné kanálů v uživatelském rozhraní nastavení kanálu, proveďte následující kroky.

  1. Upravte kanál a zvolte Triggery dalších akcí>.

    Nabídka uživatelského rozhraní nastavení kanálu

  2. Zvolte proměnné.

    Uživatelské rozhraní nastavení kanálu pro proměnné

Další informace o práci s proměnnými kanálu najdete v tématu Definování proměnných.

Konfigurace výchozího fondu agentů

Pokud kanál YAML nezadává fond agentů, použije se fond agentů nakonfigurovaný ve výchozím fondu agentů pro nastavení YAML . Tento fond se také používá pro úlohy čištění po spuštění.

Zobrazení a konfigurace výchozího fondu agentů pro nastavení YAML :

  1. Upravte kanál a zvolte Triggery dalších akcí>.

    Snímek obrazovky s nabídkou uživatelského rozhraní nastavení kanálu

  2. Zvolte YAML a vyberte požadovaný fond agentů pomocí výchozího fondu agentů pro rozevírací seznam YAML .

    Snímek obrazovky s výchozím fondem agentů pro kanály YAML

Výchozí fond agentů pro YAML je nakonfigurovaný pro jednotlivé kanály.

Správa nastavení pomocí uživatelského rozhraní nastavení kanálu

Některá nastavení kanálu YAML se konfigurují pomocí uživatelského rozhraní nastavení kanálu místo v souboru YAML.

  1. Upravte kanál a zvolte Triggery dalších akcí>.

    Snímek obrazovky s nabídkou uživatelského rozhraní nastavení kanálu

  2. V uživatelském rozhraní nastavení kanálu zvolte kartu nastavení, které chcete nakonfigurovat.

    Snímek obrazovky s uživatelským rozhraním nastavení kanálu pro triggery

Zobrazení a úpravy šablon

Poznámka:

Tato funkce je dostupná od Azure DevOps Serveru 2022.1.

Šablony jsou běžně používanou funkcí v kanálech YAML. Představují snadný způsob sdílení fragmentů kódu kanálu a představují výkonný mechanismus pro ověřování a vynucování zabezpečení a zásad správného řízení ve vašem kanálu. Dříve editor nepodporuje šablony, takže autoři kanálů YAML nemohli získat pomoc s intellisense. Azure Pipelines teď podporuje editor YAML, pro který podporujeme náhled. Pokud chcete tuto verzi Preview povolit, přejděte do funkcí preview ve vaší organizaci Azure DevOps a povolte editor šablon YAML.

Důležité

Tato funkce má následující omezení.

  • Pokud šablona obsahuje požadované parametry, které nejsou zadané jako vstupy v hlavním souboru YAML, ověření selže a vyzve vás k zadání těchto vstupů.

  • V editoru nemůžete vytvořit novou šablonu. Můžete použít nebo upravit pouze existující šablony.

Při úpravách hlavního souboru YAML služby Azure Pipelines můžete šablonu zahrnout nebo rozšířit . Při zadávání názvu šablony se může zobrazit výzva k ověření šablony. Po ověření rozumí editor YAML schématu šablony včetně vstupních parametrů.

Šablona YAML.

Po ověření můžete přejít do šablony tak, že zvolíte Zobrazit šablonu, která šablonu otevře na nové kartě prohlížeče. V šabloně můžete provádět změny pomocí všech funkcí editoru YAML.

Další kroky

Přizpůsobení kanálu