az acr task

Beheer een verzameling stappen voor het bouwen, testen en patchen van containerinstallatiekopieën van OS & Framework met behulp van Azure ContainerRegistries.

Opdracht

Name	Description	Type	Status
az acr task cancel-run	Annuleer een opgegeven uitvoering van een Azure Container Registry.	Basis	GA
az acr task create	Maak een reeks stappen voor het bouwen, testen en patchen van OS & Framework-containers. Taken ondersteunen triggers van Git-doorvoeringen en updates van basisinstallatiekopieën.	Basis	GA
az acr task credential	Referenties voor een taak beheren. Zie https://aka.ms/acr/tasks/cross-registry-authentication voor meer informatie.	Basis	GA
az acr task credential add	Voeg een aangepaste aanmeldingsreferentie voor het register toe aan de taak.	Basis	GA
az acr task credential list	Geef alle aangepaste registerreferenties voor de taak weer.	Basis	GA
az acr task credential remove	Referenties voor een taak verwijderen.	Basis	GA
az acr task credential update	Werk de aanmeldingsreferentie voor het register voor een taak bij.	Basis	GA
az acr task delete	Een taak verwijderen uit een Azure Container Registry.	Basis	GA
az acr task identity	Beheerde identiteiten voor taak. Zie https://aka.ms/acr/tasks/task-create-managed-identity voor meer informatie.	Basis	GA
az acr task identity assign	Werk de beheerde identiteit voor een taak bij.	Basis	GA
az acr task identity remove	Beheerde identiteiten voor een taak verwijderen.	Basis	GA
az acr task identity show	De beheerde identiteiten voor de taak weergeven.	Basis	GA
az acr task list	Geef de taken voor een Azure Container Registry weer.	Basis	GA
az acr task list-runs	Vermeld alle uitgevoerde uitvoeringen voor een Azure Container Registry, met de mogelijkheid om te filteren op een specifieke taak.	Basis	GA
az acr task logs	Logboeken weergeven voor een bepaalde uitvoering. Als er geen run-id is opgegeven, moet u logboeken weergeven voor de laatst gemaakte uitvoering.	Basis	GA
az acr task run	Activeer handmatig een taak die anders wacht op git-doorvoeringen of triggers voor het bijwerken van basisinstallatiekopieën.	Basis	GA
az acr task show	Haal de eigenschappen van een benoemde taak op voor een Azure Container Registry.	Basis	GA
az acr task show-run	Haal de eigenschappen op van een opgegeven uitvoering van een Azure Container Registry-taak.	Basis	GA
az acr task timer	Timertriggers voor een taak beheren.	Basis	GA
az acr task timer add	Voeg een timertrigger toe aan een taak.	Basis	GA
az acr task timer list	Alle timertriggers voor een taak weergeven.	Basis	GA
az acr task timer remove	Een timertrigger verwijderen uit een taak.	Basis	GA
az acr task timer update	Werk de timertrigger voor een taak bij.	Basis	GA
az acr task update	Een taak voor een Azure Container Registry bijwerken.	Basis	GA
az acr task update-run	Patch de uitvoeringseigenschappen van een Azure Container Registry-taak.	Basis	GA

az acr task cancel-run

Annuleer een opgegeven uitvoering van een Azure Container Registry.

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

Voorbeelden

Een uitvoering annuleren

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

Vereiste parameters

--registry -r

De naam van het containerregister. Deze moet in kleine letters worden opgegeven. U kunt de standaardregisternaam configureren met behulp van az configure --defaults acr=<registry name>.

--run-id

De unieke uitvoerings-id.

Optionele parameters

--resource-group -g

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

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

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

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az acr task create

Maak een reeks stappen voor het bouwen, testen en patchen van OS & Framework-containers. Taken ondersteunen triggers van Git-doorvoeringen en updates van basisinstallatiekopieën.

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]

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 uitvoert met behulp van de standaardtriggernaam. 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-opslagplaats waarmee de hallo wereldinstallatiekopie wordt gebouwd zonder triggers en een buildargument wordt 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 privé-Azure DevOps-opslagplaats die de hello-world-installatiekopie in Arm-architectuur (V7-variant) bouwt 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 waarmee de installatiekopie van de hallo wereld wordt gebouwd, waarbij zowel een Git-doorvoer- als een pull-aanvraagtrigger is ingeschakeld. Houd er rekening mee dat deze taak geen bronregister (myregistry) gebruikt, zodat we de verificatiemodus expliciet kunnen instellen als Geen voor deze taak.

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 op basis van een openbare GitHub-opslagplaats die de Azure Container Builder-installatiekopieën bouwt op Amd64-architectuur, waarbij alleen de trigger voor basisinstallatiekopieën is 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 de basisinstallatiekopie, git commit, pull-aanvraag en timertriggers die de taak op maandag tot en met vrijdag uitvoeren met de opgegeven timertriggernaam.

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. Deze moet in kleine letters worden opgegeven. U kunt de standaardregisternaam configureren met behulp van az configure --defaults acr=<registry name>.

Optionele parameters

--agent-pool

Preview

De naam van de agentgroep.

--arg

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

--assign-identity

Hiermee worden beheerde identiteiten aan de taak toegewezen. 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

Verificatiemodus van het bronregister.

geaccepteerde waarden: Default, None

--base-image-trigger-enabled

Geeft aan of de trigger voor de basisinstallatiekopieën is ingeschakeld.

geaccepteerde waarden: false, true

standaardwaarde: True

--base-image-trigger-name

De naam van de trigger voor de basisinstallatiekopieën.

standaardwaarde: defaultBaseimageTriggerName

--base-image-trigger-type

Het type automatische trigger voor updates van afhankelijkheden van basisinstallatiekopieën.

geaccepteerde waarden: All, Runtime

standaardwaarde: Runtime

--cmd

Opdrachten die moeten worden uitgevoerd. Dit biedt ook ondersteuning voor aanvullende docker-uitvoeringsparameters (https://docs.docker.com/engine/reference/commandline/run/) of zelfs andere docker-opdrachten (https://docs.docker.com/engine/reference/commandline/docker/).

--commit-trigger-enabled

Geeft aan of de doorvoertrigger voor broncodebeheer is ingeschakeld.

geaccepteerde waarden: false, true

standaardwaarde: True

--context -c

De volledige URL naar de opslagplaats voor broncode (vereist achtervoegsel '.git' voor een github-opslagplaats) of een externe tarball (bijvoorbeeld 'http://server/context.tar.gz'), 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 verplicht argument als de taak geen systeemtaak is.

--cpu

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

standaardwaarde: 2

--file -f

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

--git-access-token

Het toegangstoken dat wordt gebruikt voor toegang tot de bronbeheerprovider.

--image -t

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

--is-system-task

Preview

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

standaardwaarde: False

--log-template

Preview

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

--no-cache

Geeft aan of de afbeeldingscache is ingeschakeld.

geaccepteerde waarden: false, true

standaardwaarde: False

--no-push

Geeft aan of de gemaakte installatiekopie naar het register moet worden gepusht.

geaccepteerde waarden: false, true

standaardwaarde: False

--platform

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

--pull-request-trigger-enabled

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

geaccepteerde waarden: false, true

standaardwaarde: False

--resource-group -g

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

--schedule

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

--secret-arg

Argument voor geheim bouwen in de notatie '--secret-arg name[=value]'. Veelvouden die worden ondersteund door meerdere keren door te geven --secret-arg.

--set

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

--set-secret

Geheime taakwaarde in de notatie '--set-secret name[=value]'. Veelvouden die meerdere keren worden ondersteund door --set-secret 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

--target

De naam van de doelbuildfase.

--timeout

De time-out in seconden.

standaardwaarde: 3600

--update-trigger-endpoint

Preview

De volledige URL van het eindpunt voor het ontvangen van triggermeldingen voor het bijwerken van basisinstallatiekopieën.

--update-trigger-payload-type

Preview

Geeft aan of metagegevens over de trigger van de basisinstallatiekopieën moeten worden opgenomen in de nettolading, samen met 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.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

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

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az acr task delete

Een taak verwijderen uit een Azure Container Registry.

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

Voorbeelden

Een taak verwijderen 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. Deze moet in kleine letters worden opgegeven. U kunt de standaardregisternaam configureren met behulp van az configure --defaults acr=<registry name>.

Optionele parameters

--resource-group -g

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

--yes -y

Niet vragen om bevestiging.

standaardwaarde: False

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

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

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az acr task list

Geef de taken voor een Azure Container Registry weer.

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

Voorbeelden

Taken weergeven en de resultaten weergeven in een tabel.

az acr task list -r myregistry -o table

Vereiste parameters

--registry -r

De naam van het containerregister. Deze moet in kleine letters worden opgegeven. U kunt de standaardregisternaam configureren met behulp van az configure --defaults acr=<registry name>.

Optionele parameters

--resource-group -g

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

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

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

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

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}]
                      [--top]

Voorbeelden

Geef alle uitvoeringen voor een register weer en geef de resultaten weer in een tabel.

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

Lijstuitvoeringen voor een taak en de resultaten in een tabel weergeven.

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

Vermeld de laatste tien geslaagde uitvoeringen voor een register en geef de resultaten weer in een tabel.

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

Vermeld alle uitvoeringen die de installatiekopie 'hello-world' voor een register hebben gemaakt en de resultaten in een tabel weergeven.

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

Vereiste parameters

--registry -r

De naam van het containerregister. Deze moet in kleine letters worden opgegeven. U kunt de standaardregisternaam configureren met behulp van az configure --defaults acr=<registry name>.

Optionele parameters

--image -t

De naam van de afbeelding. Kan een tag bevatten in de indeling 'name:tag' of digest in de indeling '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 uitvoering.

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

--top

Beperk het aantal meest recente uitvoeringen in de resultaten.

standaardwaarde: 15

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

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

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az acr task logs

Logboeken weergeven voor een bepaalde uitvoering. Als er geen run-id is opgegeven, moet u logboeken weergeven voor de laatst gemaakte uitvoering.

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

Voorbeelden

Logboeken weergeven voor de laatst gemaakte uitvoering in het register.

az acr task logs -r myregistry

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

az acr task logs -r myregistry -n MyTask

Logboeken weergeven voor een bepaalde uitvoering.

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

Logboeken weergeven voor de laatst gemaakte uitvoering in het register waarmee de installatiekopie 'hello-world' is gemaakt.

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

Vereiste parameters

--registry -r

De naam van het containerregister. Deze moet in kleine letters worden opgegeven. U kunt de standaardregisternaam configureren met behulp van az configure --defaults acr=<registry name>.

Optionele parameters

--image -t

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

--name -n

De naam van de taak.

--no-format

Geeft aan of de logboeken in onbewerkte indeling moeten worden weergegeven.

standaardwaarde: False

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

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

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

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az acr task run

Activeer handmatig een taak die anders wacht op git-doorvoeringen of triggers voor het bijwerken van basisinstallatiekopieën.

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]

Voorbeelden

Een taakuitvoering activeren.

az acr task run -n MyTask -r myregistry

Activeer een taak die wordt uitgevoerd door de context en het bestand te overschrijven dat is doorgegeven tijdens het maken van een 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 dat is doorgegeven tijdens het maken van een taak met een lokale context.

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

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

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. Deze moet in kleine letters worden opgegeven. U kunt de standaardregisternaam configureren met behulp van az configure --defaults acr=<registry name>.

Optionele parameters

--agent-pool

Preview

De naam van de agentgroep.

--arg

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

--context -c

De volledige URL naar de opslagplaats voor broncode (vereist achtervoegsel '.git' voor een github-opslagplaats) of een externe tarball (bijvoorbeeld 'http://server/context.tar.gz'), 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 verplicht 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 achtervoegsel met '.yaml' of doorgesluisd vanuit de standaardinvoer met behulp van '-'.

--log-template

Preview

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

--no-format

Geeft aan of de logboeken in onbewerkte indeling moeten worden weergegeven.

standaardwaarde: False

--no-logs

De logboeken worden niet weergegeven nadat de build in de wachtrij is gewacht.

standaardwaarde: False

--no-wait

Wacht niet totdat de uitvoering is voltooid en keer onmiddellijk na het in de wachtrij plaatsen van de uitvoering terug.

standaardwaarde: False

--resource-group -g

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

--secret-arg

Argument voor geheim bouwen in de notatie '--secret-arg name[=value]'. Veelvouden die worden ondersteund door meerdere keren door te geven --secret-arg.

--set

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

--set-secret

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

--target

De naam van de doelbuildfase.

--update-trigger-token

Preview

De nettolading die samen met de triggermelding voor de basisinstallatiekopieën wordt doorgestuurd.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

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

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az acr task show

Haal de eigenschappen van een benoemde taak op voor een Azure Container Registry.

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

Voorbeelden

Haal de eigenschappen van een taak op, waarbij de resultaten in een tabel worden weergegeven.

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. Deze moet in kleine letters worden opgegeven. U kunt de standaardregisternaam configureren met behulp van az configure --defaults acr=<registry name>.

Optionele parameters

--resource-group -g

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

--with-secure-properties

Hiermee wordt aangegeven of de beveiligde eigenschappen van een taak moeten worden geretourneerd.

standaardwaarde: False

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

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

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az acr task show-run

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

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

Voorbeelden

Haal de details van een uitvoering op, waarin de resultaten in een tabel worden weergegeven.

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

Vereiste parameters

--registry -r

De naam van het containerregister. Deze moet in kleine letters worden opgegeven. U kunt de standaardregisternaam configureren met behulp van az configure --defaults acr=<registry name>.

--run-id

De unieke uitvoerings-id.

Optionele parameters

--resource-group -g

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

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

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

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az acr task update

Een taak voor een Azure Container Registry bijwerken.

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]

Voorbeelden

Werk updates van basisinstallatiekopieën bij om te activeren op alle afhankelijke installatiekopieën van een dockerfile met meerdere fasen 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

Updateplatform 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

Een taak voor een Azure Container Registry bijwerken. (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. Deze moet in kleine letters worden opgegeven. U kunt de standaardregisternaam configureren met behulp van az configure --defaults acr=<registry name>.

Optionele parameters

--agent-pool

Preview

De naam van de agentgroep.

--arg

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

--auth-mode

Verificatiemodus van het bronregister.

geaccepteerde waarden: Default, None

--base-image-trigger-enabled

Geeft aan of de trigger voor de basisinstallatiekopieën is ingeschakeld.

geaccepteerde waarden: false, true

--base-image-trigger-type

Het type automatische trigger voor updates van afhankelijkheden van basisinstallatiekopieën.

geaccepteerde waarden: All, Runtime

--cmd

Opdrachten die moeten worden uitgevoerd. Dit biedt ook ondersteuning voor aanvullende docker-uitvoeringsparameters (https://docs.docker.com/engine/reference/commandline/run/) of zelfs andere docker-opdrachten (https://docs.docker.com/engine/reference/commandline/docker/).

--commit-trigger-enabled

Geeft aan of de doorvoertrigger voor broncodebeheer is ingeschakeld.

geaccepteerde waarden: false, true

--context -c

De volledige URL naar de opslagplaats voor broncode (vereist achtervoegsel '.git' voor een github-opslagplaats) of een externe tarball (bijvoorbeeld 'http://server/context.tar.gz'), 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 verplicht argument als de taak geen systeemtaak is.

--cpu

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

--file -f

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

--git-access-token

Het toegangstoken dat wordt gebruikt voor toegang tot de bronbeheerprovider.

--image -t

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

--log-template

Preview

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

--no-cache

Geeft aan of de afbeeldingscache is ingeschakeld.

geaccepteerde waarden: false, true

--no-push

Geeft aan of de gemaakte installatiekopie naar het register moet worden gepusht.

geaccepteerde waarden: false, true

--platform

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

--pull-request-trigger-enabled

Geeft aan of de pull-aanvraagtrigger 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 behulp van az configure --defaults group=<name>.

--secret-arg

Argument voor geheim bouwen in de notatie '--secret-arg name[=value]'. Veelvouden die worden ondersteund door meerdere keren door te geven --secret-arg.

--set

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

--set-secret

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

--status

De huidige status van de taak.

geaccepteerde waarden: Disabled, Enabled

--target

De naam van de doelbuildfase.

--timeout

De time-out in seconden.

--update-trigger-endpoint

Preview

De volledige URL van het eindpunt voor het ontvangen van triggermeldingen voor het bijwerken van basisinstallatiekopieën.

--update-trigger-payload-type

Preview

Geeft aan of metagegevens over de trigger van de basisinstallatiekopieën moeten worden opgenomen in de nettolading, samen met 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.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

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

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az acr task update-run

Patch de uitvoeringseigenschappen van een Azure Container Registry-taak.

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

Voorbeelden

Werk een bestaande uitvoering bij die moet worden gearchiveerd.

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

Vereiste parameters

--registry -r

De naam van het containerregister. Deze moet in kleine letters worden opgegeven. U kunt de standaardregisternaam configureren met behulp van az configure --defaults acr=<registry name>.

--run-id

De unieke uitvoerings-id.

Optionele parameters

--no-archive

Geeft aan of de uitvoering moet worden gearchiveerd.

geaccepteerde waarden: false, true

--resource-group -g

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

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

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

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.