Partilhar via

az pipelines build

  • Referência

Nota

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.

 Extensão GA
az pipelines build definition

Gerencie definições de compilação.

 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 (enfileirar) uma compilação.

 Extensão GA
az pipelines build show

Obtenha os detalhes de uma compilação.

 Extensão GA
az pipelines build tag

Gerencie tags de compilação.

 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 Obrigatórios

--build-id

ID da compilação.

Parâmetros Opcionais

--detect

Detete automaticamente a organização.

Valores aceites: false, true
--open

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

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. Obrigatório se não estiver 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. Obrigatório se não estiver 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.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

Aumente a verbosidade do registro. 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

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.

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. Obrigatório se não estiver 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. Obrigatório se não estiver configurado como padrão ou captado via git config.

--reason

Limite para compilações com este motivo.

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.

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

Limite para compilações com esse status.

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.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

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

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

Parâmetros Opcionais

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

Valores aceites: false, true
--open

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

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. Obrigatório se não estiver 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. Obrigatório se não estiver 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.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

Aumente a verbosidade do registro. 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 Obrigatórios

--id

ID da compilação.

Parâmetros Opcionais

--detect

Detete automaticamente a organização.

Valores aceites: false, true
--open

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

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. Obrigatório se não estiver 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. Obrigatório se não estiver 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.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

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