az pipelines
Note
Tento odkaz je součástí rozšíření azure-devops pro Azure CLI (verze 2.30.0 nebo vyšší). Rozšíření se automaticky nainstaluje při prvním spuštění příkazu az pipelines . Přečtěte si další informace o rozšířeních.
Správa Služby Azure Pipelines
Tato skupina příkazů je součástí rozšíření azure-devops.
Příkazy
| Name | Description | Typ | Stav |
|---|---|---|---|
| az pipelines agent |
Správa agentů |
Extension | GA |
| az pipelines agent list |
Získejte seznam agentů ve fondu. |
Extension | GA |
| az pipelines agent show |
Zobrazení podrobností agenta |
Extension | GA |
| az pipelines build |
Správa sestavení |
Extension | GA |
| az pipelines build cancel |
Zruší se, pokud je sestavení spuštěné. |
Extension | GA |
| az pipelines build definition |
Správa definic sestavení |
Extension | GA |
| az pipelines build definition list |
Výpis definic sestavení |
Extension | GA |
| az pipelines build definition show |
Získejte podrobnosti o definici sestavení. |
Extension | GA |
| az pipelines build list |
Výpis výsledků sestavení |
Extension | GA |
| az pipelines build queue |
Žádost o sestavení (fronta) |
Extension | GA |
| az pipelines build show |
Získejte podrobnosti o sestavení. |
Extension | GA |
| az pipelines build tag |
Správa značek sestavení |
Extension | GA |
| az pipelines build tag add |
Přidejte značky pro sestavení. |
Extension | GA |
| az pipelines build tag delete |
Odstraňte značku buildu. |
Extension | GA |
| az pipelines build tag list |
Získejte značky pro sestavení. |
Extension | GA |
| az pipelines create |
Vytvoření nového kanálu Azure Pipeline (založeného na YAML) |
Extension | GA |
| az pipelines delete |
Odstranění kanálu |
Extension | GA |
| az pipelines folder |
Správa složek pro uspořádání kanálů |
Extension | GA |
| az pipelines folder create |
Vytvořte složku. |
Extension | GA |
| az pipelines folder delete |
Odstraňte složku. |
Extension | GA |
| az pipelines folder list |
Zobrazí seznam všech složek. |
Extension | GA |
| az pipelines folder update |
Aktualizujte název nebo popis složky. |
Extension | GA |
| az pipelines list |
Vypsat kanály |
Extension | GA |
| az pipelines pool |
Správa fondů agentů |
Extension | GA |
| az pipelines pool list |
Výpis fondů agentů |
Extension | GA |
| az pipelines pool show |
Zobrazení podrobností fondu agentů |
Extension | GA |
| az pipelines queue |
Správa front agentů |
Extension | GA |
| az pipelines queue list |
Výpis front agentů |
Extension | GA |
| az pipelines queue show |
Zobrazení podrobností o frontě agenta |
Extension | GA |
| az pipelines release |
Správa vydaných verzí |
Extension | GA |
| az pipelines release create |
Požádejte (vytvořte) verzi. |
Extension | GA |
| az pipelines release definition |
Správa definic vydaných verzí |
Extension | GA |
| az pipelines release definition list |
Výpis definic vydaných verzí |
Extension | GA |
| az pipelines release definition show |
Získejte podrobnosti o definici verze. |
Extension | GA |
| az pipelines release list |
Vypíše výsledky vydání. |
Extension | GA |
| az pipelines release show |
Získejte podrobnosti o verzi. |
Extension | GA |
| az pipelines run |
Vytvoření fronty (spuštění) kanálu |
Extension | GA |
| az pipelines runs |
Správa spuštění kanálu |
Extension | GA |
| az pipelines runs artifact |
Správa artefaktů spuštění kanálu |
Extension | GA |
| az pipelines runs artifact download |
Stáhněte si artefakt kanálu. |
Extension | GA |
| az pipelines runs artifact list |
Výpis artefaktů přidružených ke spuštění |
Extension | GA |
| az pipelines runs artifact upload |
Nahrajte artefakt kanálu. |
Extension | GA |
| az pipelines runs list |
Zobrazení seznamu spuštění kanálu v projektu |
Extension | GA |
| az pipelines runs show |
Zobrazí podrobnosti o spuštění kanálu. |
Extension | GA |
| az pipelines runs tag |
Správa značek spuštění kanálu |
Extension | GA |
| az pipelines runs tag add |
Přidejte značky pro spuštění kanálu. |
Extension | GA |
| az pipelines runs tag delete |
Odstraňte značku spuštění kanálu. |
Extension | GA |
| az pipelines runs tag list |
Získejte značky pro spuštění kanálu. |
Extension | GA |
| az pipelines show |
Získejte podrobnosti o kanálu. |
Extension | GA |
| az pipelines update |
Aktualizace kanálu |
Extension | GA |
| az pipelines variable |
Správa proměnných kanálu |
Extension | GA |
| az pipelines variable-group |
Správa skupin proměnných |
Extension | GA |
| az pipelines variable-group create |
Vytvořte skupinu proměnných. |
Extension | GA |
| az pipelines variable-group delete |
Odstraňte skupinu proměnných. |
Extension | GA |
| az pipelines variable-group list |
Zobrazení seznamu skupin proměnných |
Extension | GA |
| az pipelines variable-group show |
Zobrazit podrobnosti o skupině proměnných |
Extension | GA |
| az pipelines variable-group update |
Aktualizace skupiny proměnných |
Extension | GA |
| az pipelines variable-group variable |
Správa proměnných ve skupině proměnných |
Extension | GA |
| az pipelines variable-group variable create |
Přidejte proměnnou do skupiny proměnných. |
Extension | GA |
| az pipelines variable-group variable delete |
Odstraňte proměnnou ze skupiny proměnných. |
Extension | GA |
| az pipelines variable-group variable list |
Zobrazí seznam proměnných ve skupině proměnných. |
Extension | GA |
| az pipelines variable-group variable update |
Aktualizace proměnné ve skupině proměnných |
Extension | GA |
| az pipelines variable create |
Přidejte proměnnou do kanálu. |
Extension | GA |
| az pipelines variable delete |
Odstraňte proměnnou z kanálu. |
Extension | GA |
| az pipelines variable list |
Zobrazení seznamu proměnných v kanálu |
Extension | GA |
| az pipelines variable update |
Aktualizace proměnné v kanálu |
Extension | GA |
az pipelines create
Vytvoření nového kanálu Azure Pipeline (založeného na YAML)
az pipelines create --name
[--branch]
[--description]
[--detect {false, true}]
[--folder-path]
[--org --organization]
[--project]
[--queue-id]
[--repository]
[--repository-type {github, tfsgit}]
[--service-connection]
[--skip-first-run --skip-run {false, true}]
[--yaml-path --yml-path]
Příklady
Vytvoření kanálu Azure z místního kontextu úložiště pokladny
Repository name/url (--repository), type (--repository-type) and branch name (--branch) will be detected from the local git repository
az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
Vytvoření kanálu Azure pro úložiště hostované na GitHubu pomocí adresy URL klonu
az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository https://github.com/SampleOrg/SampleRepo --branch master
Vytvoření kanálu Azure pro úložiště hostované v organizaci GitHub SampleOrg, název úložiště SampleRepo
az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository SampleOrg/SampleRepoName --branch master --repository-type github
Vytvoření kanálu Azure pro úložiště hostované v úložišti Azure ve stejném projektu
az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository SampleRepoName --branch master --repository-type tfsgit
Vytvoření kanálu Azure Pipeline pro úložiště s yamlem kanálu, který je už vrácený se změnami do úložiště
Service connection required for non Azure Repos can be optionally provided in the command to run it non interatively
az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository https://github.com/SampleOrg/SampleRepo --branch master --yml-path azure-pipelines.yml [--service-connection SERVICE_CONNECTION]
Povinné parametry
Název nového kanálu
Volitelné parametry
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Název větve, pro kterou se kanál nakonfiguruje. Pokud tento parametr vynecháte, automaticky se zjistí z místního úložiště.
Popis nového kanálu
Automaticky rozpozná organizaci.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | false, true |
Cesta ke složce, ve které je potřeba kanál vytvořit. Výchozí hodnota je kořenová složka. například "user1/test_pipelines".
Adresa URL organizace Azure DevOps Výchozí organizaci můžete nakonfigurovat pomocí příkazu az devops configure -d organization=ORG_URL. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo vyzvednuto prostřednictvím konfigurace Gitu. Příklad: https://dev.azure.com/MyOrganizationName/.
Název nebo ID projektu. Výchozí projekt můžete nakonfigurovat pomocí příkazu az devops configure -d project=NAME_OR_ID. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo získáno prostřednictvím konfigurace Gitu.
ID fronty v dostupných fondech agentů. Pokud není zadaný, automaticky se rozpozná.
Úložiště, pro které je potřeba kanál nakonfigurovat. V případě úložiště GitHub můžete naklonovat adresu URL úložiště Git nebo název úložiště pro úložiště Azure Repos nebo vlastníka nebo úložiště. Pokud tento parametr vynecháte, automaticky se zjistí ze vzdálené adresy URL místního úložiště Git. Pokud se místo adresy URL uvádí název, je vyžadován také argument --repository-type.
Typ úložiště Pokud tento parametr vynecháte, automaticky se zjistí ze vzdálené adresy URL místního úložiště. Tfsgit pro Azure Repos, GitHub pro úložiště GitHub.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | github, tfsgit |
ID připojení služby vytvořeného pro úložiště pro úložiště GitHub. K vytvoření nebo výpisu service_connections použijte příkaz az devops service-endpoint -h. Nevyžaduje se pro Azure Repos.
Zadáním tohoto příznaku zabráníte spuštění prvního spuštění aktivovaného příkazem. Příkaz vrátí kanál, pokud je spuštění vynecháno, jinak vypíše spuštění kanálu.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | false, true |
Cesta k souboru yaml kanálů v úložišti (pokud je yaml již v úložišti).
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
az pipelines delete
Odstranění kanálu
az pipelines delete --id
[--detect {false, true}]
[--org --organization]
[--project]
[--yes]
Povinné parametry
ID kanálu.
Volitelné parametry
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Automaticky rozpozná organizaci.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | false, true |
Adresa URL organizace Azure DevOps Výchozí organizaci můžete nakonfigurovat pomocí příkazu az devops configure -d organization=ORG_URL. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo vyzvednuto prostřednictvím konfigurace Gitu. Příklad: https://dev.azure.com/MyOrganizationName/.
Název nebo ID projektu. Výchozí projekt můžete nakonfigurovat pomocí příkazu az devops configure -d project=NAME_OR_ID. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo získáno prostřednictvím konfigurace Gitu.
Nevyzývejte k potvrzení.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
az pipelines list
Vypsat kanály
az pipelines list [--detect {false, true}]
[--folder-path]
[--name]
[--org --organization]
[--project]
[--query-order {ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None}]
[--repository]
[--repository-type {bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol}]
[--top]
Volitelné parametry
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Automaticky rozpozná organizaci.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | false, true |
Pokud je zadáno, filtruje definice v této složce.
Omezte výsledky na kanály s tímto názvem nebo začněte tímto názvem. Příklady: "FabCI" nebo "Fab*".
Adresa URL organizace Azure DevOps Výchozí organizaci můžete nakonfigurovat pomocí příkazu az devops configure -d organization=ORG_URL. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo vyzvednuto prostřednictvím konfigurace Gitu. Příklad: https://dev.azure.com/MyOrganizationName/.
Název nebo ID projektu. Výchozí projekt můžete nakonfigurovat pomocí příkazu az devops configure -d project=NAME_OR_ID. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo získáno prostřednictvím konfigurace Gitu.
Pořadí výsledků
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None |
Omezte výsledky na kanály přidružené k tomuto úložišti.
Omezte výsledky na kanály přidružené k tomuto typu úložiště. Argument úložiště je povinný předat spolu s tímto argumentem.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol |
Maximální počet kanálů, které se mají vypsat.
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
az pipelines run
Vytvoření fronty (spuštění) kanálu
az pipelines run [--branch]
[--commit-id]
[--detect {false, true}]
[--folder-path]
[--id]
[--name]
[--open]
[--org --organization]
[--parameters]
[--project]
[--variables]
Volitelné parametry
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Název větve, na které se má spustit kanál, zařadí do fronty. Příklad: refs/heads/master nebo master nebo refs/pull/1/merge, refs/tags/tag.
ID potvrzení, ve kterém má být spuštění kanálu zařazeno do fronty.
Automaticky rozpozná organizaci.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | false, true |
Cesta ke složce kanálu Výchozí hodnota je složka kořenové úrovně.
ID kanálu do fronty. Vyžaduje se, pokud není zadán název --name.
Název kanálu, který se má zařadit do fronty Ignorováno, pokud je zadán --id.
Otevřete stránku výsledků kanálu ve webovém prohlížeči.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Adresa URL organizace Azure DevOps Výchozí organizaci můžete nakonfigurovat pomocí příkazu az devops configure -d organization=ORG_URL. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo vyzvednuto prostřednictvím konfigurace Gitu. Příklad: https://dev.azure.com/MyOrganizationName/.
Mezera oddělená páry name=value pro parametry, které chcete nastavit.
Název nebo ID projektu. Výchozí projekt můžete nakonfigurovat pomocí příkazu az devops configure -d project=NAME_OR_ID. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo získáno prostřednictvím konfigurace Gitu.
Pro proměnné, které chcete nastavit, oddělte páry "name=value".
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
az pipelines show
Získejte podrobnosti o kanálu.
az pipelines show [--detect {false, true}]
[--folder-path]
[--id]
[--name]
[--open]
[--org --organization]
[--project]
Volitelné parametry
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Automaticky rozpozná organizaci.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | false, true |
Cesta ke složce kanálu Výchozí hodnota je složka kořenové úrovně.
ID kanálu.
Název kanálu. Ignorováno, pokud je zadán --id.
Otevřete stránku souhrnu kanálu ve webovém prohlížeči.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Adresa URL organizace Azure DevOps Výchozí organizaci můžete nakonfigurovat pomocí příkazu az devops configure -d organization=ORG_URL. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo vyzvednuto prostřednictvím konfigurace Gitu. Příklad: https://dev.azure.com/MyOrganizationName/.
Název nebo ID projektu. Výchozí projekt můžete nakonfigurovat pomocí příkazu az devops configure -d project=NAME_OR_ID. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo získáno prostřednictvím konfigurace Gitu.
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
az pipelines update
Aktualizace kanálu
az pipelines update --id
[--branch]
[--description]
[--detect {false, true}]
[--new-folder-path]
[--new-name]
[--org --organization]
[--project]
[--queue-id]
[--yaml-path --yml-path]
Povinné parametry
ID kanálu, který se má aktualizovat.
Volitelné parametry
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Název větve, pro kterou se kanál nakonfiguruje.
Nový popis kanálu
Automaticky rozpozná organizaci.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | false, true |
Nová úplná cesta ke složce, do které chcete kanál přesunout. například "user1/production_pipelines".
Nový aktualizovaný název kanálu
Adresa URL organizace Azure DevOps Výchozí organizaci můžete nakonfigurovat pomocí příkazu az devops configure -d organization=ORG_URL. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo vyzvednuto prostřednictvím konfigurace Gitu. Příklad: https://dev.azure.com/MyOrganizationName/.
Název nebo ID projektu. Výchozí projekt můžete nakonfigurovat pomocí příkazu az devops configure -d project=NAME_OR_ID. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo získáno prostřednictvím konfigurace Gitu.
ID fronty fondu agentů, ve kterém se kanál musí spustit.
Cesta k souboru yaml kanálů v úložišti
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |