az acr task

Gestire una raccolta di passaggi per la compilazione, il test e l'applicazione di patch alle immagini del contenitore con registri contenitori di Azure.

Comandi

Nome Descrizione Tipo Stato
az acr task cancel-run

Annullare un'esecuzione specificata di un Registro Azure Container.

Memoria centrale Disponibilità generale
az acr task create

Creare una serie di passaggi per la compilazione, il test e l'applicazione di patch ai contenitori os & Framework. Le attività supportano i trigger dai commit Git e dagli aggiornamenti delle immagini di base.

Memoria centrale Disponibilità generale
az acr task credential

Gestire le credenziali per un'attività. Per altre informazioni, vedere https://aka.ms/acr/tasks/cross-registry-authentication.

Memoria centrale Disponibilità generale
az acr task credential add

Aggiungere una credenziale di accesso del Registro di sistema personalizzata all'attività.

Memoria centrale Disponibilità generale
az acr task credential list

Elencare tutte le credenziali del Registro di sistema personalizzate per l'attività.

Memoria centrale Disponibilità generale
az acr task credential remove

Rimuovere le credenziali per un'attività.

Memoria centrale Disponibilità generale
az acr task credential update

Aggiornare le credenziali di accesso del Registro di sistema per un'attività.

Memoria centrale Disponibilità generale
az acr task delete

Eliminare un'attività da un Registro Azure Container.

Memoria centrale Disponibilità generale
az acr task identity

Identità gestite per l'attività. Per altre informazioni, vedere https://aka.ms/acr/tasks/task-create-managed-identity.

Memoria centrale Disponibilità generale
az acr task identity assign

Aggiornare l'identità gestita per un'attività.

Memoria centrale Disponibilità generale
az acr task identity remove

Rimuovere le identità gestite per un'attività.

Memoria centrale Disponibilità generale
az acr task identity show

Visualizzare le identità gestite per l'attività.

Memoria centrale Disponibilità generale
az acr task list

Elencare le attività per un Registro Azure Container.

Memoria centrale Disponibilità generale
az acr task list-runs

Elencare tutte le esecuzioni eseguite per un Registro Azure Container, con la possibilità di filtrare in base a un'attività specifica.

Memoria centrale Disponibilità generale
az acr task logs

Visualizzare i log per una determinata esecuzione. Se non viene specificato alcun id di esecuzione, visualizzare i log per l'ultima esecuzione creata.

Memoria centrale Disponibilità generale
az acr task run

Attivare manualmente un'attività che potrebbe altrimenti attendere i commit Git o i trigger di aggiornamento dell'immagine di base.

Memoria centrale Disponibilità generale
az acr task show

Ottenere le proprietà di un'attività denominata per un Registro Azure Container.

Memoria centrale Disponibilità generale
az acr task show-run

Ottiene le proprietà di un'esecuzione specificata di un'attività Registro Azure Container.

Memoria centrale Disponibilità generale
az acr task timer

Gestire i trigger timer per un'attività.

Memoria centrale Disponibilità generale
az acr task timer add

Aggiungere un trigger timer a un'attività.

Memoria centrale Disponibilità generale
az acr task timer list

Elencare tutti i trigger timer per un'attività.

Memoria centrale Disponibilità generale
az acr task timer remove

Rimuovere un trigger timer da un'attività.

Memoria centrale Disponibilità generale
az acr task timer update

Aggiornare il trigger timer per un'attività.

Memoria centrale Disponibilità generale
az acr task update

Aggiornare un'attività per un Registro Azure Container.

Memoria centrale Disponibilità generale
az acr task update-run

Applicare patch alle proprietà di esecuzione di un'attività Registro Azure Container.

Memoria centrale Disponibilità generale

az acr task cancel-run

Annullare un'esecuzione specificata di un Registro Azure Container.

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

Esempio

Annullare un'esecuzione

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

Parametri necessari

--registry -r

Nome del registro contenitori. Deve essere specificato in lettere minuscole. È possibile configurare il nome predefinito del Registro di sistema usando az configure --defaults acr=<registry name>.

--run-id

Identificatore di esecuzione univoco.

Parametri facoltativi

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az acr task create

Creare una serie di passaggi per la compilazione, il test e l'applicazione di patch ai contenitori os & Framework. Le attività supportano i trigger dai commit Git e dagli aggiornamenti delle immagini di base.

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]

Esempio

Creare un'attività senza il percorso di origine.

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

Creare un'attività con la definizione dall'input standard e con un trigger timer che esegue l'attività all'inizio di ogni ora usando il nome del trigger predefinito. 'CTRL+ Z'(Windows) o 'CTRL+ D'(Linux) termina il flusso di input.

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 * * *"

Creare un'attività Linux da un repository GitHub pubblico che compila l'immagine hello-world senza trigger e usa un argomento di compilazione.

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

Creare un'attività Linux usando un ramo specifico di un repository Azure DevOps privato che compila l'immagine hello-world nell'architettura arm (variante V7) e ha trigger abilitati.

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

Creare un'attività Linux da un repository GitHub pubblico che compila l'immagine hello-world con un trigger di commit Git e di richiesta pull abilitato. Si noti che questa attività non usa il Registro di sistema di origine (myregistry), quindi è possibile impostare in modo esplicito la modalità di autenticazione come Nessuno per tale attività.

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

Creare un'attività di Windows da un repository GitHub pubblico che compila l'immagine di Azure Container Builder nell'architettura Amd64 con solo trigger immagine di base abilitato.

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

Creare un'attività in più passaggi di Linux da un repository GitHub pubblico con identità gestite assegnate dal sistema e immagini di base assegnate dall'utente, commit git, richiesta pull e trigger timer che eseguono l'attività a mezzogiorno da lunedì a venerdì con il nome del trigger timer specificato.

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

Parametri necessari

--name -n

Nome dell'attività.

--registry -r

Nome del registro contenitori. Deve essere specificato in lettere minuscole. È possibile configurare il nome predefinito del Registro di sistema usando az configure --defaults acr=<registry name>.

Parametri facoltativi

--agent-pool
Anteprima

Nome del pool di agenti.

--arg

Argomento di compilazione nel formato '--arg name[=value]'. Multipli supportati passando più volte '--arg'.

--assign-identity

Assegna le identità gestite all'attività. Usare '[system]' per fare riferimento all'identità assegnata dal sistema o a un ID risorsa per fare riferimento a un'identità assegnata dall'utente. Per altre informazioni, vedere https://aka.ms/acr/tasks/task-create-managed-identity.

--auth-mode

Modalità di autenticazione del Registro di sistema di origine.

valori accettati: Default, None
--base-image-trigger-enabled

Indica se il trigger dell'immagine di base è abilitato.

valori accettati: false, true
valore predefinito: True
--base-image-trigger-name

Nome del trigger dell'immagine di base.

valore predefinito: defaultBaseimageTriggerName
--base-image-trigger-type

Tipo di trigger automatico per gli aggiornamenti delle dipendenze dell'immagine di base.

valori accettati: All, Runtime
valore predefinito: Runtime
--cmd

Comandi da eseguire. Questo supporta anche parametri di esecuzione docker aggiuntivi (https://docs.docker.com/engine/reference/commandline/run/) o anche altri comandi docker (https://docs.docker.com/engine/reference/commandline/docker/).

--commit-trigger-enabled

Indica se il trigger di commit del controllo del codice sorgente è abilitato.

valori accettati: false, true
valore predefinito: True
--context -c

L'URL completo del repository del codice sorgente (richiede il suffisso '.git' per un repository github) o un tarball remoto (ad esempio, 'http://server/context.tar.gz') o il repository di un artefatto OCI in un registro contenitori di Azure (ad esempio, 'oci://myregistry.azurecr.io/myartifact:mytag'). Se viene specificato '/dev/null', il valore verrà impostato su Nessuno e ignorato. Si tratta di un argomento obbligatorio se l'attività non è un'attività di sistema.

--cpu

La configurazione della CPU in termini di numero di core necessari per l'esecuzione.

valore predefinito: 2
--file -f

Percorso relativo del file task/docker nella cartella radice del codice sorgente. I file di attività devono essere suffissi con '.yaml' o inviati tramite pipe dall'input standard usando '-'.

--git-access-token

Token di accesso usato per accedere al provider di controllo del codice sorgente.

--image -t

Nome e tag dell'immagine usando il formato '-t repo/image:tag'. Più tag sono supportati passando -t più volte.

--is-system-task
Anteprima

Indica se la risorsa dell'attività è un'attività di sistema. Il nome dell'attività deve essere "quicktask". Applicabile solo al Registro di sistema abilitato per la chiave gestita dal cliente.

valore predefinito: False
--log-template
Anteprima

Il modello di repository e tag per eseguire l'artefatto del log usando il formato "log/repo:tag", ad esempio 'acr/logs:{{.Run.ID}}'. Applicabile solo al Registro di sistema abilitato per la chiave gestita dal cliente.

--no-cache

Indica se la cache delle immagini è abilitata.

valori accettati: false, true
valore predefinito: False
--no-push

Indica se è necessario eseguire il push dell'immagine compilata nel Registro di sistema.

valori accettati: false, true
valore predefinito: False
--platform

Piattaforma in cui viene eseguita la compilazione/attività, ad esempio "windows" e "linux". Quando viene usato nei comandi di compilazione, può anche essere specificato nel formato "os/arch/variant" per l'immagine risultante. Ad esempio, linux/arm/v7. Le parti 'arch' e 'variant' sono facoltative.

--pull-request-trigger-enabled

Indica se il trigger della richiesta pull del controllo del codice sorgente è abilitato. Il trigger è disabilitato per impostazione predefinita.

valori accettati: false, true
valore predefinito: False
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--schedule

Pianificare un trigger timer rappresentato come espressione cron. È possibile specificare un nome di trigger facoltativo usando --schedule name:schedule il formato . Multipli supportati passando più volte la pianificazione.

--secret-arg

Argomento di compilazione del segreto nel formato '--secret-arg name[=value]'. Multipli supportati passando più volte --secret-arg.

--set

Valore dell'attività nel formato '--set name[=value]'. Multipli supportati passando più volte il set di più volte.

--set-secret

Valore dell'attività segreta nel formato '--set-secret name[=value]'. Multipli supportati passando più volte --set-secret.

--source-trigger-name

Nome del trigger di origine.

valore predefinito: defaultSourceTriggerName
--status

Stato corrente dell'attività.

valori accettati: Disabled, Enabled
valore predefinito: Enabled
--target

Nome della fase di compilazione di destinazione.

--timeout

Timeout in secondi.

valore predefinito: 3600
--update-trigger-endpoint
Anteprima

URL completo dell'endpoint per ricevere le notifiche del trigger di aggiornamento dell'immagine di base.

--update-trigger-payload-type
Anteprima

Indica se includere metadati relativi al trigger dell'immagine di base nel payload insieme al token di trigger di aggiornamento, quando viene inviata una notifica.

valori accettati: Default, Token
valore predefinito: Default
--values

Percorso del file valori/parametri dell'attività relativo al contesto di origine.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az acr task delete

Eliminare un'attività da un Registro Azure Container.

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

Esempio

Eliminare un'attività da un Registro Azure Container.

az acr task delete -n MyTask -r myregistry

Parametri necessari

--name -n

Nome dell'attività.

--registry -r

Nome del registro contenitori. Deve essere specificato in lettere minuscole. È possibile configurare il nome predefinito del Registro di sistema usando az configure --defaults acr=<registry name>.

Parametri facoltativi

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--yes -y

Indica che non è richiesta la conferma.

valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az acr task list

Elencare le attività per un Registro Azure Container.

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

Esempio

Elencare le attività e visualizzare i risultati in una tabella.

az acr task list -r myregistry -o table

Parametri necessari

--registry -r

Nome del registro contenitori. Deve essere specificato in lettere minuscole. È possibile configurare il nome predefinito del Registro di sistema usando az configure --defaults acr=<registry name>.

Parametri facoltativi

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az acr task list-runs

Elencare tutte le esecuzioni eseguite per un Registro Azure Container, con la possibilità di filtrare in base a un'attività specifica.

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

Esempio

Elencare tutte le esecuzioni per un Registro di sistema e visualizzare i risultati in una tabella.

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

Elencare le esecuzioni per un'attività e visualizzare i risultati in una tabella.

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

Elencare le ultime 10 esecuzioni riuscite per un registro e visualizzare i risultati in una tabella.

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

Elencare tutte le esecuzioni che hanno creato l'immagine 'hello-world' per un registro e visualizzare i risultati in una tabella.

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

Parametri necessari

--registry -r

Nome del registro contenitori. Deve essere specificato in lettere minuscole. È possibile configurare il nome predefinito del Registro di sistema usando az configure --defaults acr=<registry name>.

Parametri facoltativi

--image -t

Nome dell'immagine. Può includere un tag nel formato 'name:tag' o digest nel formato 'name@digest'.

--name -n

Nome dell'attività.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--run-status

Stato corrente dell'esecuzione.

valori accettati: Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout
--top

Limitare il numero di esecuzioni più recenti nei risultati.

valore predefinito: 15
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az acr task logs

Visualizzare i log per una determinata esecuzione. Se non viene specificato alcun id di esecuzione, visualizzare i log per l'ultima esecuzione creata.

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

Esempio

Mostra i log per l'ultima esecuzione creata nel Registro di sistema.

az acr task logs -r myregistry

Mostra i log per l'ultima esecuzione creata nel Registro di sistema, filtrati in base all'attività.

az acr task logs -r myregistry -n MyTask

Visualizzare i log per una determinata esecuzione.

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

Mostra i log per l'ultima esecuzione creata nel Registro di sistema che ha compilato l'immagine 'hello-world'.

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

Parametri necessari

--registry -r

Nome del registro contenitori. Deve essere specificato in lettere minuscole. È possibile configurare il nome predefinito del Registro di sistema usando az configure --defaults acr=<registry name>.

Parametri facoltativi

--image -t

Nome dell'immagine. Può includere un tag nel formato 'name:tag' o digest nel formato 'name@digest'.

--name -n

Nome dell'attività.

--no-format

Indica se i log devono essere visualizzati in formato non elaborato.

valore predefinito: False
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--run-id

Identificatore di esecuzione univoco.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az acr task run

Attivare manualmente un'attività che potrebbe altrimenti attendere i commit Git o i trigger di aggiornamento dell'immagine di base.

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]

Esempio

Attivare un'esecuzione di un'attività.

az acr task run -n MyTask -r myregistry

Attivare un'esecuzione di un'attività eseguendo l'override del contesto e del file passati durante la creazione di attività con un repository remoto.

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

Attivare un'esecuzione di un'attività eseguendo l'override del contesto e del file passati durante la creazione dell'attività con un contesto locale.

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

Attivare un'esecuzione di un'attività aggiungendo o eseguendo l'override degli argomenti di compilazione impostati durante la creazione dell'attività.

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

Parametri necessari

--name -n

Nome dell'attività.

--registry -r

Nome del registro contenitori. Deve essere specificato in lettere minuscole. È possibile configurare il nome predefinito del Registro di sistema usando az configure --defaults acr=<registry name>.

Parametri facoltativi

--agent-pool
Anteprima

Nome del pool di agenti.

--arg

Argomento di compilazione nel formato '--arg name[=value]'. Multipli supportati passando più volte '--arg'.

--context -c

L'URL completo del repository del codice sorgente (richiede il suffisso '.git' per un repository github) o un tarball remoto (ad esempio, 'http://server/context.tar.gz') o il repository di un artefatto OCI in un registro contenitori di Azure (ad esempio, 'oci://myregistry.azurecr.io/myartifact:mytag'). Se viene specificato '/dev/null', il valore verrà impostato su Nessuno e ignorato. Si tratta di un argomento obbligatorio se l'attività non è un'attività di sistema.

--file -f

Percorso relativo del file task/docker nella cartella radice del codice sorgente. I file di attività devono essere suffissi con '.yaml' o inviati tramite pipe dall'input standard usando '-'.

--log-template
Anteprima

Il modello di repository e tag per eseguire l'artefatto del log usando il formato "log/repo:tag", ad esempio 'acr/logs:{{.Run.ID}}'. Applicabile solo al Registro di sistema abilitato per la chiave gestita dal cliente.

--no-format

Indica se i log devono essere visualizzati in formato non elaborato.

valore predefinito: False
--no-logs

Non visualizzare i log dopo aver accodato correttamente la compilazione.

valore predefinito: False
--no-wait

Non attendere il completamento dell'esecuzione e restituire immediatamente dopo l'accodamento dell'esecuzione.

valore predefinito: False
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--secret-arg

Argomento di compilazione del segreto nel formato '--secret-arg name[=value]'. Multipli supportati passando più volte --secret-arg.

--set

Valore dell'attività nel formato '--set name[=value]'. Multipli supportati passando più volte il set di più volte.

--set-secret

Valore dell'attività segreta nel formato '--set-secret name[=value]'. Multipli supportati passando più volte --set-secret.

--target

Nome della fase di compilazione di destinazione.

--update-trigger-token
Anteprima

Payload che verrà passato di nuovo con la notifica del trigger dell'immagine di base.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az acr task show

Ottenere le proprietà di un'attività denominata per un Registro Azure Container.

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

Esempio

Ottenere le proprietà di un'attività, visualizzando i risultati in una tabella.

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

Ottenere le proprietà di un'attività, incluse le proprietà sicure.

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

Parametri necessari

--name -n

Nome dell'attività.

--registry -r

Nome del registro contenitori. Deve essere specificato in lettere minuscole. È possibile configurare il nome predefinito del Registro di sistema usando az configure --defaults acr=<registry name>.

Parametri facoltativi

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--with-secure-properties

Indica se devono essere restituite le proprietà sicure di un'attività.

valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az acr task show-run

Ottiene le proprietà di un'esecuzione specificata di un'attività Registro Azure Container.

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

Esempio

Ottenere i dettagli di un'esecuzione, visualizzando i risultati in una tabella.

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

Parametri necessari

--registry -r

Nome del registro contenitori. Deve essere specificato in lettere minuscole. È possibile configurare il nome predefinito del Registro di sistema usando az configure --defaults acr=<registry name>.

--run-id

Identificatore di esecuzione univoco.

Parametri facoltativi

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az acr task update

Aggiornare un'attività per un Registro Azure Container.

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]

Esempio

Aggiornare gli aggiornamenti dell'immagine di base per attivare tutte le immagini dipendenti di un dockerfile a più fasi e lo stato di un'attività in un Registro Azure Container.

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

Aggiornare la piattaforma per il passaggio Di compilazione dell'attività in Windows (prev Linux).

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

Aggiornare i trigger e il contesto dell'attività per un Registro Azure Container.

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

Aggiornare un'attività per un Registro Azure Container. (generato automaticamente)

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

Parametri necessari

--name -n

Nome dell'attività.

--registry -r

Nome del registro contenitori. Deve essere specificato in lettere minuscole. È possibile configurare il nome predefinito del Registro di sistema usando az configure --defaults acr=<registry name>.

Parametri facoltativi

--agent-pool
Anteprima

Nome del pool di agenti.

--arg

Argomento di compilazione nel formato '--arg name[=value]'. Multipli supportati passando più volte '--arg'.

--auth-mode

Modalità di autenticazione del Registro di sistema di origine.

valori accettati: Default, None
--base-image-trigger-enabled

Indica se il trigger dell'immagine di base è abilitato.

valori accettati: false, true
--base-image-trigger-type

Tipo di trigger automatico per gli aggiornamenti delle dipendenze dell'immagine di base.

valori accettati: All, Runtime
--cmd

Comandi da eseguire. Questo supporta anche parametri di esecuzione docker aggiuntivi (https://docs.docker.com/engine/reference/commandline/run/) o anche altri comandi docker (https://docs.docker.com/engine/reference/commandline/docker/).

--commit-trigger-enabled

Indica se il trigger di commit del controllo del codice sorgente è abilitato.

valori accettati: false, true
--context -c

L'URL completo del repository del codice sorgente (richiede il suffisso '.git' per un repository github) o un tarball remoto (ad esempio, 'http://server/context.tar.gz') o il repository di un artefatto OCI in un registro contenitori di Azure (ad esempio, 'oci://myregistry.azurecr.io/myartifact:mytag'). Se viene specificato '/dev/null', il valore verrà impostato su Nessuno e ignorato. Si tratta di un argomento obbligatorio se l'attività non è un'attività di sistema.

--cpu

La configurazione della CPU in termini di numero di core necessari per l'esecuzione.

--file -f

Percorso relativo del file task/docker nella cartella radice del codice sorgente. I file di attività devono essere suffissi con '.yaml' o inviati tramite pipe dall'input standard usando '-'.

--git-access-token

Token di accesso usato per accedere al provider di controllo del codice sorgente.

--image -t

Nome e tag dell'immagine usando il formato '-t repo/image:tag'. Più tag sono supportati passando -t più volte.

--log-template
Anteprima

Il modello di repository e tag per eseguire l'artefatto del log usando il formato "log/repo:tag", ad esempio 'acr/logs:{{.Run.ID}}'. Applicabile solo al Registro di sistema abilitato per la chiave gestita dal cliente.

--no-cache

Indica se la cache delle immagini è abilitata.

valori accettati: false, true
--no-push

Indica se è necessario eseguire il push dell'immagine compilata nel Registro di sistema.

valori accettati: false, true
--platform

Piattaforma in cui viene eseguita la compilazione/attività, ad esempio "windows" e "linux". Quando viene usato nei comandi di compilazione, può anche essere specificato nel formato "os/arch/variant" per l'immagine risultante. Ad esempio, linux/arm/v7. Le parti 'arch' e 'variant' sono facoltative.

--pull-request-trigger-enabled

Indica se il trigger della richiesta pull del controllo del codice sorgente è abilitato. Il trigger è disabilitato per impostazione predefinita.

valori accettati: false, true
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--secret-arg

Argomento di compilazione del segreto nel formato '--secret-arg name[=value]'. Multipli supportati passando più volte --secret-arg.

--set

Valore dell'attività nel formato '--set name[=value]'. Multipli supportati passando più volte il set di più volte.

--set-secret

Valore dell'attività segreta nel formato '--set-secret name[=value]'. Multipli supportati passando più volte --set-secret.

--status

Stato corrente dell'attività.

valori accettati: Disabled, Enabled
--target

Nome della fase di compilazione di destinazione.

--timeout

Timeout in secondi.

--update-trigger-endpoint
Anteprima

URL completo dell'endpoint per ricevere le notifiche del trigger di aggiornamento dell'immagine di base.

--update-trigger-payload-type
Anteprima

Indica se includere metadati relativi al trigger dell'immagine di base nel payload insieme al token di trigger di aggiornamento, quando viene inviata una notifica.

valori accettati: Default, Token
--values

Percorso del file valori/parametri dell'attività relativo al contesto di origine.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az acr task update-run

Applicare patch alle proprietà di esecuzione di un'attività Registro Azure Container.

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

Esempio

Aggiornare un'esecuzione esistente da archiviare.

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

Parametri necessari

--registry -r

Nome del registro contenitori. Deve essere specificato in lettere minuscole. È possibile configurare il nome predefinito del Registro di sistema usando az configure --defaults acr=<registry name>.

--run-id

Identificatore di esecuzione univoco.

Parametri facoltativi

--no-archive

Indica se l'esecuzione deve essere archiviata.

valori accettati: false, true
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.