az acr task

Verwalten Sie eine Sammlung von Schritten zum Erstellen, Testen und & Framework-Patching von Containerimages mithilfe von Azure ContainerRegistries.

Befehle

Name	Beschreibung	Typ	Status
az acr task cancel-run	Abbrechen einer angegebenen Ausführung einer Azure-Containerregistrierung.	Core	GA
az acr task create	Erstellen Sie eine Reihe von Schritten zum Erstellen, Testen und Installieren von Framework-Patchcontainern & Framework. Aufgaben unterstützen Trigger von Git Commits und Basisimageupdates.	Core	GA
az acr task credential	Verwalten von Anmeldeinformationen für eine Aufgabe. Weitere Informationen finden Sie unter https://aka.ms/acr/tasks/cross-registry-authentication.	Core	GA
az acr task credential add	Fügen Sie der Aufgabe eine benutzerdefinierte Anmeldeinformationen für die Registrierung hinzu.	Core	GA
az acr task credential list	Listet alle benutzerdefinierten Registrierungsanmeldeinformationen für die Aufgabe auf.	Core	GA
az acr task credential remove	Entfernen sie Anmeldeinformationen für eine Aufgabe.	Core	GA
az acr task credential update	Aktualisieren Sie die Anmeldeinformationen für die Registrierung für eine Aufgabe.	Core	GA
az acr task delete	Löschen sie eine Aufgabe aus einer Azure-Containerregistrierung.	Core	GA
az acr task identity	Verwaltete Identitäten für Aufgabe. Weitere Informationen finden Sie unter https://aka.ms/acr/tasks/task-create-managed-identity.	Core	GA
az acr task identity assign	Aktualisieren sie die verwaltete Identität für eine Aufgabe.	Core	GA
az acr task identity remove	Entfernt verwaltete Identitäten für eine Aufgabe.	Core	GA
az acr task identity show	Anzeigen der verwalteten Identitäten für die Aufgabe.	Core	GA
az acr task list	Listen Sie die Aufgaben für eine Azure-Containerregistrierung auf.	Core	GA
az acr task list-runs	Auflisten aller ausgeführten Ausführungen für eine Azure-Containerregistrierung mit der Möglichkeit, nach einer bestimmten Aufgabe zu filtern.	Core	GA
az acr task logs	Anzeigen von Protokollen für eine bestimmte Ausführung. Wenn keine Ausführungs-ID angegeben wird, zeigen Sie Protokolle für die letzte erstellte Ausführung an.	Core	GA
az acr task run	Lösen Sie manuell eine Aufgabe aus, die andernfalls auf Git Commits oder Basisimageaktualisierungstrigger wartet.	Core	GA
az acr task show	Dient zum Abrufen der Eigenschaften einer benannten Aufgabe für eine Azure-Containerregistrierung.	Core	GA
az acr task show-run	Dient zum Abrufen der Eigenschaften einer angegebenen Ausführung einer Azure-Containerregistrierungsaufgabe.	Core	GA
az acr task timer	Verwalten von Zeitgebertriggern für einen Vorgang.	Core	GA
az acr task timer add	Fügen Sie einem Vorgang einen Timertrigger hinzu.	Core	GA
az acr task timer list	Listet alle Timertrigger für eine Aufgabe auf.	Core	GA
az acr task timer remove	Entfernen Sie einen Timertrigger aus einer Aufgabe.	Core	GA
az acr task timer update	Aktualisieren Sie den Timertrigger für einen Vorgang.	Core	GA
az acr task update	Aktualisieren sie eine Aufgabe für eine Azure-Containerregistrierung.	Core	GA
az acr task update-run	Patchen Sie die Ausführungseigenschaften einer Azure-Containerregistrierungsaufgabe.	Core	GA

az acr task cancel-run

Bearbeiten

Abbrechen einer angegebenen Ausführung einer Azure-Containerregistrierung.

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

Beispiele

Abbrechen einer Ausführung

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

Erforderliche Parameter

--registry -r

Der Name der Containerregistrierung. Er sollte in Kleinbuchstaben angegeben werden. Sie können den Standardregistrierungsnamen mithilfe von az configure --defaults acr=<registry name>konfigurieren.

--run-id

Der eindeutige Ausführungsbezeichner.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Output format.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az acr task create

Bearbeiten

Erstellen Sie eine Reihe von Schritten zum Erstellen, Testen und Installieren von Framework-Patchcontainern & Framework. Aufgaben unterstützen Trigger von Git Commits und Basisimageupdates.

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-acr-auth-id]
                   [--source-trigger-name]
                   [--status {Disabled, Enabled}]
                   [--target]
                   [--timeout]
                   [--update-trigger-endpoint]
                   [--update-trigger-payload-type {Default, Token}]
                   [--values]

Beispiele

Erstellen Sie eine Aufgabe ohne den Quellspeicherort.

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

Erstellen Sie eine Aufgabe mit der Definition aus der Standardeingabe und mit einem Timertrigger, der die Aufgabe über jeder Stunde mit dem Standardtriggernamen ausführt. Entweder 'STRG+ Z'(Windows) oder 'STRG+D'(Linux) beendet den Eingabedatenstrom.

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

Erstellen Sie eine Linux-Aufgabe aus einem öffentlichen GitHub-Repository, das das Hello-World-Image ohne Trigger erstellt und ein Buildargument verwendet.

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

Erstellen Sie eine Linux-Aufgabe mit einer bestimmten Verzweigung eines privaten Azure DevOps-Repositorys, das das Hello-World-Image auf der Arm-Architektur (V7-Variante) erstellt und Trigger aktiviert hat.

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

Erstellen Sie eine Linux-Aufgabe aus einem öffentlichen GitHub-Repository, das das Hello-World-Image erstellt, wobei sowohl ein Git-Commit als auch ein Pull-Anforderungstrigger aktiviert ist. Beachten Sie, dass diese Aufgabe keine Quellregistrierung (myregistry) verwendet, sodass wir den Authentifizierungsmodus explizit als "Keine" festlegen können.

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

Erstellen Sie eine Windows-Aufgabe aus einem öffentlichen GitHub-Repository, das das Azure Container Builder-Image auf der Amd64-Architektur erstellt, wobei nur basisimagetrigger aktiviert ist.

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

Erstellen Sie eine mehrstufige Linux-Aufgabe aus einem öffentlichen GitHub-Repository mit vom System zugewiesenen und vom Benutzer zugewiesenen verwalteten Identitäten und Basisimages, Git Commit, Pull-Anforderung und Zeitgebertriggern, die die Aufgabe an Montagen bis Freitagen mit dem angegebenen Zeitgebertriggernamen ausführen.

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

Erstellen Sie eine Aufgabe ohne den Quellspeicherort in einer ABAC-basierten Repositoryberechtigungsregistrierung, und geben Sie eine vom System zugewiesene verwaltete Identität an, die für die Authentifizierung mit der Quellregistrierung verwendet wird.

az acr task create -n hello-world -r myregistry --cmd '$Registry/myimage' -c /dev/null --source-acr-auth-id [system]

Erstellen Sie eine Aufgabe ohne den Quellspeicherort in einer ABAC-basierten Repositoryberechtigungsregistrierung, und geben Sie eine vom Benutzer zugewiesene verwaltete Identität an, die für die Authentifizierung mit der Quellregistrierung verwendet wird.

az acr task create -n hello-world -r myregistry --cmd '$Registry/myimage' -c /dev/null --source-acr-auth-id "/subscriptions/<subscriptionId>/resourcegroups/<myResourceGroup>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<myUserAssignedIdentitiy>"

Erstellen Sie eine Aufgabe ohne den Quellspeicherort in einer ABAC-basierten Repositoryberechtigungsregistrierung mit vom System zugewiesenen und vom Benutzer zugewiesenen verwalteten Identitäten, und geben Sie die vom System zugewiesene verwaltete Identität an, die für die Authentifizierung mit der Quellregistrierung verwendet wird.

az acr task create -n hello-world -r myregistry --cmd '$Registry/myimage' -c /dev/null --source-acr-auth-id [system]
    --assign-identity [system] "/subscriptions/<subscriptionId>/resourcegroups/<myResourceGroup>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<myUserAssignedIdentitiy>"

Erforderliche Parameter

--name -n

Der Name des Vorgangs.

--registry -r

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--agent-pool

Vorschau

Der Name des Agentpools.

--arg

Erstellen Sie das Argument im Format "--arg name[=value]". Vielfache werden durch mehrfaches Übergeben von "---arg name[=value]" unterstützt. WICHTIG: Dieser Parameter sollte keine Kennwörter, Zugriffstoken oder vertrauliche Informationen jeglicher Art enthalten. Dieser Parameterwert ist für das ACR-Team für Debuggingzwecke sichtbar.

--assign-identity

Weisen Sie der Aufgabe verwaltete Identitäten zu. Verwenden Sie "[System]", um auf die vom System zugewiesene Identität oder eine Ressourcen-ID zu verweisen, um auf eine vom Benutzer zugewiesene Identität zu verweisen. Weitere Informationen finden Sie unter https://aka.ms/acr/tasks/task-create-managed-identity.

--auth-mode

Authentifizierungsmodus der Quellregistrierung.

Eigenschaft	Wert
Zulässige Werte:	Default, None

--base-image-trigger-enabled

Gibt an, ob der Basisbildtrigger aktiviert ist.

Eigenschaft	Wert
Parameter group:	Trigger Arguments
Standardwert:	True
Zulässige Werte:	false, true

--base-image-trigger-name

Der Name des Basisbildtriggers.

Eigenschaft	Wert
Parameter group:	Trigger Arguments
Standardwert:	defaultBaseimageTriggerName

--base-image-trigger-type

Der Typ des automatischen Triggers für Basisimageabhängigkeitsupdates.

Eigenschaft	Wert
Parameter group:	Trigger Arguments
Standardwert:	Runtime
Zulässige Werte:	All, Runtime

--cmd

Auszuführende Befehle. Dies unterstützt auch zusätzliche Docker-Ausführungsparameter (https://docs.docker.com/engine/reference/commandline/run/) oder sogar andere Docker-Befehle (https://docs.docker.com/engine/reference/commandline/docker/).

--commit-trigger-enabled

Gibt an, ob der Committrigger der Quellcodeverwaltung aktiviert ist.

Eigenschaft	Wert
Parameter group:	Trigger Arguments
Standardwert:	True
Zulässige Werte:	false, true

--context -c

Die vollständige URL zum Quellcode-Repository (erfordert das Suffix ".git" für ein GitHub-Repository) oder einen Remote-Tarball (z. B. "http://server/context.tar.gz") oder das Repository eines OCI-Artefaktes in einer Azure-Containerregistrierung (z. B. "oci://myregistry.azurecr.io/myartifact:mytag"). Wenn "/dev/null" angegeben ist, wird der Wert auf "None" festgelegt und ignoriert. Dies ist ein erforderliches Argument, wenn es sich bei der Aufgabe nicht um eine Systemaufgabe handelt.

--cpu

Die CPU-Konfiguration in Bezug auf die Anzahl der für die Ausführung erforderlichen Kerne.

Eigenschaft	Wert
Standardwert:	2

--file -f

Relativer Pfad der Task/Docker-Datei zum Stammordner des Quellcodes. Aufgabendateien müssen mit '.yaml' oder aus der Standardeingabe mit '-' weitergeleitet werden.

--git-access-token

Das Zugriffstoken, das für den Zugriff auf den Quellcodeverwaltungsanbieter verwendet wird.

Eigenschaft	Wert
Parameter group:	Trigger Arguments

--image -t

Der Name und das Tag des Bilds mit dem Format "-t repo/image:tag". Mehrere Tags werden unterstützt, indem -t mehrmals übergeben werden.

--is-system-task

Vorschau

Gibt an, ob es sich bei der Vorgangsressource um einen Systemvorgang handelt. Der Name des Vorgangs muss "quicktask" sein. Gilt nur für cmK-aktivierte Registrierung.

Eigenschaft	Wert
Standardwert:	False

--log-template

Vorschau

Die Repository- und Tagvorlage zum Ausführen des Protokollartefaktes mit dem Format "log/repo:tag" (z. B. "acr/logs:{{.Run.ID}}"). Gilt nur für cmK-aktivierte Registrierung.

--no-cache

Gibt an, ob der Bildcache aktiviert ist.

Eigenschaft	Wert
Standardwert:	False
Zulässige Werte:	false, true

--no-push

Gibt an, ob das erstellte Image an die Registrierung übertragen werden soll.

Eigenschaft	Wert
Standardwert:	False
Zulässige Werte:	false, true

--platform

Die Plattform, auf der Build/Aufgabe ausgeführt wird, z. B. "Windows" und "linux". Wenn sie in Buildbefehlen verwendet wird, kann sie auch im Format "os/arch/variant" für das resultierende Bild angegeben werden. Eg, linux/arm/v7. Die Teile "Bogen" und "Variante" sind optional.

--pull-request-trigger-enabled

Gibt an, ob der Pull-Anforderungstrigger der Quellcodeverwaltung aktiviert ist. Der Trigger ist standardmäßig deaktiviert.

Eigenschaft	Wert
Parameter group:	Trigger Arguments
Standardwert:	False
Zulässige Werte:	false, true

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--schedule

Zeitplan für einen Timertrigger, der als Cron-Ausdruck dargestellt wird. Ein optionaler Triggername kann mit --schedule name:schedule Format angegeben werden. Vielfache, die von mehrfacher Übergabe von "-schedule" unterstützt werden.

Eigenschaft	Wert
Parameter group:	Trigger Arguments

--secret-arg

Secret build argument in '--secret-arg name[=value]' format. Vielfache werden durch mehrfaches Übergeben von "---secret-arg name[=value]" unterstützt. Dieser Parameterwert wird nicht für das ACR-Team angezeigt und eignet sich besser für vertrauliche Informationen.

--set

Vorgangswert im Format "--set name[=value]" Vielfache, die durch mehrfaches Übergeben von "-set" unterstützt werden.

--set-secret

Geheimer Aufgabenwert im Format "--set-secret name[=value]". Vielfache, die durch mehrfaches Übergeben von "-set-secret" unterstützt werden.

--source-acr-auth-id

Vorschau

Weisen Sie die verwaltete Identität zu, die für die Quellregistrierungsanmeldung verwendet wird. Verwenden Sie "[System]", um auf die vom System zugewiesene Identität oder eine Ressourcen-ID zu verweisen, um auf eine vom Benutzer zugewiesene verwaltete Identität zu verweisen.

--source-trigger-name

Der Name des Quelltriggers.

Eigenschaft	Wert
Parameter group:	Trigger Arguments
Standardwert:	defaultSourceTriggerName

--status

Der aktuelle Status der Aufgabe.

Eigenschaft	Wert
Standardwert:	Enabled
Zulässige Werte:	Disabled, Enabled

--target

Der Name der Zielbuildphase.

--timeout

Das Timeout in Sekunden.

Eigenschaft	Wert
Standardwert:	3600

--update-trigger-endpoint

Vorschau

Die vollständige URL des Endpunkts zum Empfangen von Basisbildaktualisierungstriggerbenachrichtigungen.

Eigenschaft	Wert
Parameter group:	Trigger Arguments

--update-trigger-payload-type

Vorschau

Gibt an, ob Metadaten über den Basisbildtrigger zusammen mit dem Updatetriggertoken in die Nutzlast eingeschlossen werden sollen, wenn eine Benachrichtigung gesendet wird.

Eigenschaft	Wert
Parameter group:	Trigger Arguments
Standardwert:	Default
Zulässige Werte:	Default, Token

--values

Der Dateipfad für Vorgangswerte/Parameter relativ zum Quellkontext.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Output format.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az acr task delete

Bearbeiten

Löschen sie eine Aufgabe aus einer Azure-Containerregistrierung.

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

Beispiele

Löschen sie eine Aufgabe aus einer Azure-Containerregistrierung.

az acr task delete -n MyTask -r myregistry

Erforderliche Parameter

--name -n

Der Name des Vorgangs.

--registry -r

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--yes -y

Zur Bestätigung nicht auffordern.

Eigenschaft	Wert
Standardwert:	False

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Output format.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az acr task list

Bearbeiten

Listen Sie die Aufgaben für eine Azure-Containerregistrierung auf.

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

Beispiele

Listen Sie Aufgaben auf, und zeigen Sie die Ergebnisse in einer Tabelle an.

az acr task list -r myregistry -o table

Erforderliche Parameter

--registry -r

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Output format.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az acr task list-runs

Bearbeiten

Auflisten aller ausgeführten Ausführungen für eine Azure-Containerregistrierung mit der Möglichkeit, nach einer bestimmten Aufgabe zu filtern.

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

Beispiele

Listet alle Ausführungen für eine Registrierung auf, und zeigen Sie die Ergebnisse in einer Tabelle an.

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

Die Liste wird für eine Aufgabe ausgeführt und zeigt die Ergebnisse in einer Tabelle an.

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

Listet die letzten 10 erfolgreichen Ausführungen für eine Registrierung auf und zeigt die Ergebnisse in einer Tabelle an.

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

Listet alle Ausgeführten auf, die das Bild "hello-world" für eine Registrierung erstellt haben, und zeigen Sie die Ergebnisse in einer Tabelle an.

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

Erforderliche Parameter

--registry -r

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--image -t

Der Name des Bilds. Kann ein Tag im Format "name:tag" oder Digest im Format "name@digest" enthalten.

--name -n

Der Name des Vorgangs.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--run-status

Der aktuelle Status der Ausführung.

Eigenschaft	Wert
Zulässige Werte:	Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout

--top

Beschränken Sie die Anzahl der letzten Ausführungen in den Ergebnissen.

Eigenschaft	Wert
Standardwert:	15

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Output format.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az acr task logs

Bearbeiten

Anzeigen von Protokollen für eine bestimmte Ausführung. Wenn keine Ausführungs-ID angegeben wird, zeigen Sie Protokolle für die letzte erstellte Ausführung an.

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

Beispiele

Protokolle für die letzte erstellte Ausführung in der Registrierung anzeigen.

az acr task logs -r myregistry

Zeigt Protokolle für die letzte erstellte Ausführung in der Registrierung an, gefiltert nach Aufgabe.

az acr task logs -r myregistry -n MyTask

Anzeigen von Protokollen für eine bestimmte Ausführung.

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

Zeigt Protokolle für die letzte erstellte Ausführung in der Registrierung an, die das Image "hello-world" erstellt hat.

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

Erforderliche Parameter

--registry -r

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--image -t

Der Name des Bilds. Kann ein Tag im Format "name:tag" oder Digest im Format "name@digest" enthalten.

--name -n

Der Name des Vorgangs.

--no-format

Gibt an, ob die Protokolle im unformatierten Format angezeigt werden sollen.

Eigenschaft	Wert
Standardwert:	False

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--run-id

Der eindeutige Ausführungsbezeichner.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Output format.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az acr task run

Bearbeiten

Lösen Sie manuell eine Aufgabe aus, die andernfalls auf Git Commits oder Basisimageaktualisierungstrigger wartet.

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]

Beispiele

Auslösen einer Aufgabenausführung.

az acr task run -n MyTask -r myregistry

Lösen Sie eine Aufgabe aus, die ausgeführt wird, indem Sie den Kontext und die Datei außer Kraft setzen, die während der Aufgabenerstellung mit einem Remote-Repository übergeben wird.

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

Lösen Sie eine Aufgabe aus, die ausgeführt wird, indem Sie den Kontext und die Datei außer Kraft setzen, die während der Aufgabenerstellung mit einem lokalen Kontext übergeben wird.

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

Lösen Sie eine Aufgabe aus, indem Sie buildargumente hinzufügen oder überschreiben, die während der Erstellung von Aufgaben festgelegt wurden.

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

Erforderliche Parameter

--name -n

Der Name des Vorgangs.

--registry -r

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--agent-pool

Vorschau

Der Name des Agentpools.

--arg

--context -c

--file -f

Relativer Pfad der Task/Docker-Datei zum Stammordner des Quellcodes. Aufgabendateien müssen mit '.yaml' oder aus der Standardeingabe mit '-' weitergeleitet werden.

--log-template

Vorschau

Die Repository- und Tagvorlage zum Ausführen des Protokollartefaktes mit dem Format "log/repo:tag" (z. B. "acr/logs:{{.Run.ID}}"). Gilt nur für cmK-aktivierte Registrierung.

--no-format

Gibt an, ob die Protokolle im unformatierten Format angezeigt werden sollen.

Eigenschaft	Wert
Standardwert:	False

--no-logs

Zeigen Sie keine Protokolle nach dem erfolgreichen Anstellen des Builds an.

Eigenschaft	Wert
Standardwert:	False

--no-wait

Warten Sie nicht, bis die Ausführung abgeschlossen ist, und kehren Sie unmittelbar nach dem Beenden der Ausführung zurück.

Eigenschaft	Wert
Standardwert:	False

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--secret-arg

--set

Vorgangswert im Format "--set name[=value]" Vielfache, die durch mehrfaches Übergeben von "-set" unterstützt werden.

--set-secret

Geheimer Aufgabenwert im Format "--set-secret name[=value]". Vielfache, die durch mehrfaches Übergeben von "-set-secret" unterstützt werden.

--target

Der Name der Zielbuildphase.

--update-trigger-token

Vorschau

Die Nutzlast, die zusammen mit der Basisbildtriggerbenachrichtigung zurückgesendet wird.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Output format.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az acr task show

Bearbeiten

Dient zum Abrufen der Eigenschaften einer benannten Aufgabe für eine Azure-Containerregistrierung.

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

Beispiele

Dient zum Abrufen der Eigenschaften eines Vorgangs, wobei die Ergebnisse in einer Tabelle angezeigt werden.

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

Dient zum Abrufen der Eigenschaften einer Aufgabe, einschließlich sicherer Eigenschaften.

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

Erforderliche Parameter

--name -n

Der Name des Vorgangs.

--registry -r

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--with-secure-properties

Gibt an, ob die sicheren Eigenschaften einer Aufgabe zurückgegeben werden sollen.

Eigenschaft	Wert
Standardwert:	False

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Output format.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az acr task show-run

Bearbeiten

Dient zum Abrufen der Eigenschaften einer angegebenen Ausführung einer Azure-Containerregistrierungsaufgabe.

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

Beispiele

Rufen Sie die Details einer Ausführung ab, und zeigen Sie die Ergebnisse in einer Tabelle an.

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

Erforderliche Parameter

--registry -r

--run-id

Der eindeutige Ausführungsbezeichner.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Output format.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az acr task update

Bearbeiten

Aktualisieren sie eine Aufgabe für eine Azure-Containerregistrierung.

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]
                   [--source-acr-auth-id]
                   [--status {Disabled, Enabled}]
                   [--target]
                   [--timeout]
                   [--update-trigger-endpoint]
                   [--update-trigger-payload-type {Default, Token}]
                   [--values]

Beispiele

Aktualisieren Sie Basisimageupdates, um alle abhängigen Images einer mehrstufigen Dockerfile-Datei und den Status einer Aufgabe in einer Azure-Containerregistrierung auszulösen.

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

Updateplattform für den Buildschritt Ihrer Aufgabe auf Windows (prev Linux).

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

Aktualisieren Sie die Trigger und den Kontext der Aufgabe für eine Azure-Containerregistrierung.

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

Aktualisieren sie eine Aufgabe für eine Azure-Containerregistrierung. (autogenerated)

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

Aktualisieren Sie die Aufgabe mithilfe der vom System zugewiesenen verwalteten Identität für die Authentifizierung mit der Quellregistrierung in der Azure-Containerregistrierung.

az acr task update -n MyTask -r myregistry --source-acr-auth-id [system]

Aktualisieren Sie die Aufgabe mithilfe der vom Benutzer zugewiesenen verwalteten Identität für die Authentifizierung mit der Quellregistrierung in der Azure-Containerregistrierung.

az acr task update -n MyTask -r myregistry --source-acr-auth-id "/subscriptions/<subscriptionId>/resourcegroups/<myResourceGroup>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<myUserAssignedIdentitiy>"

Erforderliche Parameter

--name -n

Der Name des Vorgangs.

--registry -r

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--agent-pool

Vorschau

Der Name des Agentpools.

--arg

--auth-mode

Authentifizierungsmodus der Quellregistrierung.

Eigenschaft	Wert
Zulässige Werte:	Default, None

--base-image-trigger-enabled

Gibt an, ob der Basisbildtrigger aktiviert ist.

Eigenschaft	Wert
Parameter group:	Trigger Arguments
Zulässige Werte:	false, true

--base-image-trigger-type

Der Typ des automatischen Triggers für Basisimageabhängigkeitsupdates.

Eigenschaft	Wert
Parameter group:	Trigger Arguments
Zulässige Werte:	All, Runtime

--cmd

--commit-trigger-enabled

Gibt an, ob der Committrigger der Quellcodeverwaltung aktiviert ist.

Eigenschaft	Wert
Parameter group:	Trigger Arguments
Zulässige Werte:	false, true

--context -c

--cpu

Die CPU-Konfiguration in Bezug auf die Anzahl der für die Ausführung erforderlichen Kerne.

--file -f

Relativer Pfad der Task/Docker-Datei zum Stammordner des Quellcodes. Aufgabendateien müssen mit '.yaml' oder aus der Standardeingabe mit '-' weitergeleitet werden.

--git-access-token

Das Zugriffstoken, das für den Zugriff auf den Quellcodeverwaltungsanbieter verwendet wird.

Eigenschaft	Wert
Parameter group:	Trigger Arguments

--image -t

Der Name und das Tag des Bilds mit dem Format "-t repo/image:tag". Mehrere Tags werden unterstützt, indem -t mehrmals übergeben werden.

--log-template

Vorschau

Die Repository- und Tagvorlage zum Ausführen des Protokollartefaktes mit dem Format "log/repo:tag" (z. B. "acr/logs:{{.Run.ID}}"). Gilt nur für cmK-aktivierte Registrierung.

--no-cache

Gibt an, ob der Bildcache aktiviert ist.

Eigenschaft	Wert
Zulässige Werte:	false, true

--no-push

Gibt an, ob das erstellte Image an die Registrierung übertragen werden soll.

Eigenschaft	Wert
Zulässige Werte:	false, true

--platform

--pull-request-trigger-enabled

Gibt an, ob der Pull-Anforderungstrigger der Quellcodeverwaltung aktiviert ist. Der Trigger ist standardmäßig deaktiviert.

Eigenschaft	Wert
Parameter group:	Trigger Arguments
Zulässige Werte:	false, true

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--secret-arg

--set

Vorgangswert im Format "--set name[=value]" Vielfache, die durch mehrfaches Übergeben von "-set" unterstützt werden.

--set-secret

Geheimer Aufgabenwert im Format "--set-secret name[=value]". Vielfache, die durch mehrfaches Übergeben von "-set-secret" unterstützt werden.

--source-acr-auth-id

Vorschau

--status

Der aktuelle Status der Aufgabe.

Eigenschaft	Wert
Zulässige Werte:	Disabled, Enabled

--target

Der Name der Zielbuildphase.

--timeout

Das Timeout in Sekunden.

--update-trigger-endpoint

Vorschau

Die vollständige URL des Endpunkts zum Empfangen von Basisbildaktualisierungstriggerbenachrichtigungen.

Eigenschaft	Wert
Parameter group:	Trigger Arguments

--update-trigger-payload-type

Vorschau

Gibt an, ob Metadaten über den Basisbildtrigger zusammen mit dem Updatetriggertoken in die Nutzlast eingeschlossen werden sollen, wenn eine Benachrichtigung gesendet wird.

Eigenschaft	Wert
Parameter group:	Trigger Arguments
Zulässige Werte:	Default, Token

--values

Der Dateipfad für Vorgangswerte/Parameter relativ zum Quellkontext.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Output format.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az acr task update-run

Bearbeiten

Patchen Sie die Ausführungseigenschaften einer Azure-Containerregistrierungsaufgabe.

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

Beispiele

Aktualisieren Sie eine vorhandene Ausführung, die archiviert werden soll.

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

Erforderliche Parameter

--registry -r

--run-id

Der eindeutige Ausführungsbezeichner.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--no-archive

Gibt an, ob die Ausführung archiviert werden soll.

Eigenschaft	Wert
Zulässige Werte:	false, true

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Output format.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

Freigeben über

az acr task

Befehle

az acr task cancel-run

Beispiele

Erforderliche Parameter

Optionale Parameter

az acr task create

Beispiele

Erforderliche Parameter

Optionale Parameter

az acr task delete

Beispiele

Erforderliche Parameter

Optionale Parameter

az acr task list

Beispiele

Erforderliche Parameter

Optionale Parameter

az acr task list-runs

Beispiele

Erforderliche Parameter

Optionale Parameter

az acr task logs

Beispiele

Erforderliche Parameter

Optionale Parameter

az acr task run

Beispiele

Erforderliche Parameter

Optionale Parameter

az acr task show

Beispiele

Erforderliche Parameter

Optionale Parameter

az acr task show-run

Beispiele

Erforderliche Parameter

Optionale Parameter

az acr task update

Beispiele

Erforderliche Parameter

Optionale Parameter

az acr task update-run

Beispiele

Erforderliche Parameter

Optionale Parameter

Feedback