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.