Partilhar via

az pipelines build

Note

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.

Gerencie compilações.

Comandos

Name Description Tipo Status
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 build cancel

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

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

Parâmetros Obrigatórios

--build-id

ID da compilação.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--detect

Detete automaticamente a organização.

Propriedade Valor
Valores aceites: false, true
--open

Abra a página de resultados da compilação 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

Formato de saída.

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 build list

Listar resultados de compilação.

az pipelines build list [--branch]
                        [--definition-ids]
                        [--detect {false, true}]
                        [--org --organization]
                        [--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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--branch

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

--definition-ids

IDs (espaço separado) de definições para listar compilações.

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

--reason

Limite para compilações com este motivo.

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

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

--result

Limite para compilações com este resultado.

Propriedade Valor
Valores aceites: canceled, failed, none, partiallySucceeded, succeeded
--status

Limite para compilações com esse status.

Propriedade Valor
Valores aceites: 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 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

Formato de saída.

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 build queue

Solicitar (enfileirar) uma compilação.

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--branch

Ramificação para construir. Necessá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

Confirme a ID da ramificação a ser criada.

--definition-id

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

--definition-name

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

--detect

Detete automaticamente a organização.

Propriedade Valor
Valores aceites: false, true
--open

Abra a página de resultados da compilação 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.

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

Formato de saída.

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 build show

Obtenha os detalhes de uma compilação.

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

Parâmetros Obrigatórios

--id

ID da compilação.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--detect

Detete automaticamente a organização.

Propriedade Valor
Valores aceites: false, true
--open

Abra a página de resultados da compilação 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

Formato de saída.

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