az repos policy build
Note
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í. |
Extension | GA |
| az repos policy build update |
Aktualizujte zásady sestavení. |
Extension | 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
[--acquire-policy-token]
[--branch-match-type {exact, prefix}]
[--change-reference]
[--detect {false, true}]
[--org --organization]
[--path-filter]
[--project]
Povinné parametry
Bez ohledu na to, jestli by zásady měly být blokující, nebo ne.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | false, true |
Větev, u které by se tato zásada měla použít. Příklad: master.
ID definice sestavení
Zobrazovaný název této zásady sestavení pro identifikaci zásad. Příklad: "Zásady ruční fronty".
Bez ohledu na to, jestli je zásada povolená nebo ne.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | false, true |
Určuje, jestli chcete povolit pouze ruční frontu sestavení.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | false, true |
Fronta pouze při aktualizaci zdroje.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | false, true |
ID úložiště, pro které se má zásada použít.
Doba platnosti zásad (v minutách).
Volitelné parametry
Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.
Získání tokenu Azure Policy automaticky pro tuto operaci prostředku
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Global Policy Arguments |
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.
| Vlastnost | Hodnota |
|---|---|
| Default value: | exact |
| Přípustné hodnoty: | exact, prefix |
Související referenční ID odkazu na změnu pro tuto operaci prostředku.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Global Policy Arguments |
Automaticky rozpozná organizaci.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | false, true |
Azure DevOps adresu URL organizace. 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/.
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.
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 získáno prostřednictvím konfigurace Gitu.
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
az repos policy build update
Aktualizujte zásady sestavení.
az repos policy build update --id --policy-id
[--acquire-policy-token]
[--blocking {false, true}]
[--branch]
[--branch-match-type {exact, prefix}]
[--build-definition-id]
[--change-reference]
[--detect {false, true}]
[--display-name]
[--enabled {false, true}]
[--manual-queue-only {false, true}]
[--org --organization]
[--path-filter]
[--project]
[--queue-on-source-update-only {false, true}]
[--repository-id]
[--valid-duration]
Povinné parametry
ID zásady.
Volitelné parametry
Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.
Získání tokenu Azure Policy automaticky pro tuto operaci prostředku
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Global Policy Arguments |
Bez ohledu na to, jestli by zásady měly být blokující, nebo ne.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | false, true |
Větev, u které by se tato zásada měla použít. Příklad: master.
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.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | exact, prefix |
ID definice sestavení
Související referenční ID odkazu na změnu pro tuto operaci prostředku.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Global Policy Arguments |
Automaticky rozpozná organizaci.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | false, true |
Zobrazovaný název této zásady sestavení pro identifikaci zásad. Příklad: "Zásady ruční fronty".
Bez ohledu na to, jestli je zásada povolená nebo ne.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | false, true |
Určuje, jestli chcete povolit pouze ruční frontu sestavení.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | false, true |
Azure DevOps adresu URL organizace. 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/.
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.
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 získáno prostřednictvím konfigurace Gitu.
Fronta pouze při aktualizaci zdroje.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | false, true |
ID úložiště, pro které se má zásada použít.
Doba platnosti zásad (v minutách).
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |