az acr task

Een verzameling stappen beheren voor het bouwen, testen en & Framework voor het patchen van containerafbeeldingen met behulp van Azure-containerregisters.

Opdracht

az acr task cancel-run

Annuleer een opgegeven run van een Azure Container Registry.

az acr task create

Maak een reeks stappen voor het bouwen, testen en & Framework-patchcontainers. Taken ondersteunen triggers van git-commits en updates van basisafbeeldingen.

az acr task credential

Referenties voor een taak beheren. Zie https://aka.ms/acr/tasks/cross-registry-authentication voor meer informatie.

az acr task credential add

Voeg een aangepaste aanmeldingsreferentie voor het register toe aan de taak.

az acr task credential list

Alle aangepaste registerreferenties voor taak.

az acr task credential remove

Verwijder de referenties voor een taak.

az acr task credential update

Werk de aanmeldingsreferenties voor het register bij voor een taak.

az acr task delete

Verwijder een taak uit een Azure Container Registry.

az acr task identity

Beheerde identiteiten voor taak. Zie https://aka.ms/acr/tasks/task-create-managed-identity voor meer informatie.

az acr task identity assign

Werk de beheerde identiteit voor een taak bij.

az acr task identity remove

Beheerde identiteiten voor een taak verwijderen.

az acr task identity show

De beheerde identiteiten voor de taak weergeven.

az acr task list

De taken voor een Azure Container Registry.

az acr task list-runs

Vermeld alle uitgevoerde uitvoeringen voor een Azure Container Registry, met de mogelijkheid om te filteren op een specifieke taak.

az acr task logs

Logboeken voor een bepaalde run tonen. Als er geen run-id is opgegeven, toont u logboeken voor de laatste gemaakte run.

az acr task run

Activeer handmatig een taak die anders mogelijk wacht op git-commits of updatetriggers voor basisafbeeldingen.

az acr task show

De eigenschappen van een benoemde taak voor een Azure Container Registry.

az acr task show-run

Haal de eigenschappen op van een opgegeven run van een Azure Container Registry taak.

az acr task timer

Timertriggers voor een taak beheren.

az acr task timer add

Voeg een timertrigger toe aan een taak.

az acr task timer list

Vermeld alle timertriggers voor een taak.

az acr task timer remove

Verwijder een timertrigger uit een taak.

az acr task timer update

Werk de timertrigger voor een taak bij.

az acr task update

Werk een taak bij voor een Azure Container Registry.

az acr task update-run

Patch de run-eigenschappen van een Azure Container Registry taak.

az acr task cancel-run

Annuleer een opgegeven run van een Azure Container Registry.

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

Voorbeelden

Een run annuleren

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

Vereiste parameters

--registry -r

De naam van het containerregister. U kunt de standaardregisternaam configureren met az configure --defaults acr=<registry name> behulp van .

--run-id

De unieke run-id.

Optionele parameters

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .

az acr task create

Maak een reeks stappen voor het bouwen, testen en & Framework-patchcontainers. Taken ondersteunen triggers van git-commits en updates van basisafbeeldingen.

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}]
                   [--subscription]
                   [--target]
                   [--timeout]
                   [--update-trigger-endpoint]
                   [--update-trigger-payload-type {Default, Token}]
                   [--values]

Voorbeelden

Maak een taak zonder de bronlocatie.

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

Maak een taak met de definitie van de standaardinvoer en met een timertrigger die de taak boven aan elk uur met behulp van de standaardtriggernaam wordt uitgevoerd. Met Ctrl + Z(Windows) of Ctrl + D(Linux) wordt de invoerstroom beëindigd.

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

Maak een Linux-taak vanuit een openbare GitHub die de hello-world-afbeelding bouwt zonder triggers en een build-argument gebruikt.

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

Maak een Linux-taak met behulp van een specifieke vertakking van een persoonlijke Azure DevOps-opslagplaats die de hello-world-afbeelding bouwt in de Arm-architectuur (V7-variant) en triggers heeft ingeschakeld.

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

Maak een Linux-taak vanuit een openbare GitHub opslagplaats die de hello-world-afbeelding bouwt met zowel een git-commit- als een pull-aanvraagtrigger ingeschakeld. Houd er rekening mee dat deze taak geen bronregister (MyRegistry) gebruikt, dus we kunnen de auth-modus expliciet instellen als Geen.

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

Maak een Windows-taak vanuit een openbare GitHub opslagplaats die de Azure Container Builder-afbeelding bouwt op amd64-architectuur met alleen trigger voor basisafbeeldingen ingeschakeld.

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

Maak een Linux-taak met meerdere stappen vanuit een openbare GitHub-opslagplaats met zowel door het systeem toegewezen als door de gebruiker toegewezen beheerde identiteiten en basisinstallatie afbeelding, git-commit, pull-aanvraag en timertriggers die de taak 's middags op maandag tot en met vrijdag uitvoeren met de naam van de timertrigger.

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

Vereiste parameters

--name -n

De naam van de taak.

--registry -r

De naam van het containerregister. U kunt de standaardregisternaam configureren met az configure --defaults acr=<registry name> behulp van .

Optionele parameters

--agent-pool

De naam van de agentpool.

--arg

Build-argument in de indeling '--arg name[=value]'. Veelvouden die worden ondersteund door '--arg' meerdere keren door te geven.

--assign-identity

Wijst beheerde identiteiten toe aan de taak. Gebruik [system] om te verwijzen naar de door het systeem toegewezen identiteit of een resource-id om te verwijzen naar een door de gebruiker toegewezen identiteit. Zie https://aka.ms/acr/tasks/task-create-managed-identity voor meer informatie.

--auth-mode

De auth-modus van het bronregister.

geaccepteerde waarden: Default, None
--base-image-trigger-enabled

Geeft aan of de trigger voor de basisafbeelding is ingeschakeld.

geaccepteerde waarden: false, true
standaardwaarde: 1
--base-image-trigger-name

De naam van de trigger voor de basisafbeelding.

standaardwaarde: defaultBaseimageTriggerName
--base-image-trigger-type

Het type van de automatische trigger voor updates van afhankelijkheid van basisafbeeldingen.

geaccepteerde waarden: All, Runtime
standaardwaarde: Runtime
--cmd

Opdrachten die moeten worden uitgevoerd.

--commit-trigger-enabled

Geeft aan of de trigger voor het doorschakelen van broncodebeheer is ingeschakeld.

geaccepteerde waarden: false, true
standaardwaarde: 1
--context -c

De volledige URL naar de broncodeopslagplaats (vereist het achtervoegsel '.git' voor een GitHub-opslagplaats) of de opslagplaats van een OCI-artefact in een Azure-containerregister (bijvoorbeeld 'oci://myregistry.azurecr.io/myartifact:mytag'). Als '/dev/null' is opgegeven, wordt de waarde ingesteld op Geen en genegeerd. Dit is een vereist argument als de taak geen systeemtaak is.

--cpu

De CPU-configuratie in termen van het aantal kernen dat is vereist voor de uitvoering.

standaardwaarde: 2
--file -f

Relatief pad van het taak-/docker-bestand naar de hoofdmap van de broncode. Taakbestanden moeten worden voorzien van het achtervoegsel '.yaml' of worden doorgespijpt uit de standaardinvoer met behulp van '-'.

--git-access-token

Het toegangs token dat wordt gebruikt voor toegang tot de broncodebeheerprovider.

--image -t

De naam en tag van de afbeelding met de volgende indeling: '-t repo/image:tag'. Meerdere tags worden ondersteund door -t meerdere keren door te geven.

--is-system-task

Geeft aan of de taakresource een systeemtaak is. De naam van de taak moet 'quicktask' zijn. Alleen van toepassing op register met CMK ingeschakeld.

--log-template

De opslagplaats en tagsjabloon voor het uitvoeren van logboekartefacten met de volgende indeling: 'log/repo:tag' (bijvoorbeeld 'acr/logs:{{. Run.ID}}'). Alleen van toepassing op register met CMK ingeschakeld.

--no-cache

Geeft aan of de afbeeldingscache is ingeschakeld.

geaccepteerde waarden: false, true
--no-push

Geeft aan of de gebouwde afbeelding naar het register moet worden pushen.

geaccepteerde waarden: false, true
--platform

Het platform waarop de build/taak wordt uitgevoerd, bijvoorbeeld 'windows' en 'linux'. Wanneer deze wordt gebruikt in build-opdrachten, kan deze ook worden opgegeven in de indeling 'os/arch/variant' voor de resulterende afbeelding. Bijvoorbeeld linux/arm/v7. De delen 'arch' en 'variant' zijn optioneel.

--pull-request-trigger-enabled

Geeft aan of de trigger voor pull-aanvragen voor broncodebeheer is ingeschakeld. De trigger is standaard uitgeschakeld.

geaccepteerde waarden: false, true
--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

--schedule

Planning voor een timertrigger die wordt weergegeven als een Cron-expressie. Een optionele triggernaam kan worden opgegeven met behulp van --schedule name:schedule indeling. Veelvouden die worden ondersteund door --schedule meerdere keren door te geven.

--secret-arg

Het argument secret build in de indeling '--secret-arg name[=value]'. Veelvouden die worden ondersteund door --secret-arg meerdere keren door te geven.

--set

Taakwaarde in de indeling '--set name[=value]'. Veelvouden die worden ondersteund door --set meerdere keren door te geven.

--set-secret

Geheime taakwaarde in indeling '--set-secret name[=value]'. Veelvouden die worden ondersteund door --set-secret meerdere keren door te geven.

--source-trigger-name

De naam van de brontrigger.

standaardwaarde: defaultSourceTriggerName
--status

De huidige status van de taak.

geaccepteerde waarden: Disabled, Enabled
standaardwaarde: Enabled
--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .

--target

De naam van de doel-buildfase.

--timeout

De time-out in seconden.

standaardwaarde: 3600
--update-trigger-endpoint

De volledige URL van het eindpunt voor het ontvangen van triggermeldingen over het bijwerken van basisafbeeldingen.

--update-trigger-payload-type

Geeft aan of metagegevens over de trigger van de basisafbeelding moeten worden toegevoegd aan de nettolading naast het token voor de updatetrigger wanneer er een melding wordt verzonden.

geaccepteerde waarden: Default, Token
standaardwaarde: Default
--values

Het bestandspad voor taakwaarden/parameters ten opzichte van de broncontext.

az acr task delete

Verwijder een taak uit een Azure Container Registry.

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

Voorbeelden

Verwijder een taak uit een Azure Container Registry.

az acr task delete -n MyTask -r MyRegistry

Vereiste parameters

--name -n

De naam van de taak.

--registry -r

De naam van het containerregister. U kunt de standaardregisternaam configureren met az configure --defaults acr=<registry name> behulp van .

Optionele parameters

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .

--yes -y

Niet vragen om bevestiging.

az acr task list

De taken voor een Azure Container Registry.

az acr task list --registry
                 [--query-examples]
                 [--resource-group]
                 [--subscription]

Voorbeelden

Taken opsnabelen en de resultaten in een tabel tonen.

az acr task list -r MyRegistry -o table

Vereiste parameters

--registry -r

De naam van het containerregister. U kunt de standaardregisternaam configureren met az configure --defaults acr=<registry name> behulp van .

Optionele parameters

--query-examples

JMESPath-tekenreeks voor u aanbevelen. U kunt een van de query's kopiƫren en deze na de parameter --query tussen dubbele aanhalingstekens plakken om de resultaten te bekijken. U kunt een of meer positionele trefwoorden toevoegen, zodat we suggesties kunnen geven op basis van deze sleutelwoorden.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .

az acr task list-runs

Vermeld alle uitgevoerde uitvoeringen voor een Azure Container Registry, met de mogelijkheid om te filteren op een specifieke taak.

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

Voorbeelden

Een lijst met alle runs voor een register en de resultaten in een tabel.

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

Lijst wordt uitgevoerd voor een taak en de resultaten worden weergegeven in een tabel.

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

Vermeld de laatste tien geslaagde runs voor een register en laat de resultaten in een tabel zien.

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

Een lijst maken van alle runs die de afbeelding 'hello-world' voor een register hebben gebouwd en de resultaten in een tabel tonen.

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

Vereiste parameters

--registry -r

De naam van het containerregister. U kunt de standaardregisternaam configureren met az configure --defaults acr=<registry name> behulp van .

Optionele parameters

--image -t

De naam van de afbeelding. Kan een tag bevatten in de notatie 'name:tag' of digest in de notatie name@digest ''.

--name -n

De naam van de taak.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name> .

--run-status

De huidige status van de run.

geaccepteerde waarden: Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout
--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .

--top

Beperk het aantal meest recente runs in de resultaten.

standaardwaarde: 15

az acr task logs

Logboeken voor een bepaalde run tonen. Als er geen run-id is opgegeven, toont u logboeken voor de laatste gemaakte run.

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

Voorbeelden

Logboeken voor de laatst gemaakte run in het register.

az acr task logs -r MyRegistry

Logboeken voor de laatst gemaakte run in het register, gefilterd op taak.

az acr task logs -r MyRegistry -n MyTask

Logboeken voor een bepaalde run tonen.

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

Logboeken tonen voor de laatst gemaakte run in het register waarin de -afbeelding 'hello-world' is gebouwd.

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

Vereiste parameters

--registry -r

De naam van het containerregister. U kunt de standaardregisternaam configureren met az configure --defaults acr=<registry name> behulp van .

Optionele parameters

--image -t

De naam van de afbeelding. Kan een tag bevatten in de notatie 'name:tag' of digest in de notatie name@digest ''.

--name -n

De naam van de taak.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name> .

--run-id

De unieke run-id.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .

az acr task run

Activeer handmatig een taak die anders mogelijk wacht op git-commits of updatetriggers voor basisafbeeldingen.

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

Voorbeelden

Een taak uitvoeren activeren.

az acr task run -n MyTask -r MyRegistry

Activeer een taak die wordt uitgevoerd door de context en het bestand te overschrijven die zijn doorgegeven tijdens het maken van de taak met een externe opslagplaats.

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

Activeer een taak die wordt uitgevoerd door de context en het bestand te overschrijven die zijn doorgegeven tijdens het maken van de taak met een lokale context.

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

Activeer een taak die wordt uitgevoerd door buildargumenten toe te voegen of te overschrijven die tijdens het maken van de taak zijn ingesteld.

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

Vereiste parameters

--name -n

De naam van de taak.

--registry -r

De naam van het containerregister. U kunt de standaardregisternaam configureren met az configure --defaults acr=<registry name> behulp van .

Optionele parameters

--agent-pool

De naam van de agentpool.

--arg

Build-argument in de indeling '--arg name[=value]'. Veelvouden die worden ondersteund door '--arg' meerdere keren door te geven.

--context -c

De volledige URL naar de broncodeopslagplaats (vereist het achtervoegsel '.git' voor een GitHub-opslagplaats) of de opslagplaats van een OCI-artefact in een Azure-containerregister (bijvoorbeeld 'oci://myregistry.azurecr.io/myartifact:mytag'). Als '/dev/null' is opgegeven, wordt de waarde ingesteld op Geen en genegeerd. Dit is een vereist argument als de taak geen systeemtaak is.

--file -f

Relatief pad van het taak-/docker-bestand naar de hoofdmap van de broncode. Taakbestanden moeten worden voorzien van het achtervoegsel '.yaml' of worden doorspijpt vanuit de standaardinvoer met behulp van '-'.

--log-template

De opslagplaats en tagsjabloon voor het uitvoeren van logboekartefacten in de indeling: 'log/repo:tag' (bijvoorbeeld 'acr/logs:{{. Run.ID}}'). Alleen van toepassing op register met CMK ingeschakeld.

--no-logs

Geen logboeken tonen na het in de wachtrij zetten van de build.

--no-wait

Wacht niet tot de run is voltooid en keer direct terug nadat u de run in de wachtrij hebt staan.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name> .

--secret-arg

Geheim build-argument in de indeling '--secret-arg name[=value]'. Veelvouden die worden ondersteund door --secret-arg meerdere keren door te geven.

--set

Taakwaarde in de indeling '--set name[=value]'. Veelvouden die worden ondersteund door --set meerdere keren door te geven.

--set-secret

Geheime taakwaarde in de indeling '--set-secret name[=value]'. Veelvouden die worden ondersteund door --set-secret meerdere keren door te geven.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .

--target

De naam van de doel-buildfase.

--update-trigger-token

De nettolading die wordt doorgegeven samen met de triggermelding van de basisafbeelding.

az acr task show

De eigenschappen van een benoemde taak voor een Azure Container Registry.

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

Voorbeelden

Haal de eigenschappen van een taak op en geef de resultaten in een tabel weer.

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

Haal de eigenschappen van een taak op, inclusief beveiligde eigenschappen.

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

Vereiste parameters

--name -n

De naam van de taak.

--registry -r

De naam van het containerregister. U kunt de standaardregisternaam configureren met az configure --defaults acr=<registry name> behulp van .

Optionele parameters

--query-examples

JMESPath-tekenreeks voor u aanbevelen. U kunt een van de query's kopiƫren en plakken na de parameter --query tussen dubbele aanhalingstekens om de resultaten te bekijken. U kunt een of meer positionele trefwoorden toevoegen, zodat we suggesties kunnen geven op basis van deze sleutelwoorden.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name> .

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .

--with-secure-properties

Geeft aan of de beveiligde eigenschappen van een taak moeten worden geretourneerd.

az acr task show-run

Haal de eigenschappen op van een opgegeven run van een Azure Container Registry taak.

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

Voorbeelden

Haal de details van een run op en geef de resultaten in een tabel weer.

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

Vereiste parameters

--registry -r

De naam van het containerregister. U kunt de standaardregisternaam configureren met az configure --defaults acr=<registry name> behulp van .

--run-id

De unieke run-id.

Optionele parameters

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name> .

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .

az acr task update

Werk een taak bij voor een 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}]
                   [--subscription]
                   [--target]
                   [--timeout]
                   [--update-trigger-endpoint]
                   [--update-trigger-payload-type {Default, Token}]
                   [--values]

Voorbeelden

Updates van basisafbeeldingen bijwerken om te activeren op alle afhankelijke afbeeldingen van een dockerfile met meerdere fases en de status van een taak in een Azure Container Registry.

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

Werk het platform bij voor de buildstap van uw taak naar Windows (prev Linux).

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

Werk de triggers en context van een taak bij voor een 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

Werk een taak bij voor een Azure Container Registry. (automatisch gegenereerd)

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

Vereiste parameters

--name -n

De naam van de taak.

--registry -r

De naam van het containerregister. U kunt de standaardregisternaam configureren met az configure --defaults acr=<registry name> behulp van .

Optionele parameters

--agent-pool

De naam van de agentpool.

--arg

Build-argument in de indeling '--arg name[=value]'. Veelvouden die worden ondersteund door '--arg' meerdere keren door te geven.

--auth-mode

Auth-modus van het bronregister.

geaccepteerde waarden: Default, None
--base-image-trigger-enabled

Geeft aan of de trigger voor de basisafbeelding is ingeschakeld.

geaccepteerde waarden: false, true
--base-image-trigger-type

Het type van de automatische trigger voor updates van afhankelijkheid van basisafbeeldingen.

geaccepteerde waarden: All, Runtime
--commit-trigger-enabled

Geeft aan of de trigger voor het doorschakelen van broncodebeheer is ingeschakeld.

geaccepteerde waarden: false, true
--context -c

De volledige URL naar de broncodeopslagplaats (vereist het achtervoegsel '.git' voor een GitHub-opslagplaats) of de opslagplaats van een OCI-artefact in een Azure-containerregister (bijvoorbeeld 'oci://myregistry.azurecr.io/myartifact:mytag'). Als '/dev/null' is opgegeven, wordt de waarde ingesteld op Geen en genegeerd. Dit is een vereist argument als de taak geen systeemtaak is.

--cpu

De CPU-configuratie in termen van het aantal kernen dat is vereist voor de uitvoering.

--file -f

Relatief pad van het taak-/docker-bestand naar de hoofdmap van de broncode. Taakbestanden moeten worden voorzien van het achtervoegsel '.yaml' of worden doorgespijpt uit de standaardinvoer met behulp van '-'.

--git-access-token

Het toegangs token dat wordt gebruikt voor toegang tot de broncodebeheerprovider.

--image -t

De naam en tag van de afbeelding met de volgende indeling: '-t repo/image:tag'. Meerdere tags worden ondersteund door -t meerdere keren door te geven.

--log-template

De opslagplaats en tagsjabloon voor het uitvoeren van logboekartefacten met de volgende indeling: 'log/repo:tag' (bijvoorbeeld 'acr/logs:{{. Run.ID}}'). Alleen van toepassing op register met CMK ingeschakeld.

--no-cache

Geeft aan of de afbeeldingscache is ingeschakeld.

geaccepteerde waarden: false, true
--no-push

Geeft aan of de gebouwde afbeelding naar het register moet worden pushen.

geaccepteerde waarden: false, true
--platform

Het platform waarop de build/taak wordt uitgevoerd, bijvoorbeeld 'windows' en 'linux'. Wanneer deze wordt gebruikt in build-opdrachten, kan deze ook worden opgegeven in de indeling 'os/arch/variant' voor de resulterende afbeelding. Bijvoorbeeld linux/arm/v7. De delen 'boog' en 'variant' zijn optioneel.

--pull-request-trigger-enabled

Geeft aan of de trigger voor pull-aanvragen voor broncodebeheer is ingeschakeld. De trigger is standaard uitgeschakeld.

geaccepteerde waarden: false, true
--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

--secret-arg

Het argument secret build in de indeling '--secret-arg name[=value]'. Veelvouden die worden ondersteund door --secret-arg meerdere keren door te geven.

--set

Taakwaarde in de indeling '--set name[=value]'. Veelvouden die worden ondersteund door --set meerdere keren door te geven.

--set-secret

Geheime taakwaarde in indeling '--set-secret name[=value]'. Veelvouden die worden ondersteund door --set-secret meerdere keren door te geven.

--status

De huidige status van de taak.

geaccepteerde waarden: Disabled, Enabled
--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .

--target

De naam van de doel-buildfase.

--timeout

De time-out in seconden.

--update-trigger-endpoint

De volledige URL van het eindpunt voor het ontvangen van triggermeldingen over het bijwerken van basisafbeeldingen.

--update-trigger-payload-type

Geeft aan of metagegevens over de trigger van de basisafbeelding moeten worden toegevoegd aan de nettolading naast het token voor de updatetrigger wanneer er een melding wordt verzonden.

geaccepteerde waarden: Default, Token
--values

Het bestandspad voor taakwaarden/parameters ten opzichte van de broncontext.

az acr task update-run

Patch de run-eigenschappen van een Azure Container Registry taak.

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

Voorbeelden

Werk een bestaande run bij om te worden gearchiveerd.

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

Vereiste parameters

--registry -r

De naam van het containerregister. U kunt de standaardregisternaam configureren met az configure --defaults acr=<registry name> behulp van .

--run-id

De unieke run-id.

Optionele parameters

--no-archive

Geeft aan of de run moet worden gearchiveerd.

geaccepteerde waarden: false, true
--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .