az acr task

  • Reference

Spravujte kolekci kroků pro sestavování, testování a opravy imagí kontejnerů v OS & Framework pomocí azure Container Registry.

Příkazy

Name Description Typ Stav
az acr task cancel-run

Zrušení zadaného spuštění služby Azure Container Registry

 Základ GA
az acr task create

Vytvořte řadu kroků pro sestavování, testování a opravy kontejnerů OS &Framework. Úlohy podporují triggery z potvrzení Gitu a aktualizací základní image.

 Základ GA
az acr task credential

Správa přihlašovacích údajů pro úlohu Další informace najdete tady: https://aka.ms/acr/tasks/cross-registry-authentication.

 Základ GA
az acr task credential add

Přidejte do úlohy přihlašovací údaje vlastního registru.

 Základ GA
az acr task credential list

Zobrazí seznam všech přihlašovacích údajů vlastního registru pro úlohu.

 Základ GA
az acr task credential remove

Odeberte přihlašovací údaje pro úlohu.

 Základ GA
az acr task credential update

Aktualizujte přihlašovací údaje registru pro úlohu.

 Základ GA
az acr task delete

Odstraňte úlohu ze služby Azure Container Registry.

 Základ GA
az acr task identity

Spravované identity pro úlohu Další informace najdete tady: https://aka.ms/acr/tasks/task-create-managed-identity.

 Základ GA
az acr task identity assign

Aktualizujte spravovanou identitu pro úlohu.

 Základ GA
az acr task identity remove

Odeberte spravované identity pro úlohu.

 Základ GA
az acr task identity show

Zobrazení spravovaných identit pro úlohu

 Základ GA
az acr task list

Vypíše úlohy služby Azure Container Registry.

 Základ GA
az acr task list-runs

Vypíše všechna spuštěná spuštění pro Službu Azure Container Registry s možností filtrovat podle konkrétní úlohy.

 Základ GA
az acr task logs

Zobrazí protokoly pro konkrétní spuštění. Pokud není zadáno žádné id spuštění, zobrazte protokoly pro poslední vytvořené spuštění.

 Základ GA
az acr task run

Ručně aktivujte úlohu, která by jinak mohla čekat na potvrzení Gitu nebo triggery aktualizace základní image.

 Základ GA
az acr task show

Získejte vlastnosti pojmenované úlohy pro Azure Container Registry.

 Základ GA
az acr task show-run

Získejte vlastnosti zadaného spuštění úlohy služby Azure Container Registry.

 Základ GA
az acr task timer

Správa triggerů časovače pro úlohu

 Základ GA
az acr task timer add

Přidejte do úlohy trigger časovače.

 Základ GA
az acr task timer list

Zobrazí seznam všech triggerů časovače pro úlohu.

 Základ GA
az acr task timer remove

Odeberte aktivační událost časovače z úkolu.

 Základ GA
az acr task timer update

Aktualizujte trigger časovače pro úlohu.

 Základ GA
az acr task update

Aktualizujte úlohu služby Azure Container Registry.

 Základ GA
az acr task update-run

Opravte vlastnosti spuštění úlohy služby Azure Container Registry.

 Základ GA

az acr task cancel-run

Upravit

Zrušení zadaného spuštění služby Azure Container Registry

az acr task cancel-run --registry
                       --run-id
                       [--resource-group]

Příklady

Zrušení spuštění

az acr task cancel-run -r myregistry --run-id runId

Povinné parametry

--registry -r

Název registru kontejneru. Měla by být zadána v malých písmenech. Výchozí název registru můžete nakonfigurovat pomocí az configure --defaults acr=<registry name>.

--run-id

Jedinečný identifikátor spuštění.

Volitelné parametry

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

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řípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: 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 acr task create

Upravit

Vytvořte řadu kroků pro sestavování, testování a opravy kontejnerů OS &Framework. Úlohy podporují triggery z potvrzení Gitu a aktualizací základní image.

az acr task create --name
                   --registry
                   [--agent-pool]
                   [--arg]
                   [--assign-identity]
                   [--auth-mode {Default, None}]
                   [--base-image-trigger-enabled {false, true}]
                   [--base-image-trigger-name]
                   [--base-image-trigger-type {All, Runtime}]
                   [--cmd]
                   [--commit-trigger-enabled {false, true}]
                   [--context]
                   [--cpu]
                   [--file]
                   [--git-access-token]
                   [--image]
                   [--is-system-task]
                   [--log-template]
                   [--no-cache {false, true}]
                   [--no-push {false, true}]
                   [--platform]
                   [--pull-request-trigger-enabled {false, true}]
                   [--resource-group]
                   [--schedule]
                   [--secret-arg]
                   [--set]
                   [--set-secret]
                   [--source-trigger-name]
                   [--status {Disabled, Enabled}]
                   [--target]
                   [--timeout]
                   [--update-trigger-endpoint]
                   [--update-trigger-payload-type {Default, Token}]
                   [--values]

Příklady

Vytvořte úkol bez zdrojového umístění.

az acr task create -n hello-world -r myregistry --cmd '$Registry/myimage' -c /dev/null

Vytvořte úlohu s definicí ze standardního vstupu a s triggerem časovače, který spouští úlohu v horní části každé hodiny pomocí výchozího názvu triggeru. Vstupní datový proud ukončí buď "Ctrl + Z"(Windows) nebo "Ctrl + D"(Linux).

cat task.yaml | az acr task create -n hello-world -r myregistry -f - -c /dev/null \
    --schedule "0 */1 * * *"
az acr task create -n hello-world -r myregistry -f - -c /dev/null --schedule "0 */1 * * *"

Vytvořte úlohu Linuxu z veřejného úložiště GitHub, které sestaví image hello-world bez triggerů a použije argument sestavení.

az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry \
    -c https://github.com/Azure/acr-builder.git -f Dockerfile \
    --commit-trigger-enabled false --base-image-trigger-enabled false \
    --arg DOCKER_CLI_BASE_IMAGE=docker:18.03.0-ce-git

Vytvořte úlohu Linuxu pomocí konkrétní větve privátního úložiště Azure DevOps, které vytváří image hello-world v architektuře Arm (varianta V7) a má povolené triggery.

az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry \
    -c https://msazure.visualstudio.com/DefaultCollection/Project/_git/Repo#Branch:Folder \
    -f Dockerfile --git-access-token <Personal Access Token> --platform linux/arm/v7

Vytvořte úlohu Linuxu z veřejného úložiště GitHub, které sestaví image hello-world s povoleným potvrzením Gitu i triggerem žádosti o přijetí změn. Všimněte si, že tato úloha nepoužívá zdrojový registr (myregistry), takže pro něj můžeme explicitně nastavit režim ověřování jako Žádný.

az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry  -f Dockerfile \
    --no-push true --auth-mode None -c https://github.com/Azure-Samples/acr-build-helloworld-node.git \
    --pull-request-trigger-enabled true --git-access-token 000000000000000000000000000000000

Vytvořte úlohu Windows z veřejného úložiště GitHub, které sestaví image Azure Container Builderu v architektuře Amd64 s povoleným pouze triggerem základní image.

az acr task create -t acb:{{.Run.ID}} -n acb-win -r myregistry \
    -c https://github.com/Azure/acr-builder.git -f Windows.Dockerfile \
    --commit-trigger-enabled false --platform Windows/amd64

Vytvořte z veřejného úložiště GitHubu vícekrokový úkol s identitami přiřazenými systémem a uživatelem přiřazenými spravovanými identitami a základní imagí Gitu, potvrzením Gitu, žádostí o přijetí změn a triggery časovače, které spouští úlohu v poledne v pondělí až pátek s zadaným názvem triggeru časovače.

az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry \
    --pull-request-trigger-enabled true --schedule "dailyTimer:0 12 * * Mon-Fri" \
    -c https://github.com/Azure-Samples/acr-tasks.git#:multipleRegistries -f testtask.yaml \
    --assign-identity [system] "/subscriptions/<subscriptionId>/resourcegroups/<myResourceGroup>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<myUserAssignedIdentitiy>"

Povinné parametry

--name -n

Název úkolu.

--registry -r

Název registru kontejneru. Měla by být zadána v malých písmenech. Výchozí název registru můžete nakonfigurovat pomocí az configure --defaults acr=<registry name>.

Volitelné parametry

--agent-pool
Preview

Název fondu agentů.

--arg

Argument sestavení ve formátu ---arg name[=value]. Násobky se podporují tak, že několikrát předáte název --arg[=value]. DŮLEŽITÉ: Tento parametr nesmí obsahovat hesla, přístupové tokeny ani citlivé informace jakéhokoli druhu. Tato hodnota parametru bude viditelná pro tým ACR pro účely ladění.

--assign-identity

Přiřadí k úkolu spravované identity. Pomocí [system] můžete odkazovat na identitu přiřazenou systémem nebo ID prostředku a odkazovat na identitu přiřazenou uživatelem. Další informace najdete tady: https://aka.ms/acr/tasks/task-create-managed-identity.

--auth-mode

Režim ověřování zdrojového registru

Přípustné hodnoty: Default, None
--base-image-trigger-enabled

Určuje, jestli je povolený trigger základní image.

Přípustné hodnoty: false, true
Default value: True
--base-image-trigger-name

Název triggeru základní image.

Default value: defaultBaseimageTriggerName
--base-image-trigger-type

Typ automatického triggeru pro aktualizace závislostí základní image.

Přípustné hodnoty: All, Runtime
Default value: Runtime
--cmd

Příkazy ke spuštění. To také podporuje další parametry spuštění Dockeru (https://docs.docker.com/engine/reference/commandline/run/) nebo i jiné příkazy Dockeru (https://docs.docker.com/engine/reference/commandline/docker/).

--commit-trigger-enabled

Určuje, zda je povolena aktivační událost potvrzení správy zdrojového kódu.

Přípustné hodnoty: false, true
Default value: True
--context -c

Úplná adresa URL úložiště zdrojového kódu (vyžaduje příponu .git pro úložiště GitHubu) nebo vzdálenou tarballu (např. "http://server/context.tar.gz") nebo úložiště artefaktu OCI v registru kontejneru Azure (např. "oci://myregistry.azurecr.io/myartifact:mytag"). Pokud je zadán parametr /dev/null, hodnota se nastaví na Hodnotu None a bude ignorována. Jedná se o povinný argument, pokud úkol není systémovým úkolem.

--cpu

Konfigurace procesoru z hlediska počtu jader potřebných pro spuštění.

Default value: 2
--file -f

Relativní cesta k souboru úkolu nebo dockeru ke kořenové složce zdrojového kódu. Soubory úkolů musí být příponou .yaml nebo předané ze standardního vstupu pomocí -.

--git-access-token

Přístupový token použitý pro přístup k poskytovateli správy zdrojového kódu.

--image -t

Název a značka obrázku ve formátu: '-t úložiště/image:tag'. Více značek je podporováno tak, že několikrát předá -t.

--is-system-task
Preview

Určuje, jestli je zdroj úkolu systémovým úkolem. Název úkolu musí být quicktask. Platí pouze pro registr s podporou CMK.

Default value: False
--log-template
Preview

Úložiště a šablona značky pro artefakt protokolu spuštění ve formátu log: log/repo:tag (např. acr/logs:{{.Run.ID}}). Platí pouze pro registr s podporou CMK.

--no-cache

Určuje, jestli je povolená mezipaměť imagí.

Přípustné hodnoty: false, true
Default value: False
--no-push

Určuje, jestli má být sestavená image vložena do registru.

Přípustné hodnoty: false, true
Default value: False
--platform

Platforma, na které běží sestavení nebo úloha, např. windows a linux. Pokud se používá v příkazech sestavení, můžete ho také zadat ve formátu os/arch/variant pro výsledný obrázek. Např. linux/arm/v7. Části Arch a Variant jsou volitelné.

--pull-request-trigger-enabled

Určuje, jestli je povolená aktivační událost žádosti o přijetí změn správy zdrojového kódu. Trigger je ve výchozím nastavení zakázaný.

Přípustné hodnoty: false, true
Default value: False
--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--schedule

Naplánování aktivační události časovače reprezentované jako výraz cron Volitelný název triggeru je možné zadat ve --schedule name:schedule formátu. Multiples supported by passing --schedule multiple times.

--secret-arg

Argument sestavení tajného kódu ve formátu --secret-arg name[=value]. Násobky jsou podporovány tak, že několikrát předáte název --secret-arg[=value]. Tato hodnota parametru není pro tým ACR k dispozici a je vhodnější pro citlivé informace.

--set

Hodnota úkolu ve formátu --set name[=value] Multiples supported by passing --set multiple times.

--set-secret

Hodnota úkolu tajného kódu ve formátu --set-secret name[=value]. Multiples supported by passing --set-secret multiple times.

--source-trigger-name

Název zdrojové aktivační události.

Default value: defaultSourceTriggerName
--status

Aktuální stav úkolu.

Přípustné hodnoty: Disabled, Enabled
Default value: Enabled
--target

Název cílové fáze sestavení.

--timeout

Časový limit v sekundách.

Default value: 3600
--update-trigger-endpoint
Preview

Úplná adresa URL koncového bodu pro příjem oznámení o aktivaci aktualizace základní image

--update-trigger-payload-type
Preview

Označuje, zda zahrnout metadata o triggeru základní image do datové části spolu s tokenem aktivační události aktualizace při odeslání oznámení.

Přípustné hodnoty: Default, Token
Default value: Default
--values

Hodnoty úkolů/cesta k souboru parametrů vzhledem ke zdrojovému kontextu.

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řípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: 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 acr task delete

Upravit

Odstraňte úlohu ze služby Azure Container Registry.

az acr task delete --name
                   --registry
                   [--resource-group]
                   [--yes]

Příklady

Odstraňte úlohu ze služby Azure Container Registry.

az acr task delete -n MyTask -r myregistry

Povinné parametry

--name -n

Název úkolu.

--registry -r

Název registru kontejneru. Měla by být zadána v malých písmenech. Výchozí název registru můžete nakonfigurovat pomocí az configure --defaults acr=<registry name>.

Volitelné parametry

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--yes -y

Nezotvádejte výzvu k potvrzení.

Default value: False
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řípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: 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 acr task list

Upravit

Vypíše úlohy služby Azure Container Registry.

az acr task list --registry
                 [--resource-group]

Příklady

Vypište úkoly a zobrazte výsledky v tabulce.

az acr task list -r myregistry -o table

Povinné parametry

--registry -r

Název registru kontejneru. Měla by být zadána v malých písmenech. Výchozí název registru můžete nakonfigurovat pomocí az configure --defaults acr=<registry name>.

Volitelné parametry

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

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řípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: 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 acr task list-runs

Upravit

Vypíše všechna spuštěná spuštění pro Službu Azure Container Registry s možností filtrovat podle konkrétní úlohy.

az acr task list-runs --registry
                      [--image]
                      [--name]
                      [--resource-group]
                      [--run-status {Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout}]
                      [--top]

Příklady

Zobrazte seznam všech spuštění registru a zobrazte výsledky v tabulce.

az acr task list-runs -r myregistry -o table

Seznam se spustí pro úlohu a zobrazí výsledky v tabulce.

az acr task list-runs -r myregistry -n MyTask -o table

Zobrazte seznam posledních 10 úspěšných spuštění registru a zobrazte výsledky v tabulce.

az acr task list-runs -r myregistry --run-status Succeeded --top 10 -o table

Zobrazte seznam všech spuštění, která vytvořila image hello-world pro registr, a zobrazte výsledky v tabulce.

az acr task list-runs -r myregistry --image hello-world -o table

Povinné parametry

--registry -r

Název registru kontejneru. Měla by být zadána v malých písmenech. Výchozí název registru můžete nakonfigurovat pomocí az configure --defaults acr=<registry name>.

Volitelné parametry

--image -t

Název obrázku. Může obsahovat značku ve formátu name:tag nebo digest ve formátu name@digest.

--name -n

Název úkolu.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--run-status

Aktuální stav spuštění.

Přípustné hodnoty: Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout
--top

Omezte počet nejnovějších spuštění ve výsledcích.

Default value: 15
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řípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: 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 acr task logs

Upravit

Zobrazí protokoly pro konkrétní spuštění. Pokud není zadáno žádné id spuštění, zobrazte protokoly pro poslední vytvořené spuštění.

az acr task logs --registry
                 [--image]
                 [--name]
                 [--no-format]
                 [--resource-group]
                 [--run-id]

Příklady

Zobrazí protokoly posledního vytvořeného spuštění v registru.

az acr task logs -r myregistry

Zobrazí protokoly posledního vytvořeného spuštění v registru vyfiltrované podle úlohy.

az acr task logs -r myregistry -n MyTask

Zobrazí protokoly pro konkrétní spuštění.

az acr task logs -r myregistry --run-id runId

Zobrazí protokoly posledního vytvořeného spuštění v registru, který sestavil image hello-world.

az acr task logs -r myregistry --image hello-world

Povinné parametry

--registry -r

Název registru kontejneru. Měla by být zadána v malých písmenech. Výchozí název registru můžete nakonfigurovat pomocí az configure --defaults acr=<registry name>.

Volitelné parametry

--image -t

Název obrázku. Může obsahovat značku ve formátu name:tag nebo digest ve formátu name@digest.

--name -n

Název úkolu.

--no-format

Určuje, jestli se mají protokoly zobrazovat v nezpracovaných formátech.

Default value: False
--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--run-id

Jedinečný identifikátor spuštění.

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řípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: 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 acr task run

Upravit

Ručně aktivujte úlohu, která by jinak mohla čekat na potvrzení Gitu nebo triggery aktualizace základní image.

az acr task run --name
                --registry
                [--agent-pool]
                [--arg]
                [--context]
                [--file]
                [--log-template]
                [--no-format]
                [--no-logs]
                [--no-wait]
                [--resource-group]
                [--secret-arg]
                [--set]
                [--set-secret]
                [--target]
                [--update-trigger-token]

Příklady

Aktivace spuštění úlohy

az acr task run -n MyTask -r myregistry

Spusťte úlohu přepsáním kontextu a souboru předaného během vytváření úlohy ve vzdáleném úložišti.

az acr task run -n MyTask -r myregistry -c https://github.com/Azure-Samples/acr-build-helloworld-node.git -f Dockerfile

Spusťte úlohu přepsáním kontextu a souboru předaného během vytváření úlohy s místním kontextem.

az acr task run -n MyTask -r myregistry -c . -f Dockerfile

Spuštění úlohy aktivujte přidáním nebo přepsáním argumentů sestavení nastavených během vytváření úlohy.

az acr task run -n MyTask -r myregistry --arg DOCKER_CLI_BASE_IMAGE=docker:18.03.0-ce-git

Povinné parametry

--name -n

Název úkolu.

--registry -r

Název registru kontejneru. Měla by být zadána v malých písmenech. Výchozí název registru můžete nakonfigurovat pomocí az configure --defaults acr=<registry name>.

Volitelné parametry

--agent-pool
Preview

Název fondu agentů.

--arg

Argument sestavení ve formátu ---arg name[=value]. Násobky se podporují tak, že několikrát předáte název --arg[=value]. DŮLEŽITÉ: Tento parametr nesmí obsahovat hesla, přístupové tokeny ani citlivé informace jakéhokoli druhu. Tato hodnota parametru bude viditelná pro tým ACR pro účely ladění.

--context -c

Úplná adresa URL úložiště zdrojového kódu (vyžaduje příponu .git pro úložiště GitHubu) nebo vzdálenou tarballu (např. "http://server/context.tar.gz") nebo úložiště artefaktu OCI v registru kontejneru Azure (např. "oci://myregistry.azurecr.io/myartifact:mytag"). Pokud je zadán parametr /dev/null, hodnota se nastaví na Hodnotu None a bude ignorována. Jedná se o povinný argument, pokud úkol není systémovým úkolem.

--file -f

Relativní cesta k souboru úkolu nebo dockeru ke kořenové složce zdrojového kódu. Soubory úkolů musí být příponou .yaml nebo předané ze standardního vstupu pomocí -.

--log-template
Preview

Úložiště a šablona značky pro artefakt protokolu spuštění ve formátu log: log/repo:tag (např. acr/logs:{{.Run.ID}}). Platí pouze pro registr s podporou CMK.

--no-format

Určuje, jestli se mají protokoly zobrazovat v nezpracovaných formátech.

Default value: False
--no-logs

Po úspěšném vytvoření fronty sestavení se nezobrazují protokoly.

Default value: False
--no-wait

Nečekejte na dokončení spuštění a vraťte se okamžitě po spuštění do fronty.

Default value: False
--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--secret-arg

Argument sestavení tajného kódu ve formátu --secret-arg name[=value]. Násobky jsou podporovány tak, že několikrát předáte název --secret-arg[=value]. Tato hodnota parametru není pro tým ACR k dispozici a je vhodnější pro citlivé informace.

--set

Hodnota úkolu ve formátu --set name[=value] Multiples supported by passing --set multiple times.

--set-secret

Hodnota úkolu tajného kódu ve formátu --set-secret name[=value]. Multiples supported by passing --set-secret multiple times.

--target

Název cílové fáze sestavení.

--update-trigger-token
Preview

Datová část, která se předá zpět s oznámením o aktivaci základní image.

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řípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: 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 acr task show

Upravit

Získejte vlastnosti pojmenované úlohy pro Azure Container Registry.

az acr task show --name
                 --registry
                 [--resource-group]
                 [--with-secure-properties]

Příklady

Získejte vlastnosti úkolu a zobrazte výsledky v tabulce.

az acr task show -n MyTask -r myregistry -o table

Získejte vlastnosti úlohy, včetně zabezpečených vlastností.

az acr task show -n MyTask -r myregistry --with-secure-properties

Povinné parametry

--name -n

Název úkolu.

--registry -r

Název registru kontejneru. Měla by být zadána v malých písmenech. Výchozí název registru můžete nakonfigurovat pomocí az configure --defaults acr=<registry name>.

Volitelné parametry

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--with-secure-properties

Určuje, zda mají být vráceny zabezpečené vlastnosti úlohy.

Default value: False
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řípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: 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 acr task show-run

Upravit

Získejte vlastnosti zadaného spuštění úlohy služby Azure Container Registry.

az acr task show-run --registry
                     --run-id
                     [--resource-group]

Příklady

Získejte podrobnosti o spuštění a zobrazte výsledky v tabulce.

az acr task show-run -r myregistry --run-id runId -o table

Povinné parametry

--registry -r

Název registru kontejneru. Měla by být zadána v malých písmenech. Výchozí název registru můžete nakonfigurovat pomocí az configure --defaults acr=<registry name>.

--run-id

Jedinečný identifikátor spuštění.

Volitelné parametry

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

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řípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: 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 acr task update

Upravit

Aktualizujte úlohu služby Azure Container Registry.

az acr task update --name
                   --registry
                   [--agent-pool]
                   [--arg]
                   [--auth-mode {Default, None}]
                   [--base-image-trigger-enabled {false, true}]
                   [--base-image-trigger-type {All, Runtime}]
                   [--cmd]
                   [--commit-trigger-enabled {false, true}]
                   [--context]
                   [--cpu]
                   [--file]
                   [--git-access-token]
                   [--image]
                   [--log-template]
                   [--no-cache {false, true}]
                   [--no-push {false, true}]
                   [--platform]
                   [--pull-request-trigger-enabled {false, true}]
                   [--resource-group]
                   [--secret-arg]
                   [--set]
                   [--set-secret]
                   [--status {Disabled, Enabled}]
                   [--target]
                   [--timeout]
                   [--update-trigger-endpoint]
                   [--update-trigger-payload-type {Default, Token}]
                   [--values]

Příklady

Aktualizujte aktualizace základní image tak, aby se aktivovaly u všech závislých imagí souboru Dockerfile s více fázemi a stav úlohy ve službě Azure Container Registry.

az acr task update -n MyTask -r myregistry --base-image-trigger-type All --status Disabled

Aktualizujte platformu pro krok sestavení úlohy do Windows (před Linuxem).

az acr task update -n MyTask -r myregistry --platform Windows

Aktualizujte triggery a kontext úlohy pro Azure Container Registry.

az acr task update -n hello-world -r myregistry -f Dockerfile \
    --commit-trigger-enabled false --pull-request-trigger-enabled true \
    -c https://msazure.visualstudio.com/DefaultCollection/Project/_git/Repo#Branch:Folder

Aktualizujte úlohu služby Azure Container Registry. (automaticky vygenerováno)

az acr task update --image MyImage --name MyTask --registry myregistry \
    --context https://github.com/Azure-Samples/acr-build-helloworld-node.git

Povinné parametry

--name -n

Název úkolu.

--registry -r

Název registru kontejneru. Měla by být zadána v malých písmenech. Výchozí název registru můžete nakonfigurovat pomocí az configure --defaults acr=<registry name>.

Volitelné parametry

--agent-pool
Preview

Název fondu agentů.

--arg

Argument sestavení ve formátu ---arg name[=value]. Násobky se podporují tak, že několikrát předáte název --arg[=value]. DŮLEŽITÉ: Tento parametr nesmí obsahovat hesla, přístupové tokeny ani citlivé informace jakéhokoli druhu. Tato hodnota parametru bude viditelná pro tým ACR pro účely ladění.

--auth-mode

Režim ověřování zdrojového registru

Přípustné hodnoty: Default, None
--base-image-trigger-enabled

Určuje, jestli je povolený trigger základní image.

Přípustné hodnoty: false, true
--base-image-trigger-type

Typ automatického triggeru pro aktualizace závislostí základní image.

Přípustné hodnoty: All, Runtime
--cmd

Příkazy ke spuštění. To také podporuje další parametry spuštění Dockeru (https://docs.docker.com/engine/reference/commandline/run/) nebo i jiné příkazy Dockeru (https://docs.docker.com/engine/reference/commandline/docker/).

--commit-trigger-enabled

Určuje, zda je povolena aktivační událost potvrzení správy zdrojového kódu.

Přípustné hodnoty: false, true
--context -c

Úplná adresa URL úložiště zdrojového kódu (vyžaduje příponu .git pro úložiště GitHubu) nebo vzdálenou tarballu (např. "http://server/context.tar.gz") nebo úložiště artefaktu OCI v registru kontejneru Azure (např. "oci://myregistry.azurecr.io/myartifact:mytag"). Pokud je zadán parametr /dev/null, hodnota se nastaví na Hodnotu None a bude ignorována. Jedná se o povinný argument, pokud úkol není systémovým úkolem.

--cpu

Konfigurace procesoru z hlediska počtu jader potřebných pro spuštění.

--file -f

Relativní cesta k souboru úkolu nebo dockeru ke kořenové složce zdrojového kódu. Soubory úkolů musí být příponou .yaml nebo předané ze standardního vstupu pomocí -.

--git-access-token

Přístupový token použitý pro přístup k poskytovateli správy zdrojového kódu.

--image -t

Název a značka obrázku ve formátu: '-t úložiště/image:tag'. Více značek je podporováno tak, že několikrát předá -t.

--log-template
Preview

Úložiště a šablona značky pro artefakt protokolu spuštění ve formátu log: log/repo:tag (např. acr/logs:{{.Run.ID}}). Platí pouze pro registr s podporou CMK.

--no-cache

Určuje, jestli je povolená mezipaměť imagí.

Přípustné hodnoty: false, true
--no-push

Určuje, jestli má být sestavená image vložena do registru.

Přípustné hodnoty: false, true
--platform

Platforma, na které běží sestavení nebo úloha, např. windows a linux. Pokud se používá v příkazech sestavení, můžete ho také zadat ve formátu os/arch/variant pro výsledný obrázek. Např. linux/arm/v7. Části Arch a Variant jsou volitelné.

--pull-request-trigger-enabled

Určuje, jestli je povolená aktivační událost žádosti o přijetí změn správy zdrojového kódu. Trigger je ve výchozím nastavení zakázaný.

Přípustné hodnoty: false, true
--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--secret-arg

Argument sestavení tajného kódu ve formátu --secret-arg name[=value]. Násobky jsou podporovány tak, že několikrát předáte název --secret-arg[=value]. Tato hodnota parametru není pro tým ACR k dispozici a je vhodnější pro citlivé informace.

--set

Hodnota úkolu ve formátu --set name[=value] Multiples supported by passing --set multiple times.

--set-secret

Hodnota úkolu tajného kódu ve formátu --set-secret name[=value]. Multiples supported by passing --set-secret multiple times.

--status

Aktuální stav úkolu.

Přípustné hodnoty: Disabled, Enabled
--target

Název cílové fáze sestavení.

--timeout

Časový limit v sekundách.

--update-trigger-endpoint
Preview

Úplná adresa URL koncového bodu pro příjem oznámení o aktivaci aktualizace základní image

--update-trigger-payload-type
Preview

Označuje, zda zahrnout metadata o triggeru základní image do datové části spolu s tokenem aktivační události aktualizace při odeslání oznámení.

Přípustné hodnoty: Default, Token
--values

Hodnoty úkolů/cesta k souboru parametrů vzhledem ke zdrojovému kontextu.

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řípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: 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 acr task update-run

Upravit

Opravte vlastnosti spuštění úlohy služby Azure Container Registry.

az acr task update-run --registry
                       --run-id
                       [--no-archive {false, true}]
                       [--resource-group]

Příklady

Aktualizujte existující spuštění, které se má archivovat.

az acr task update-run -r myregistry --run-id runId --no-archive false

Povinné parametry

--registry -r

Název registru kontejneru. Měla by být zadána v malých písmenech. Výchozí název registru můžete nakonfigurovat pomocí az configure --defaults acr=<registry name>.

--run-id

Jedinečný identifikátor spuštění.

Volitelné parametry

--no-archive

Určuje, jestli se má spuštění archivovat.

Přípustné hodnoty: false, true
--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

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řípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: 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.