Sdílet prostřednictvím


az pipelines

Poznámka

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ů

Rozšíření GA
az pipelines agent list

Získejte seznam agentů ve fondu.

Rozšíření GA
az pipelines agent show

Zobrazení podrobností agenta

Rozšíření GA
az pipelines build

Správa sestavení

Rozšíření GA
az pipelines build cancel

Zruší se, pokud je sestavení spuštěné.

Rozšíření GA
az pipelines build definition

Správa definic sestavení

Rozšíření GA
az pipelines build definition list

Výpis definic sestavení

Rozšíření GA
az pipelines build definition show

Získejte podrobnosti o definici sestavení.

Rozšíření GA
az pipelines build list

Výpis výsledků sestavení

Rozšíření GA
az pipelines build queue

Žádost o sestavení (fronta)

Rozšíření GA
az pipelines build show

Získejte podrobnosti o sestavení.

Rozšíření GA
az pipelines build tag

Správa značek sestavení

Rozšíření GA
az pipelines build tag add

Přidejte značky pro sestavení.

Rozšíření GA
az pipelines build tag delete

Odstraňte značku buildu.

Rozšíření GA
az pipelines build tag list

Získejte značky pro sestavení.

Rozšíření GA
az pipelines create

Vytvoření nového kanálu Azure Pipeline (založeného na YAML)

Rozšíření GA
az pipelines delete

Odstranění kanálu

Rozšíření GA
az pipelines folder

Správa složek pro uspořádání kanálů

Rozšíření GA
az pipelines folder create

Vytvořte složku.

Rozšíření GA
az pipelines folder delete

Odstraňte složku.

Rozšíření GA
az pipelines folder list

Zobrazí seznam všech složek.

Rozšíření GA
az pipelines folder update

Aktualizujte název nebo popis složky.

Rozšíření GA
az pipelines list

Vypsat kanály

Rozšíření GA
az pipelines pool

Správa fondů agentů

Rozšíření GA
az pipelines pool list

Výpis fondů agentů

Rozšíření GA
az pipelines pool show

Zobrazení podrobností fondu agentů

Rozšíření GA
az pipelines queue

Správa front agentů

Rozšíření GA
az pipelines queue list

Výpis front agentů

Rozšíření GA
az pipelines queue show

Zobrazení podrobností o frontě agenta

Rozšíření GA
az pipelines release

Správa vydaných verzí

Rozšíření GA
az pipelines release create

Požádejte (vytvořte) verzi.

Rozšíření GA
az pipelines release definition

Správa definic vydaných verzí

Rozšíření GA
az pipelines release definition list

Výpis definic vydaných verzí

Rozšíření GA
az pipelines release definition show

Získejte podrobnosti o definici verze.

Rozšíření GA
az pipelines release list

Vypíše výsledky vydání.

Rozšíření GA
az pipelines release show

Získejte podrobnosti o verzi.

Rozšíření GA
az pipelines run

Vytvoření fronty (spuštění) kanálu

Rozšíření GA
az pipelines runs

Správa spuštění kanálu

Rozšíření GA
az pipelines runs artifact

Správa artefaktů spuštění kanálu

Rozšíření GA
az pipelines runs artifact download

Stáhněte si artefakt kanálu.

Rozšíření GA
az pipelines runs artifact list

Výpis artefaktů přidružených ke spuštění

Rozšíření GA
az pipelines runs artifact upload

Nahrajte artefakt kanálu.

Rozšíření GA
az pipelines runs list

Zobrazení seznamu spuštění kanálu v projektu

Rozšíření GA
az pipelines runs show

Zobrazí podrobnosti o spuštění kanálu.

Rozšíření GA
az pipelines runs tag

Správa značek spuštění kanálu

Rozšíření GA
az pipelines runs tag add

Přidejte značky pro spuštění kanálu.

Rozšíření GA
az pipelines runs tag delete

Odstraňte značku spuštění kanálu.

Rozšíření GA
az pipelines runs tag list

Získejte značky pro spuštění kanálu.

Rozšíření GA
az pipelines show

Získejte podrobnosti o kanálu.

Rozšíření GA
az pipelines update

Aktualizace kanálu

Rozšíření GA
az pipelines variable

Správa proměnných kanálu

Rozšíření GA
az pipelines variable-group

Správa skupin proměnných

Rozšíření GA
az pipelines variable-group create

Vytvořte skupinu proměnných.

Rozšíření GA
az pipelines variable-group delete

Odstraňte skupinu proměnných.

Rozšíření GA
az pipelines variable-group list

Zobrazení seznamu skupin proměnných

Rozšíření GA
az pipelines variable-group show

Zobrazit podrobnosti o skupině proměnných

Rozšíření GA
az pipelines variable-group update

Aktualizace skupiny proměnných

Rozšíření GA
az pipelines variable-group variable

Správa proměnných ve skupině proměnných

Rozšíření GA
az pipelines variable-group variable create

Přidejte proměnnou do skupiny proměnných.

Rozšíření GA
az pipelines variable-group variable delete

Odstraňte proměnnou ze skupiny proměnných.

Rozšíření GA
az pipelines variable-group variable list

Zobrazí seznam proměnných ve skupině proměnných.

Rozšíření GA
az pipelines variable-group variable update

Aktualizace proměnné ve skupině proměnných

Rozšíření GA
az pipelines variable create

Přidejte proměnnou do kanálu.

Rozšíření GA
az pipelines variable delete

Odstraňte proměnnou z kanálu.

Rozšíření GA
az pipelines variable list

Zobrazení seznamu proměnných v kanálu

Rozšíření GA
az pipelines variable update

Aktualizace proměnné v kanálu

Rozšíření 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]
                    [--project]
                    [--queue-id]
                    [--repository]
                    [--repository-type {github, tfsgit}]
                    [--service-connection]
                    [--skip-first-run {false, true}]
                    [--yaml-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

--name

Název nového kanálu

Volitelné parametry

--branch

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

--description

Popis nového kanálu

--detect

Automaticky rozpozná organizaci.

přijímané hodnoty: false, true
--folder-path

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

--org --organization

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

--project -p

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 vyzvednuto prostřednictvím konfigurace Gitu.

--queue-id

ID fronty v dostupných fondech agentů. Pokud není zadaný, automaticky se rozpozná.

--repository

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

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

přijímané hodnoty: github, tfsgit
--service-connection

ID připojení služby vytvořeného pro úložiště pro úložiště GitHub. K vytvoření/výpisu service_connections použijte příkaz az devops service-endpoint -h. Nevyžaduje se pro Azure Repos.

--skip-first-run --skip-run

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.

přijímané hodnoty: false, true
--yaml-path --yml-path

Cesta k souboru yaml kanálů v úložišti (pokud je yaml již v úložišti).

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az pipelines delete

Odstranění kanálu

az pipelines delete --id
                    [--detect {false, true}]
                    [--org]
                    [--project]
                    [--yes]

Povinné parametry

--id

ID kanálu.

Volitelné parametry

--detect

Automaticky rozpozná organizaci.

přijímané hodnoty: false, true
--org --organization

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

--project -p

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 vyzvednuto prostřednictvím konfigurace Gitu.

--yes -y

Nezotvádejte výzvu k potvrzení.

výchozí hodnota: False
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az pipelines list

Vypsat kanály

az pipelines list [--detect {false, true}]
                  [--folder-path]
                  [--name]
                  [--org]
                  [--project]
                  [--query-order {ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None}]
                  [--repository]
                  [--repository-type {bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol}]
                  [--top]

Volitelné parametry

--detect

Automaticky rozpozná organizaci.

přijímané hodnoty: false, true
--folder-path

Pokud je zadáno, filtruje definice v této složce.

--name

Omezte výsledky na kanály s tímto názvem nebo začněte tímto názvem. Příklady: "FabCI" nebo "Fab*".

--org --organization

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

--project -p

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 vyzvednuto prostřednictvím konfigurace Gitu.

--query-order

Pořadí výsledků

přijímané hodnoty: ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None
--repository

Omezte výsledky na kanály přidružené k tomuto úložišti.

--repository-type

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.

přijímané hodnoty: bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol
--top

Maximální počet kanálů, které se mají vypsat.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

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]
                 [--parameters]
                 [--project]
                 [--variables]

Volitelné parametry

--branch

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.

--commit-id

ID potvrzení, ve kterém má být spuštění kanálu zařazeno do fronty.

--detect

Automaticky rozpozná organizaci.

přijímané hodnoty: false, true
--folder-path

Cesta ke složce kanálu Výchozí hodnota je složka kořenové úrovně.

--id

ID kanálu do fronty. Vyžaduje se, pokud není zadán název --name.

--name

Název kanálu, který se má zařadit do fronty Ignorováno, pokud je zadán --id.

--open

Otevřete stránku výsledků kanálu ve webovém prohlížeči.

výchozí hodnota: False
--org --organization

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

--parameters

Mezera oddělená páry name=value pro parametry, které chcete nastavit.

--project -p

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 vyzvednuto prostřednictvím konfigurace Gitu.

--variables

Pro proměnné, které chcete nastavit, oddělte páry "name=value".

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az pipelines show

Získejte podrobnosti o kanálu.

az pipelines show [--detect {false, true}]
                  [--folder-path]
                  [--id]
                  [--name]
                  [--open]
                  [--org]
                  [--project]

Volitelné parametry

--detect

Automaticky rozpozná organizaci.

přijímané hodnoty: false, true
--folder-path

Cesta ke složce kanálu Výchozí hodnota je složka kořenové úrovně.

--id

ID kanálu.

--name

Název kanálu. Ignorováno, pokud je zadán --id.

--open

Otevřete stránku souhrnu kanálu ve webovém prohlížeči.

výchozí hodnota: False
--org --organization

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

--project -p

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 vyzvednuto prostřednictvím konfigurace Gitu.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az pipelines update

Aktualizace kanálu

az pipelines update --id
                    [--branch]
                    [--description]
                    [--detect {false, true}]
                    [--new-folder-path]
                    [--new-name]
                    [--org]
                    [--project]
                    [--queue-id]
                    [--yaml-path]

Povinné parametry

--id

ID kanálu, který se má aktualizovat.

Volitelné parametry

--branch

Název větve, pro kterou se kanál nakonfiguruje.

--description

Nový popis kanálu

--detect

Automaticky rozpozná organizaci.

přijímané hodnoty: false, true
--new-folder-path

Nová úplná cesta ke složce, do které chcete kanál přesunout. například "user1/production_pipelines".

--new-name

Nový aktualizovaný název kanálu

--org --organization

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

--project -p

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 vyzvednuto prostřednictvím konfigurace Gitu.

--queue-id

ID fronty fondu agentů, ve kterém se kanál musí spustit.

--yaml-path --yml-path

Cesta k souboru yaml kanálů v úložišti

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.