Compartilhar via

az pipelines build

  • Referência

Observação

Essa referência faz parte da extensão azure-devops para a CLI do Azure (versão 2.30.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az pipelines build . Saiba mais sobre extensões.

Gerenciar builds.

Comandos

Nome Description Tipo Status
az pipelines build cancel

Cancela se a compilação estiver em execução.

 Extensão GA
az pipelines build definition

Criar definições de build.

 Extensão GA
az pipelines build definition list

Listar definições de compilação.

 Extensão GA
az pipelines build definition show

Obtenha os detalhes de uma definição de compilação.

 Extensão GA
az pipelines build list

Listar resultados de compilação.

 Extensão GA
az pipelines build queue

Solicitar (fila) uma compilação.

 Extensão GA
az pipelines build show

Obtenha os detalhes de uma compilação.

 Extensão GA
az pipelines build tag

Gerenciar marcas de build.

 Extensão GA
az pipelines build tag add

Adicione tag(s) para uma compilação.

 Extensão GA
az pipelines build tag delete

Exclua uma tag de compilação.

 Extensão GA
az pipelines build tag list

Obtenha tags para uma compilação.

 Extensão GA

az pipelines build cancel

Cancela se a compilação estiver em execução.

az pipelines build cancel --build-id
                          [--detect {false, true}]
                          [--open]
                          [--org]
                          [--project]

Parâmetros Exigidos

--build-id

ID da compilação.

Parâmetros Opcionais

--detect

Detectar a organização automaticamente.

Valores aceitos: false, true
--open

Abra a página de resultados da compilação no navegador da Web.

Valor padrão: 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. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git. 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. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git.

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az pipelines build list

Listar resultados de compilação.

az pipelines build list [--branch]
                        [--definition-ids]
                        [--detect {false, true}]
                        [--org]
                        [--project]
                        [--reason {all, batchedCI, buildCompletion, checkInShelveset, individualCI, manual, pullRequest, schedule, triggered, userCreated, validateShelveset}]
                        [--requested-for]
                        [--result {canceled, failed, none, partiallySucceeded, succeeded}]
                        [--status {all, cancelling, completed, inProgress, none, notStarted, postponed}]
                        [--tags]
                        [--top]

Parâmetros Opcionais

--branch

Filtre por compilações para esta ramificação.

--definition-ids

IDs (separados por espaço) de definições para as quais listar compilações.

--detect

Detectar a organização automaticamente.

Valores aceitos: 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. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git. 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. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git.

--reason

Limite para compilações com esse motivo.

Valores aceitos: all, batchedCI, buildCompletion, checkInShelveset, individualCI, manual, pullRequest, schedule, triggered, userCreated, validateShelveset
--requested-for

Limite para compilações solicitadas para este usuário ou grupo.

--result

Limite para compilações com esse resultado.

Valores aceitos: canceled, failed, none, partiallySucceeded, succeeded
--status

Limite para compilações com esse status.

Valores aceitos: all, cancelling, completed, inProgress, none, notStarted, postponed
--tags

Limite para compilações com cada uma das tags especificadas. Espaço separado.

--top

Número máximo de compilações a serem listadas.

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az pipelines build queue

Solicitar (fila) uma compilação.

az pipelines build queue [--branch]
                         [--commit-id]
                         [--definition-id]
                         [--definition-name]
                         [--detect {false, true}]
                         [--open]
                         [--org]
                         [--project]
                         [--queue-id]
                         [--variables]

Parâmetros Opcionais

--branch

Ramificação a ser construída. Obrigatório se não houver uma ramificação padrão configurada na definição. Exemplo: refs/heads/master ou master ou refs/pull/1/merge ou refs/tags/tag.

--commit-id

ID de confirmação da ramificação a ser criada.

--definition-id

ID da definição para a fila. Obrigatório se --name não for fornecido.

--definition-name

Nome da definição para a fila. Ignorado se --id for fornecido.

--detect

Detectar a organização automaticamente.

Valores aceitos: false, true
--open

Abra a página de resultados da compilação no navegador da Web.

Valor padrão: 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. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git. 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. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git.

--queue-id

ID da fila do pool que será usado para enfileirar a compilação.

--variables

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az pipelines build show

Obtenha os detalhes de uma compilação.

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

Parâmetros Exigidos

--id

ID da compilação.

Parâmetros Opcionais

--detect

Detectar a organização automaticamente.

Valores aceitos: false, true
--open

Abra a página de resultados da compilação no navegador da Web.

Valor padrão: 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. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git. 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. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git.

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.