az acr task

  • Referenz

Verwalten Sie eine Sammlung von Schritten zum Erstellen, Testen und Patchen von Containerimages mit Os & Framework mithilfe von Azure ContainerRegistries.

Befehle

Name Beschreibung Typ Status
az acr task cancel-run

Abbrechen einer angegebenen Ausführung einer Azure-Containerregistrierung.

 Core Allgemein verfügbar
az acr task create

Erstellen Sie eine Reihe von Schritten zum Erstellen, Testen und Patchen von Betriebssystem- und Framework-Containern. Aufgaben unterstützen Trigger von Git Commits und Basisimageupdates.

 Core Allgemein verfügbar
az acr task credential

Verwalten von Anmeldeinformationen für eine Aufgabe. Unter https://aka.ms/acr/tasks/cross-registry-authentication finden Sie weitere Informationen.

 Core Allgemein verfügbar
az acr task credential add

Fügen Sie der Aufgabe eine benutzerdefinierte Anmeldeinformationen für die Registrierung hinzu.

 Core Allgemein verfügbar
az acr task credential list

Listet alle benutzerdefinierten Registrierungsanmeldeinformationen für die Aufgabe auf.

 Core Allgemein verfügbar
az acr task credential remove

Entfernen sie Anmeldeinformationen für eine Aufgabe.

 Core Allgemein verfügbar
az acr task credential update

Aktualisieren Sie die Anmeldeinformationen für die Registrierung für eine Aufgabe.

 Core Allgemein verfügbar
az acr task delete

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

 Core Allgemein verfügbar
az acr task identity

Verwaltete Identitäten für Aufgabe. Unter https://aka.ms/acr/tasks/task-create-managed-identity finden Sie weitere Informationen.

 Core Allgemein verfügbar
az acr task identity assign

Aktualisieren sie die verwaltete Identität für eine Aufgabe.

 Core Allgemein verfügbar
az acr task identity remove

Entfernt verwaltete Identitäten für eine Aufgabe.

 Core Allgemein verfügbar
az acr task identity show

Anzeigen der verwalteten Identitäten für die Aufgabe.

 Core Allgemein verfügbar
az acr task list

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

 Core Allgemein verfügbar
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 Allgemein verfügbar
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 Allgemein verfügbar
az acr task run

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

 Core Allgemein verfügbar
az acr task show

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

 Core Allgemein verfügbar
az acr task show-run

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

 Core Allgemein verfügbar
az acr task timer

Verwalten von Zeitgebertriggern für einen Vorgang.

 Core Allgemein verfügbar
az acr task timer add

Fügen Sie einem Vorgang einen Timertrigger hinzu.

 Core Allgemein verfügbar
az acr task timer list

Listet alle Timertrigger für eine Aufgabe auf.

 Core Allgemein verfügbar
az acr task timer remove

Entfernen Sie einen Timertrigger aus einer Aufgabe.

 Core Allgemein verfügbar
az acr task timer update

Aktualisieren Sie den Timertrigger für einen Vorgang.

 Core Allgemein verfügbar
az acr task update

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

 Core Allgemein verfügbar
az acr task update-run

Patchen Sie die Ausführungseigenschaften einer Azure-Containerregistrierungsaufgabe.

 Core Allgemein verfügbar

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

--run-id

Der eindeutige Ausführungsbezeichner.

Optionale Parameter

--resource-group -g

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az acr task create

Bearbeiten

Erstellen Sie eine Reihe von Schritten zum Erstellen, Testen und Patchen von Betriebssystem- und Framework-Containern. 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-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, Pullanforderung 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>"

Erforderliche Parameter

--name -n

Der Name der Projektaufgabe.

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

Optionale Parameter

--agent-pool
Vorschau

Der Name des Agentpools.

--arg

Erstellen Sie das Argument im Format "--arg name[=value]". Vielfache, die durch mehrfaches Übergeben von "--arg" unterstützt werden.

--assign-identity

Weist 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. Unter https://aka.ms/acr/tasks/task-create-managed-identity finden Sie weitere Informationen.

--auth-mode

Authentifizierungsmodus der Quellregistrierung.

Zulässige Werte: Default, None
--base-image-trigger-enabled

Gibt an, ob der Basisbildtrigger aktiviert ist.

Zulässige Werte: false, true
Standardwert: True
--base-image-trigger-name

Der Name des Basisbildtriggers.

Standardwert: defaultBaseimageTriggerName
--base-image-trigger-type

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

Zulässige Werte: All, Runtime
Standardwert: 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.

Zulässige Werte: false, true
Standardwert: 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.

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.

--image -t

Der Name und das Tag des Bilds mit dem Format "-t repo/image:tag". Mehrere Tags werden durch mehrfaches Übergeben von -t unterstützt.

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

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.

Zulässige Werte: false, true
Standardwert: False
--no-push

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

Zulässige Werte: false, true
Standardwert: False
--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. Beispiel: 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.

Zulässige Werte: false, true
Standardwert: False
--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 mithilfe des --schedule name:schedule Formats angegeben werden. Vielfache, die von mehrfacher Übergabe von "-schedule" unterstützt werden.

--secret-arg

Secret build argument in '--secret-arg name[=value]' format. Vielfache, die durch mehrfaches Übergeben von "--secret-arg" unterstützt werden.

--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-trigger-name

Der Name des Quelltriggers.

Standardwert: defaultSourceTriggerName
--status

Der aktuelle Status der Aufgabe.

Zulässige Werte: Disabled, Enabled
Standardwert: Enabled
--target

Der Name der Zielbuildphase.

--timeout

Das Timeout in Sekunden.

Standardwert: 3600
--update-trigger-endpoint
Vorschau

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

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

Zulässige Werte: Default, Token
Standardwert: Default
--values

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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 der Projektaufgabe.

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

Optionale Parameter

--resource-group -g

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

--yes -y

Nicht zur Bestätigung auffordern

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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

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

Optionale Parameter

--resource-group -g

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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

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

Optionale Parameter

--image -t

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

--name -n

Der Name der Projektaufgabe.

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

Zulässige Werte: Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout
--top

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

Standardwert: 15
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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

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

Optionale Parameter

--image -t

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

--name -n

Der Name der Projektaufgabe.

--no-format

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

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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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 Remoterepository ü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 der Projektaufgabe.

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

Optionale Parameter

--agent-pool
Vorschau

Der Name des Agentpools.

--arg

Erstellen Sie das Argument im Format "--arg name[=value]". Vielfache, die durch mehrfaches Übergeben von "--arg" unterstützt werden.

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

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

Standardwert: False
--no-logs

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

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.

Standardwert: False
--resource-group -g

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

--secret-arg

Secret build argument in '--secret-arg name[=value]' format. Vielfache, die durch mehrfaches Übergeben von "--secret-arg" unterstützt werden.

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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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 der Projektaufgabe.

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

Optionale Parameter

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

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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

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

--run-id

Der eindeutige Ausführungsbezeichner.

Optionale Parameter

--resource-group -g

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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]
                   [--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. (automatisch generiert)

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

Erforderliche Parameter

--name -n

Der Name der Projektaufgabe.

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

Optionale Parameter

--agent-pool
Vorschau

Der Name des Agentpools.

--arg

Erstellen Sie das Argument im Format "--arg name[=value]". Vielfache, die durch mehrfaches Übergeben von "--arg" unterstützt werden.

--auth-mode

Authentifizierungsmodus der Quellregistrierung.

Zulässige Werte: Default, None
--base-image-trigger-enabled

Gibt an, ob der Basisbildtrigger aktiviert ist.

Zulässige Werte: false, true
--base-image-trigger-type

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

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.

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.

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

--image -t

Der Name und das Tag des Bilds mit dem Format "-t repo/image:tag". Mehrere Tags werden durch mehrfaches Übergeben von -t unterstützt.

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

Zulässige Werte: false, true
--no-push

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

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. Beispiel: 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.

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

Secret build argument in '--secret-arg name[=value]' format. Vielfache, die durch mehrfaches Übergeben von "--secret-arg" unterstützt werden.

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

--status

Der aktuelle Status der Aufgabe.

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.

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

Zulässige Werte: Default, Token
--values

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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

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

--run-id

Der eindeutige Ausführungsbezeichner.

Optionale Parameter

--no-archive

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

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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.