az repos policy build

  • Reference

Poznámka

Tento odkaz je součástí rozšíření azure-devops pro Azure CLI (verze 2.30.0 nebo vyšší). Rozšíření se automaticky nainstaluje při prvním spuštění příkazu az repos policy build . Přečtěte si další informace o rozšířeních.

Správa zásad sestavení

Příkazy

Name Description Typ Stav
az repos policy build create

Vytvořte zásadu sestavení.

 Rozšíření GA
az repos policy build update

Aktualizujte zásady sestavení.

 Rozšíření GA

az repos policy build create

Vytvořte zásadu sestavení.

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]

Povinné parametry

--blocking

Bez ohledu na to, jestli by zásady měly být blokující, nebo ne.

přijímané hodnoty: false, true
--branch

Větev, u které by se tato zásada měla použít. Příklad: master.

--build-definition-id

ID definice sestavení

--display-name

Zobrazovaný název této zásady sestavení pro identifikaci zásad. Příklad: "Zásady ruční fronty".

--enabled

Bez ohledu na to, jestli je zásada povolená nebo ne.

přijímané hodnoty: false, true
--manual-queue-only

Určuje, jestli chcete povolit pouze ruční frontu sestavení.

přijímané hodnoty: false, true
--queue-on-source-update-only

Fronta pouze při aktualizaci zdroje.

přijímané hodnoty: false, true
--repository-id

ID úložiště, pro které se má zásada použít.

--valid-duration

Doba platnosti zásad (v minutách).

Volitelné parametry

--branch-match-type

Určuje způsob použití argumentu větve k použití zásady. Pokud je hodnota "přesná", zásada se použije ve větvi, která má přesnou shodu u argumentu --branch. Pokud je hodnota prefix, zásada se použije ve všech složkách větví, které odpovídají předponě poskytnuté argumentem --branch.

přijímané hodnoty: exact, prefix
výchozí hodnota: exact
--detect

Automaticky rozpozná organizaci.

přijímané hodnoty: false, true
--org --organization

Adresa URL organizace Azure DevOps Výchozí organizaci můžete nakonfigurovat pomocí příkazu az devops configure -d organization=ORG_URL. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo vyzvednuto prostřednictvím konfigurace Gitu. Příklad: https://dev.azure.com/MyOrganizationName/.

--path-filter

Cesty filtru, pro které se zásady použijí. Podporuje absolutní cesty, zástupné řady a více cest oddělených znakem ;. Příklad: /WebApp/Models/Data.cs, /WebApp/* nebo *.cs,/WebApp/Models/Data.cs; ClientApp/Models/Data.cs.

--project -p

Název nebo ID projektu. Výchozí projekt můžete nakonfigurovat pomocí příkazu az devops configure -d project=NAME_OR_ID. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo vyzvednuto prostřednictvím konfigurace Gitu.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az repos policy build update

Aktualizujte zásady sestavení.

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]

Povinné parametry

--id --policy-id

ID zásady.

Volitelné parametry

--blocking

Bez ohledu na to, jestli by zásady měly být blokující, nebo ne.

přijímané hodnoty: false, true
--branch

Větev, u které by se tato zásada měla použít. Příklad: master.

--branch-match-type

Určuje způsob použití argumentu větve k použití zásady. Pokud je hodnota "přesná", zásada se použije ve větvi, která má přesnou shodu u argumentu --branch. Pokud je hodnota prefix, zásada se použije ve všech složkách větví, které odpovídají předponě poskytnuté argumentem --branch.

přijímané hodnoty: exact, prefix
--build-definition-id

ID definice sestavení

--detect

Automaticky rozpozná organizaci.

přijímané hodnoty: false, true
--display-name

Zobrazovaný název této zásady sestavení pro identifikaci zásad. Příklad: "Zásady ruční fronty".

--enabled

Bez ohledu na to, jestli je zásada povolená nebo ne.

přijímané hodnoty: false, true
--manual-queue-only

Určuje, jestli chcete povolit pouze ruční frontu sestavení.

přijímané hodnoty: false, true
--org --organization

Adresa URL organizace Azure DevOps Výchozí organizaci můžete nakonfigurovat pomocí příkazu az devops configure -d organization=ORG_URL. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo vyzvednuto prostřednictvím konfigurace Gitu. Příklad: https://dev.azure.com/MyOrganizationName/.

--path-filter

Cesty filtru, pro které se zásady použijí. Podporuje absolutní cesty, zástupné řady a více cest oddělených znakem ;. Příklad: /WebApp/Models/Data.cs, /WebApp/* nebo *.cs,/WebApp/Models/Data.cs; ClientApp/Models/Data.cs.

--project -p

Název nebo ID projektu. Výchozí projekt můžete nakonfigurovat pomocí příkazu az devops configure -d project=NAME_OR_ID. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo vyzvednuto prostřednictvím konfigurace Gitu.

--queue-on-source-update-only

Fronta pouze při aktualizaci zdroje.

přijímané hodnoty: false, true
--repository-id

ID úložiště, pro které se má zásada použít.

--valid-duration

Doba platnosti zásad (v minutách).

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.