Compartilhar via

az repos policy 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 repos policy build . Saiba mais sobre extensões.

Gerenciar política de compilação.

Comandos

Nome Description Tipo Status
az repos policy build create

Criar política de compilação.

 Extensão GA
az repos policy build update

Atualize a política de compilação.

 Extensão GA

az repos policy build create

Criar política de compilação.

az repos policy build create --blocking {false, true}
                             --branch
                             --build-definition-id
                             --display-name
                             --enabled {false, true}
                             --manual-queue-only {false, true}
                             --queue-on-source-update-only {false, true}
                             --repository-id
                             --valid-duration
                             [--branch-match-type {exact, prefix}]
                             [--detect {false, true}]
                             [--org]
                             [--path-filter]
                             [--project]

Parâmetros Exigidos

--blocking

Se a política deve ser de bloqueio ou não.

Valores aceitos: false, true
--branch

Ramificação na qual essa política deve ser aplicada. Por exemplo: mestre.

--build-definition-id

ID da definição de compilação.

--display-name

Nome de exibição dessa política de build para identificar a política. Por exemplo: 'Política de fila manual'.

--enabled

Se a política está habilitada ou não.

Valores aceitos: false, true
--manual-queue-only

Se deseja permitir apenas a fila manual de builds.

Valores aceitos: false, true
--queue-on-source-update-only

Fila Somente na atualização de origem.

Valores aceitos: false, true
--repository-id

Id do repositório no qual aplicar a política.

--valid-duration

Duração da validade da apólice (em minutos).

Parâmetros Opcionais

--branch-match-type

Determina como o argumento branch é usado para aplicar uma política. Se o valor for 'exato', a política será aplicada em uma ramificação que tenha uma correspondência exata no argumento --branch. Se o valor for 'prefixo', a política será aplicada em todas as pastas de ramificação que correspondem ao prefixo fornecido pelo argumento --branch.

Valores aceitos: exact, prefix
Valor padrão: exact
--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 de git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--path-filter

Caminho(s) de filtro no(s) qual(is) a política é aplicada. Suporta caminhos absolutos, curingas e vários caminhos separados por ';'. Exemplo: /WebApp/Models/Data.cs, /WebApp/* ou *.cs,/WebApp/Models/Data.cs; ClientApp/Modelos/Dados.cs.

--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 repos policy build update

Atualize a política de compilação.

az repos policy build update --id
                             [--blocking {false, true}]
                             [--branch]
                             [--branch-match-type {exact, prefix}]
                             [--build-definition-id]
                             [--detect {false, true}]
                             [--display-name]
                             [--enabled {false, true}]
                             [--manual-queue-only {false, true}]
                             [--org]
                             [--path-filter]
                             [--project]
                             [--queue-on-source-update-only {false, true}]
                             [--repository-id]
                             [--valid-duration]

Parâmetros Exigidos

--id --policy-id

ID da política.

Parâmetros Opcionais

--blocking

Se a política deve ser de bloqueio ou não.

Valores aceitos: false, true
--branch

Ramificação na qual essa política deve ser aplicada. Por exemplo: mestre.

--branch-match-type

Determina como o argumento branch é usado para aplicar uma política. Se o valor for 'exato', a política será aplicada em uma ramificação que tenha uma correspondência exata no argumento --branch. Se o valor for 'prefixo', a política será aplicada em todas as pastas de ramificação que correspondem ao prefixo fornecido pelo argumento --branch.

Valores aceitos: exact, prefix
--build-definition-id

ID da definição de compilação.

--detect

Detectar a organização automaticamente.

Valores aceitos: false, true
--display-name

Nome de exibição dessa política de build para identificar a política. Por exemplo: 'Política de fila manual'.

--enabled

Se a política está habilitada ou não.

Valores aceitos: false, true
--manual-queue-only

Se deseja permitir apenas a fila manual de builds.

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 de git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--path-filter

Caminho(s) de filtro no(s) qual(is) a política é aplicada. Suporta caminhos absolutos, curingas e vários caminhos separados por ';'. Exemplo: /WebApp/Models/Data.cs, /WebApp/* ou *.cs,/WebApp/Models/Data.cs; ClientApp/Modelos/Dados.cs.

--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-on-source-update-only

Fila Somente na atualização de origem.

Valores aceitos: false, true
--repository-id

Id do repositório no qual aplicar a política.

--valid-duration

Duração da validade da apólice (em minutos).

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.