az pipelines

Note

This reference is part of the azure-devops extension for the Azure CLI (version 2.30.0 or higher). The extension will automatically install the first time you run an az pipelines command. Learn more about extensions.

Gerencie pipelines do Azure.

Este grupo de comandos faz parte da extensão azure-devops.

Comandos

Name	Description	Tipo	Status
az pipelines agent	Manage agents.	Extension	disponibilidade geral
az pipelines agent list	Obtenha uma lista de agentes em um pool.	Extension	disponibilidade geral
az pipelines agent show	Mostrar detalhes do agente.	Extension	disponibilidade geral
az pipelines build	Manage builds.	Extension	disponibilidade geral
az pipelines build cancel	Cancela se a compilação estiver em execução.	Extension	disponibilidade geral
az pipelines build definition	Gerencie definições de compilação.	Extension	disponibilidade geral
az pipelines build definition list	Listar definições de compilação.	Extension	disponibilidade geral
az pipelines build definition show	Obtenha os detalhes de uma definição de compilação.	Extension	disponibilidade geral
az pipelines build list	Listar resultados de compilação.	Extension	disponibilidade geral
az pipelines build queue	Solicitar (enfileirar) uma compilação.	Extension	disponibilidade geral
az pipelines build show	Obtenha os detalhes de uma compilação.	Extension	disponibilidade geral
az pipelines build tag	Gerencie tags de compilação.	Extension	disponibilidade geral
az pipelines build tag add	Adicione tag(s) para uma compilação.	Extension	disponibilidade geral
az pipelines build tag delete	Exclua uma tag de compilação.	Extension	disponibilidade geral
az pipelines build tag list	Obtenha tags para uma compilação.	Extension	disponibilidade geral
az pipelines create	Crie um novo Pipeline do Azure (baseado em YAML).	Extension	disponibilidade geral
az pipelines delete	Exclua um pipeline.	Extension	disponibilidade geral
az pipelines folder	Gerencie pastas para organizar pipelines.	Extension	disponibilidade geral
az pipelines folder create	Crie uma pasta.	Extension	disponibilidade geral
az pipelines folder delete	Exclua uma pasta.	Extension	disponibilidade geral
az pipelines folder list	Liste todas as pastas.	Extension	disponibilidade geral
az pipelines folder update	Atualize o nome ou a descrição de uma pasta.	Extension	disponibilidade geral
az pipelines list	List pipelines.	Extension	disponibilidade geral
az pipelines pool	Gerencie pools de agentes.	Extension	disponibilidade geral
az pipelines pool list	Listar pools de agentes.	Extension	disponibilidade geral
az pipelines pool show	Mostrar detalhes do pool de agentes.	Extension	disponibilidade geral
az pipelines queue	Gerencie filas de agentes.	Extension	disponibilidade geral
az pipelines queue list	Listar filas de agentes.	Extension	disponibilidade geral
az pipelines queue show	Mostrar detalhes da fila de agentes.	Extension	disponibilidade geral
az pipelines release	Manage releases.	Extension	disponibilidade geral
az pipelines release create	Solicite (crie) uma liberação.	Extension	disponibilidade geral
az pipelines release definition	Gerencie definições de versão.	Extension	disponibilidade geral
az pipelines release definition list	Listar definições de versão.	Extension	disponibilidade geral
az pipelines release definition show	Obtenha os detalhes de uma definição de versão.	Extension	disponibilidade geral
az pipelines release list	Listar os resultados da versão.	Extension	disponibilidade geral
az pipelines release show	Obtenha os detalhes de uma versão.	Extension	disponibilidade geral
az pipelines run	Enfileirar (executar) um pipeline.	Extension	disponibilidade geral
az pipelines runs	Gerencie execuções de pipeline.	Extension	disponibilidade geral
az pipelines runs artifact	Gerencie artefatos de execução de pipeline.	Extension	disponibilidade geral
az pipelines runs artifact download	Faça o download de um artefato de pipeline.	Extension	disponibilidade geral
az pipelines runs artifact list	Listar artefatos associados a uma execução.	Extension	disponibilidade geral
az pipelines runs artifact upload	Carregue um artefato de pipeline.	Extension	disponibilidade geral
az pipelines runs list	Liste o pipeline executado em um projeto.	Extension	disponibilidade geral
az pipelines runs show	Mostrar detalhes de uma execução de pipeline.	Extension	disponibilidade geral
az pipelines runs tag	Gerencie tags de execução de pipeline.	Extension	disponibilidade geral
az pipelines runs tag add	Adicione tag(s) para uma execução de pipeline.	Extension	disponibilidade geral
az pipelines runs tag delete	Exclua uma tag de execução de pipeline.	Extension	disponibilidade geral
az pipelines runs tag list	Obter tags para uma execução de pipeline.	Extension	disponibilidade geral
az pipelines show	Obtenha os detalhes de um pipeline.	Extension	disponibilidade geral
az pipelines update	Atualize um pipeline.	Extension	disponibilidade geral
az pipelines variable	Gerencie variáveis de pipeline.	Extension	disponibilidade geral
az pipelines variable-group	Gerencie grupos de variáveis.	Extension	disponibilidade geral
az pipelines variable-group create	Crie um grupo de variáveis.	Extension	disponibilidade geral
az pipelines variable-group delete	Excluir um grupo de variáveis.	Extension	disponibilidade geral
az pipelines variable-group list	Listar grupos de variáveis.	Extension	disponibilidade geral
az pipelines variable-group show	Mostrar detalhes do grupo de variáveis.	Extension	disponibilidade geral
az pipelines variable-group update	Atualizar um grupo de variáveis.	Extension	disponibilidade geral
az pipelines variable-group variable	Gerenciar variáveis em um grupo de variáveis.	Extension	disponibilidade geral
az pipelines variable-group variable create	Adicione uma variável a um grupo de variáveis.	Extension	disponibilidade geral
az pipelines variable-group variable delete	Exclua uma variável do grupo de variáveis.	Extension	disponibilidade geral
az pipelines variable-group variable list	Liste as variáveis em um grupo de variáveis.	Extension	disponibilidade geral
az pipelines variable-group variable update	Atualizar uma variável em um grupo de variáveis.	Extension	disponibilidade geral
az pipelines variable create	Adicione uma variável a um pipeline.	Extension	disponibilidade geral
az pipelines variable delete	Exclua uma variável do pipeline.	Extension	disponibilidade geral
az pipelines variable list	Liste as variáveis em um pipeline.	Extension	disponibilidade geral
az pipelines variable update	Atualizar uma variável em um pipeline.	Extension	disponibilidade geral

az pipelines create

Crie um novo Pipeline do Azure (baseado em 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]

Exemplos

Criar um Pipeline do Azure a partir do contexto do repositório de check-out local

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'

Criar um Pipeline do Azure para um repositório hospedado no Github usando url de clone

az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository https://github.com/SampleOrg/SampleRepo --branch master

Criar um Pipeline do Azure para um repositório hospedado na organização Github SampleOrg, nome do repositório SampleRepo

az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository SampleOrg/SampleRepoName --branch master --repository-type github

Criar um Pipeline do Azure para um repositório hospedado em um repositório do Azure no mesmo projeto

az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository SampleRepoName --branch master --repository-type tfsgit

Criar um Pipeline do Azure para um repositório com o yaml do pipeline já com check-in no repositório

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]

Parâmetros Obrigatórios

--name

Nome do novo gasoduto.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--branch

Nome da ramificação para a qual o pipeline será configurado. Se omitido, ele será detetado automaticamente a partir do repositório local.

--description

Descrição do novo pipeline.

--detect

Detete automaticamente a organização.

Propriedade	Valor
Valores aceites:	false, true

--folder-path

Caminho da pasta onde o pipeline precisa ser criado. O padrão é a pasta raiz. e.g. "user1/test_pipelines".

--org --organization

URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--project -p

Nome ou ID do projeto. Você pode configurar o projeto padrão usando az devops configure -d project=NAME_OR_ID. Necessário se não configurado como padrão ou captado via git config.

--queue-id

ID da fila nos pools de agentes disponíveis. Será detetado automaticamente se não for especificado.

--repository

Repositório para o qual o pipeline precisa ser configurado. Pode ser URL de clone do repositório git ou nome do repositório para um Azure Repos ou Owner/RepoName no caso do repositório GitHub. Se omitido, ele será detetado automaticamente a partir da url remota do repositório git local. Se name for mencionado em vez de url, o argumento --repository-type também será necessário.

--repository-type

Tipo de repositório. Se omitido, ele será detetado automaticamente a partir da url remota do repositório local. 'tfsgit' para Azure Repos, 'github' para repositório GitHub.

Propriedade	Valor
Valores aceites:	github, tfsgit

--service-connection

ID da conexão de serviço criada para o repositório do repositório GitHub. Use o comando az devops service-endpoint -h para criar/listar service_connections. Não é necessário para o Azure Repos.

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

Especifique esse sinalizador para evitar que a primeira execução seja acionada pelo comando. O comando retornará um pipeline se a execução for ignorada, caso contrário, ele produzirá uma execução de pipeline.

Propriedade	Valor
Valores aceites:	false, true

--yaml-path --yml-path

Caminho do arquivo yaml pipelines no repositório (se yaml já estiver presente no repo).

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Output format.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

az pipelines delete

Exclua um pipeline.

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

Parâmetros Obrigatórios

--id

ID do pipeline.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--detect

Detete automaticamente a organização.

Propriedade	Valor
Valores aceites:	false, true

--org --organization

URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--project -p

Nome ou ID do projeto. Você pode configurar o projeto padrão usando az devops configure -d project=NAME_OR_ID. Necessário se não configurado como padrão ou captado via git config.

--yes -y

Não solicite confirmação.

Propriedade	Valor
Default value:	False

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Output format.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

az pipelines list

List pipelines.

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]

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--detect

Detete automaticamente a organização.

Propriedade	Valor
Valores aceites:	false, true

--folder-path

Se especificado, filtra para definições nesta pasta.

--name

Limite os resultados a pipelines com este nome ou começando com este nome. Exemplos: "FabCI" ou "Fab*".

--org --organization

URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--project -p

Nome ou ID do projeto. Você pode configurar o projeto padrão usando az devops configure -d project=NAME_OR_ID. Necessário se não configurado como padrão ou captado via git config.

--query-order

Ordem dos resultados.

Propriedade	Valor
Valores aceites:	ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None

--repository

Limite os resultados aos pipelines associados a este repositório.

--repository-type

Limite os resultados aos pipelines associados a esse tipo de repositório. É obrigatório passar o argumento "repositório" juntamente com este argumento.

Propriedade	Valor
Valores aceites:	bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol

--top

Número máximo de pipelines a serem listados.

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Output format.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

az pipelines run

Enfileirar (executar) um pipeline.

az pipelines run [--branch]
                 [--commit-id]
                 [--detect {false, true}]
                 [--folder-path]
                 [--id]
                 [--name]
                 [--open]
                 [--org --organization]
                 [--parameters]
                 [--project]
                 [--variables]

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--branch

Nome da ramificação na qual o pipeline deve ser executado na fila. Exemplo: refs/heads/master ou master ou refs/pull/1/merge ou refs/tags/tag.

--commit-id

Commit-id no qual a execução do pipeline deve ser enfileirada.

--detect

Detete automaticamente a organização.

Propriedade	Valor
Valores aceites:	false, true

--folder-path

Caminho da pasta do pipeline. O padrão é pasta de nível raiz.

--id

ID do pipeline para fila. Obrigatório se --name não for fornecido.

--name

Nome do pipeline para fila. Ignorado se --id for fornecido.

--open

Abra a página de resultados do pipeline no navegador da Web.

Propriedade	Valor
Default value:	False

--org --organization

URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--parameters

Pares "name=value" separados por espaço para os parâmetros que você gostaria de definir.

--project -p

Nome ou ID do projeto. Você pode configurar o projeto padrão usando az devops configure -d project=NAME_OR_ID. Necessário se não configurado como padrão ou captado via git config.

--variables

Pares "name=value" separados por espaço para as variáveis que você gostaria de definir.

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Output format.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

az pipelines show

Obtenha os detalhes de um pipeline.

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

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--detect

Detete automaticamente a organização.

Propriedade	Valor
Valores aceites:	false, true

--folder-path

Caminho da pasta do pipeline. O padrão é pasta de nível raiz.

--id

ID do pipeline.

--name

Nome do pipeline. Ignorado se --id for fornecido.

--open

Abra a página de resumo do pipeline no navegador da Web.

Propriedade	Valor
Default value:	False

--org --organization

URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--project -p

Nome ou ID do projeto. Você pode configurar o projeto padrão usando az devops configure -d project=NAME_OR_ID. Necessário se não configurado como padrão ou captado via git config.

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Output format.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

az pipelines update

Atualize um pipeline.

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

Parâmetros Obrigatórios

--id

Id do pipeline a ser atualizado.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--branch

Nome da ramificação para a qual o pipeline será configurado.

--description

Nova descrição para o gasoduto.

--detect

Detete automaticamente a organização.

Propriedade	Valor
Valores aceites:	false, true

--new-folder-path

Novo caminho completo da pasta para a qual mover o pipeline. por exemplo, "utilizador1/production_pipelines".

--new-name

Novo nome atualizado do pipeline.

--org --organization

URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--project -p

Nome ou ID do projeto. Você pode configurar o projeto padrão usando az devops configure -d project=NAME_OR_ID. Necessário se não configurado como padrão ou captado via git config.

--queue-id

ID da fila do pool de agentes onde o pipeline precisa ser executado.

--yaml-path --yml-path

Caminho do arquivo yaml pipelines no repo.

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Output format.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False