Sdílet prostřednictvím

Správa kanálů pomocí Azure DevOps CLI

  • Článek

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

Tento článek popisuje, jak můžete spravovat existující kanály v projektu Azure DevOps pomocí následujících příkazů az pipelines :

Poznámka:

Rozšíření Azure DevOps CLI je dostupné jenom pro Azure DevOps Services a nepodporuje žádnou verzi Azure DevOps Serveru.

Rozšíření CLI pro Azure DevOps

Skupina az-pipelines příkazů je součástí rozšíření DevOps do Azure CLI, které vyžaduje Azure CLI verze 2.30.0 nebo vyšší. Rozšíření Azure DevOps se automaticky nainstaluje při prvním spuštění azure pipelines příkazu. Další informace o tom, jak začít, najdete v tématu Začínáme s Azure DevOps CLI.

V příkazech Azure DevOps CLI můžete také použít globální parametry Azure CLI, například debug, queryoutputhelponly-show-errorsa verbose. . Hodnota table globálního parametru --output představuje výstup v popisné podobě. Další informace najdete v tématu Formáty výstupu pro příkazy Azure CLI.

Výchozí organizaci Azure DevOps pro příkazy Rozhraní příkazového řádku Azure DevOps můžete nastavit pomocí parametru az devops configure --defaults organization=<YourOrganizationURL>nebo pomocí parametru --detect true automaticky zjistit organizaci. Výchozí projekt Azure DevOps můžete nakonfigurovat pomocí .az devops configure -d project=<Project Name or ID>

Pokud nerozpoznáte organizaci nebo nakonfigurujete výchozí organizaci nebo projekt nebo ji vyberete prostřednictvím git config, musíte zadat parametry a project parametry org v každém příkazu.

Výpis existujících kanálů

Příkazy run, showa updatedelete kanál vyžadují name kanál, který id chcete spravovat. Pokud použijete idparametr, name bude ignorován. Pokud chcete získat seznam kanálů projektu, včetně jejich ID, použijte příkaz az pipelines list . Seznam výsledků můžete filtrovat nebo formátovat pomocí parametrů.

Například následující příkaz zobrazí seznam kanálů projektu, které mají názvy začínající python*na , ve formátu tabulky.

az pipelines list --name python* --output table

Výstup:

ID    Path    Name                        Status    Default Queue
----  ------  --------------------------  --------  ---------------
17    \       python-sample-vscode-flask  disabled  Azure Pipelines
24    \       python-sample-get-started   enabled   Azure Pipelines

Úplný odkaz na příkaz najdete v tématu az pipelines list.

Zobrazení podrobností kanálu

Pokud chcete zobrazit podrobnosti existujícího kanálu, použijte příkaz az pipelines show . Například následující příkaz zobrazí podrobnosti kanálu s ID parametrem 12a otevře stránku se souhrnem kanálu ve webovém prohlížeči.

az pipelines show --id 12 --open

Úplný odkaz na příkaz najdete v tématu az pipelines show.

Spuštění kanálu

Ke frontě a spuštění existujícího kanálu použijte příkaz az pipelines run . Můžete nastavit parameters a variables použít při spuštění.

Například následující příkaz spustí kanál s name větví myGithubname.pipelines-java pipeline , nastaví hodnotu proměnné var1 pro 100 spuštění a výstupy ve table formátu.

az pipelines run --name myGithubname.pipelines-java --branch pipeline --variables var1=100 --output table

Výstup:

Run ID    Number      Status      Result    Pipeline ID    Pipeline Name                Source Branch    Queued Time                 Reason
--------  ----------  ----------  --------  -------------  ---------------------------  ---------------  --------------------------  --------
123       20200123.2  notStarted            12             myGithubname.pipelines-java  pipeline         2020-01-23 11:55:56.633450  manual

Úplný odkaz na příkaz najdete v tématu az pipelines run.

Aktualizace kanálu

Pokud chcete aktualizovat existující kanál, použijte příkaz az pipelines update . Například následující příkaz aktualizuje kanál novým názvem a popisem id 12 a výstupem výsledku ve formátu tabulky.

az pipelines update --id 12 --description "rename pipeline" --new-name updatedname.pipelines-java --output table

Výstup:

ID    Name                        Status    Default Queue
----  --------------------------  --------  ------------------
12    updatedname.pipelines-java  enabled   Hosted Ubuntu 1604

Úplný odkaz na příkaz najdete v tématu az pipelines update.

Odstranění kanálu

Pokud chcete odstranit kanál, spusťte příkaz az-pipelines-delete . Následující příkaz například odstraní kanál s ID 12a nezobrazí výzvu k potvrzení. Pokud parametr nezadáte --yes , příkazový řádek ve výchozím nastavení zobrazí výzvu k potvrzení.

az pipelines delete --id 12 --yes

Úplný odkaz na příkaz najdete v tématu az pipelines delete.

Programové vytváření a konfigurace kanálů

Pokud chcete k vytvoření kanálu YAML použít Azure DevOps CLI, přečtěte si téma az pipelines create. Pokud chcete spouštět příkazy Azure CLI v kanálech YAML, podívejte se na Azure DevOps CLI v Azure Pipelines YAML.

Kanály YAML můžete vytvářet, konfigurovat, testovat a nasazovat aplikace v jazyce podle vašeho výběru. Další informace najdete v následujících článcích:

Azure DevOps Services REST API

Pomocí rozhraní REST API můžete vytvářet vlastní aplikace nebo služby, které se integrují s Azure DevOps, a provádět přímé volání HTTP. Další informace najdete v referenčních informacích k rozhraní REST API služby Azure DevOps Services. Pro tato rozhraní API můžete také použít klientské knihovny .

Přeskočení fáze spuštění kanálu

Pomocí příkazu az rest s rozhraním REST API spuštění kanálu můžete přeskočit fázi spuštění kanálu pomocí parametru stagesToSkip .

Příklad:

az rest --method post `
    --uri https://dev.azure.com/{organization}/{project}/_apis/pipelines/{pipelineId}/runs?api-version=7.1-preview.1 `
    --body "{'stagesToSkip': [''], 'resources': {'repositories': {'self': {'refName': 'refs/heads/{branch}'}}}}" `
    --resource 499b84ac-1321-427f-aa17-267ca6975798

Další informace najdete v tématu Použití rozhraní Azure REST API s Azure CLI.

Související obsah