Feedback

az acr task

  • Referenz

Verwalten Sie eine Sammlung von Schritten zum Erstellen, Testen und Patchen von Containerimages im Betriebssystemframework & mithilfe von Azure ContainerRegistries.

Befehle

az acr task cancel-run

Abbrechen einer angegebenen Ausführung eines Azure Container Registry.
az acr task create

Erstellen Sie eine Reihe von Schritten zum Erstellen, Testen und Installieren von Patchcontainern für Os & Framework. Aufgaben unterstützen Trigger von Git Commits und Basisimageupdates.
az acr task credential

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

Fügen Sie der Aufgabe eine benutzerdefinierte Registrierungsanmeldeinformationen hinzu.
az acr task credential list

Listet alle benutzerdefinierten Registrierungsanmeldeinformationen für die Aufgabe auf.
az acr task credential remove

Entfernen Sie Anmeldeinformationen für eine Aufgabe.
az acr task credential update

Aktualisieren sie die Anmeldeinformationen für eine Aufgabe.
az acr task delete

Löschen Sie eine Aufgabe aus einem Azure Container Registry.
az acr task identity

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

Aktualisieren der verwalteten Identität für einen Vorgang.
az acr task identity remove

Entfernen von verwalteten Identitäten für eine Aufgabe.
az acr task identity show

Zeigen Sie die verwalteten Identitäten für die Aufgabe an.
az acr task list

Listet die Aufgaben für eine Azure Container Registry auf.
az acr task list-runs

Listet alle ausgeführten Ausführungen für eine Azure Container Registry auf, wobei die Möglichkeit besteht, nach einer bestimmten Aufgabe zu filtern.
az acr task logs

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

Lösen Sie eine Aufgabe manuell aus, die andernfalls auf Git-Commits oder Basisbildupdates wartet.
az acr task show

Rufen Sie die Eigenschaften einer benannten Aufgabe für eine Azure Container Registry ab.
az acr task show-run

Rufen Sie die Eigenschaften einer angegebenen Ausführung eines Azure Container Registry Vorgangs ab.
az acr task timer

Verwalten sie Zeitgeberauslöser für einen Vorgang.
az acr task timer add

Fügen Sie einem Vorgang einen Zeitgeberauslöser hinzu.
az acr task timer list

Alle Timerauslöser für einen Vorgang auflisten.
az acr task timer remove

Entfernen Sie einen Zeitgeberauslöser aus einer Aufgabe.
az acr task timer update

Aktualisieren Sie den Zeitgeberauslöser für einen Vorgang.
az acr task update

Aktualisieren einer Aufgabe für eine Azure Container Registry.
az acr task update-run

Patchen Sie die Ausführungseigenschaften eines Azure Container Registry Vorgangs.

az acr task cancel-run

Bearbeiten

Abbrechen einer angegebenen Ausführung eines Azure Container Registry.

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. Es sollte in Kleinschreibung angegeben werden. Sie können den Standardregistrierungsnamen mithilfe az configure --defaults acr=<registry name>von .

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

az acr task create

Bearbeiten

Erstellen Sie eine Reihe von Schritten zum Erstellen, Testen und Installieren von Patchcontainern für Os & 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-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 Zeitgeberauslöser, der die Aufgabe oben in jeder Stunde mit dem Standardauslösernamen 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-Bild 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 einem bestimmten Zweig eines privaten Azure DevOps-Repositorys, das das Hello-World-Image auf Arm-Architektur (V7 Variant) 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 mit aktiviertem Git-Commit und Pull-Anforderungsauslöser erstellt. Beachten Sie, dass diese Aufgabe keine Quellregistrierung (MyRegistry) verwendet, sodass wir den Auth-Modus 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 amd64-Architektur erstellt, wobei nur Basisbildauslöser 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 Linux-Mehrschrittaufgabe aus einem öffentlichen GitHub-Repository mit systemzuweisungen und vom Benutzer zugewiesenen verwalteten Identitäten und Basisimages, git commit, Pull-Anforderung und Timerauslöser, die die Aufgabe am Montag bis Freitag mit dem angegebenen Zeitgeberauslösernamen 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 Aufgabe.

--registry -r

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

Optionale Parameter

--agent-pool

Der Name des Agentpools.

--arg

Build-Argument im Format '--arg name[=value]'. Mehrere Von "--arg" unterstützte Mehrfache.

--assign-identity

Weist verwaltete Identitäten dem Vorgang 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

Auth-Modus der Quellregistrierung.

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

Gibt an, ob der Basisbildauslöser aktiviert ist.

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

Der Name des Basisbildauslösers.

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

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

Zulässige Werte: All, Runtime
Standardwert: Runtime
--cmd

Befehle, die ausgeführt werden sollen. Dies unterstützt auch zusätzliche Docker-Ausführungsparameter () oder sogar andere Docker-Befehle (https://docs.docker.com/engine/reference/commandline/run/https://docs.docker.com/engine/reference/commandline/docker/).

--commit-trigger-enabled

Gibt an, ob der Quellsteuerelement-Commit-Trigger aktiviert ist.

Zulässige Werte: false, true
Standardwert: 1
--context -c

Die vollständige URL zum Quellcode-Repository (Erfordert ".git"-Suffix für ein Github-Repo) oder einen Remote-Tarball (z. B. "'") oder das Repository eines OCI-Artefaktes in einer Azure-Containerregistrierung (zhttp://server/context.tar.gz. B. "oci://myregistry.azurecr.io/myartifact:mytag"). Wenn "/dev/null" angegeben wird, wird der Wert auf "Keine" festgelegt und ignoriert. Dies ist ein erforderliches Argument, wenn die Aufgabe keine Systemaufgabe ist.

--cpu

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

Standardwert: 2
--file -f

Relativer Pfad der Aufgaben-/Docker-Datei zum Quellcodestammordner. Aufgabendateien müssen mit '.yaml' oder über die Standardeingabe mit '-' weitergeleitet werden.

--git-access-token

Das Zugriffstoken, das zum Zugreifen auf den Quellsteuerungsanbieter verwendet wird.

--image -t

Der Name und das Tag des Bilds mithilfe des Formats: "-t repo/image:tag". Mehrere Tags werden durch Übergeben von -t mehrmals unterstützt.

--is-system-task

Gibt an, ob die Aufgabenressource eine Systemaufgabe ist. Der Name der Aufgabe muss "Quicktask" sein. Gilt nur für die aktivierte CMK-Registrierung.

--log-template

Die Repository- und Tagvorlage für das Ausführen des Protokollartefakts mithilfe des Formats: 'log/repo:tag' (z. B. 'acr/logs:{{.Run.ID}}'). Gilt nur für die aktivierte CMK-Registrierung.

--no-cache

Gibt an, ob der Bildcache aktiviert ist.

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

Gibt an, ob das erstellte Bild an die Registrierung verschoben werden soll.

Zulässige Werte: false, true
--platform

Die Plattform, auf der Build/Task 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 "Variant" sind optional.

--pull-request-trigger-enabled

Gibt an, ob der Quellsteuerelement-Pull-Anforderungsauslöser 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.

--schedule

Planen Sie einen Zeitgeberauslöser, der als Cronausdruck dargestellt wird. Ein optionaler Triggername kann mithilfe --schedule name:schedule des Formats angegeben werden. Mehrfache, die von der Übergabe von "-zeitplan" unterstützt werden.

--secret-arg

Geheimes Buildargument im Format '--secret-secret-arg name[=value]'. Mehrfache, die durch übergebene --secret-arg unterstützt werden.

--set

Vorgangswert im Format '-set name[=value]' Mehrfache, die von der Übergabe von "-set" unterstützt werden.

--set-secret

Geheimer Vorgangswert im Format '-set-set-secret name[=value]'. Mehrfache, die durch Übergeben von --set-secret unterstützt werden.

--source-trigger-name

Der Name des Quellauslösers.

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

Die vollständige URL des Endpunkts zum Empfangen von Basisbildaktualisierungsauslöserbenachrichtigungen.

--update-trigger-payload-type

Gibt an, ob Metadaten zum Basisbildauslöser in die Nutzlast einbezogen werden sollen, zusammen mit dem Updateauslösertoken, wenn eine Benachrichtigung gesendet wird.

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

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

az acr task delete

Bearbeiten

Löschen Sie eine Aufgabe aus einem Azure Container Registry.

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

Beispiele

Löschen Sie eine Aufgabe aus einem Azure Container Registry.

az acr task delete -n MyTask -r MyRegistry

Erforderliche Parameter

--name -n

Der Name der Aufgabe.

--registry -r

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

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

az acr task list

Bearbeiten

Listet die Aufgaben für eine Azure Container Registry 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. Es sollte in Kleinschreibung angegeben werden. Sie können den Standardregistrierungsnamen mithilfe az configure --defaults acr=<registry name>von .

Optionale Parameter

--resource-group -g

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

az acr task list-runs

Bearbeiten

Listet alle ausgeführten Ausführungen für eine Azure Container Registry auf, wobei die Möglichkeit besteht, 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 zeigt 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

Listen Sie die letzten 10 erfolgreichen Ausführungen für eine Registrierung auf, und zeigen Sie die Ergebnisse in einer Tabelle an.

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

Listet alle Ausführungen 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. Es sollte in Kleinschreibung angegeben werden. Sie können den Standardregistrierungsnamen mithilfe az configure --defaults acr=<registry name>von .

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

--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 neuesten Ausführungen in den Ergebnissen.

Standardwert: 15

az acr task logs

Bearbeiten

Anzeigen von Protokollen für eine bestimmte Ausführung. Wenn keine Ausführungs-ID bereitgestellt 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

Anzeigen von Protokollen für die letzte erstellte Ausführung in der Registrierung.

az acr task logs -r MyRegistry

Anzeigen von Protokollen für die letzte erstellte Ausführung in der Registrierung, 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

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

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

Erforderliche Parameter

--registry -r

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

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

--no-format

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

--resource-group -g

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

--run-id

Der eindeutige Ausführungsbezeichner.

az acr task run

Bearbeiten

Lösen Sie einen Vorgang manuell aus, der andernfalls auf Git Commits oder Basisimageupdatetrigger 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 Vorgangsausführung.

az acr task run -n MyTask -r MyRegistry

Auslösen einer Aufgabe, die ausgeführt wird, indem sie den Kontext und die Datei außer Kraft setzen, die während der Erstellung der Aufgabe 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

Auslösen einer Aufgabe, die ausgeführt wird, indem sie den Kontext und die Datei außer Kraft setzen, die während der Erstellung von Vorgängen mit einem lokalen Kontext übergeben wird.

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

Lösen Sie eine Aufgabe aus, die ausgeführt wird, indem Sie während der Erstellung von Aufgaben Argumente hinzufügen oder außer Kraft setzen.

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

--registry -r

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

Optionale Parameter

--agent-pool

Der Name des Agentpools.

--arg

Build-Argument im Format '--arg name[=value]'. Mehrere Von "--arg" unterstützte Mehrfache.

--context -c

Die vollständige URL zum Quellcode-Repository (Erfordert ".git"-Suffix für ein Github-Repo) oder einen Remote-Tarball (z. B. "'") oder das Repository eines OCI-Artefaktes in einer Azure-Containerregistrierung (zhttp://server/context.tar.gz. B. "oci://myregistry.azurecr.io/myartifact:mytag"). Wenn "/dev/null" angegeben wird, wird der Wert auf "Keine" festgelegt und ignoriert. Dies ist ein erforderliches Argument, wenn die Aufgabe keine Systemaufgabe ist.

--file -f

Relativer Pfad der Aufgaben-/Docker-Datei zum Quellcodestammordner. Aufgabendateien müssen mit '.yaml' oder über die Standardeingabe mit '-' weitergeleitet werden.

--log-template

Die Repository- und Tagvorlage für das Ausführen des Protokollartefakts mithilfe des Formats: 'log/repo:tag' (z. B. 'acr/logs:{{.Run.ID}}'). Gilt nur für die aktivierte CMK-Registrierung.

--no-format

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

--no-logs

Zeigen Sie keine Protokolle nach erfolgreicher Warteschlange des Builds an.

--no-wait

Warten Sie nicht, bis die Ausführung abgeschlossen ist und sofort nach dem Abwarten der Ausführung zurückgegeben wird.

--resource-group -g

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

--secret-arg

Geheimes Buildargument im Format '--secret-secret-arg name[=value]'. Mehrfache, die durch übergebene --secret-arg unterstützt werden.

--set

Vorgangswert im Format '-set name[=value]' Mehrfache, die von der Übergabe von "-set" unterstützt werden.

--set-secret

Geheimer Vorgangswert im Format '-set-set-secret name[=value]'. Mehrfache, die durch Übergeben von --set-secret unterstützt werden.

--target

Der Name der Zielbuildphase.

--update-trigger-token

Die Nutzlast, die zusammen mit der Basisbildauslöserbenachrichtigung zurückgegibt wird.

az acr task show

Bearbeiten

Rufen Sie die Eigenschaften einer benannten Aufgabe für eine Azure Container Registry ab.

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

Beispiele

Rufen Sie die Eigenschaften einer Aufgabe ab, und zeigen Sie die Ergebnisse in einer Tabelle an.

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

Rufen Sie die Eigenschaften einer Aufgabe ab, einschließlich sicherer Eigenschaften.

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

Erforderliche Parameter

--name -n

Der Name der Aufgabe.

--registry -r

Der Name der Containerregistrierung. Es 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 eines Vorgangs zurückgegeben werden sollen.

az acr task show-run

Bearbeiten

Rufen Sie die Eigenschaften einer angegebenen Ausführung eines Azure Container Registry Vorgangs ab.

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

az acr task update

Bearbeiten

Aktualisieren einer Aufgabe für eine Azure Container Registry.

az acr task update --name
                   --registry
                   [--agent-pool]
                   [--arg]
                   [--auth-mode {Default, None}]
                   [--base-image-trigger-enabled {false, true}]
                   [--base-image-trigger-type {All, Runtime}]
                   [--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 Bilder einer mehrstufigen Dockerfile-Datei und den Status einer Aufgabe in einem Azure Container Registry 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 Auslöser und den Kontext einer aufgabe für eine Azure Container Registry.

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

Aktualisieren einer Aufgabe für eine Azure Container Registry. (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 Aufgabe.

--registry -r

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

Optionale Parameter

--agent-pool

Der Name des Agentpools.

--arg

Build-Argument im Format '--arg name[=value]' Multiples, 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
--commit-trigger-enabled

Gibt an, ob der Committrigger für die Quellcodeverwaltung aktiviert ist.

Zulässige Werte: false, true
--context -c

Die vollständige URL zum Quellcode-Repository (Erfordert ".git" Suffix für ein GitHub-Repo) 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 die Aufgabe keine Systemaufgabe ist.

--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 mithilfe des Formats: "-t repo/image:tag". Mehrere Tags werden durch mehrfaches Übergeben von -t unterstützt.

--log-template

Die Repository- und Tagvorlage zum Ausführen des Protokollartefakts mit dem Format "log/repo:tag" (z. B. "acr/logs:{{.Run.ID}}"). Gilt nur für die aktivierte CMK-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/task 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. Z. B. linux/arm/v7. Die Teile "Bogen" und "Variante" sind optional.

--pull-request-trigger-enabled

Gibt an, ob der Pull-Trigger 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

Geheimes Buildargument im Format '--secret-arg name[=value]' Multiples, die durch das Übergeben von --secret-arg mehrmals unterstützt werden.

--set

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

--set-secret

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

--status

Der aktuelle Status des Vorgangs.

Zulässige Werte: Disabled, Enabled
--target

Der Name der Zielbuildphase.

--timeout

Das Timeout in Sekunden.

--update-trigger-endpoint

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

--update-trigger-payload-type

Gibt an, ob Metadaten über den Basisbildauslöser in der Nutzlast zusammen mit dem Updatetriggertoken eingeschlossen werden sollen, wenn eine Benachrichtigung gesendet wird.

Zulässige Werte: Default, Token
--values

Der Dateipfad der Vorgangswerte/Parameter relativ zum Quellkontext.

az acr task update-run

Bearbeiten

Patchen Sie die Ausführungseigenschaften eines Azure Container Registry Vorgangs.

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