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. |
Core | 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. |
Core | GA |
| az acr task credential |
Referenties voor een taak beheren. Zie https://aka.ms/acr/connected-registry voor meer informatie. |
Core | GA |
| az acr task credential add |
Voeg een aangepaste aanmeldingsreferentie voor het register toe aan de taak. |
Core | GA |
| az acr task credential list |
Geef alle aangepaste registerreferenties voor de taak weer. |
Core | GA |
| az acr task credential remove |
Referenties voor een taak verwijderen. |
Core | GA |
| az acr task credential update |
Werk de aanmeldingsreferentie voor het register voor een taak bij. |
Core | GA |
| az acr task delete |
Een taak verwijderen uit een Azure Container Registry. |
Core | GA |
| az acr task identity |
Beheerde identiteiten voor taak. Zie https://aka.ms/acr/connected-registry voor meer informatie. |
Core | GA |
| az acr task identity assign |
Werk de beheerde identiteit voor een taak bij. |
Core | GA |
| az acr task identity remove |
Beheerde identiteiten voor een taak verwijderen. |
Core | GA |
| az acr task identity show |
De beheerde identiteiten voor de taak weergeven. |
Core | GA |
| az acr task list |
Geef de taken voor een Azure Container Registry weer. |
Core | 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. |
Core | 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. |
Core | GA |
| az acr task run |
Activeer handmatig een taak die anders wacht op git-doorvoeringen of triggers voor het bijwerken van basisinstallatiekopieën. |
Core | GA |
| az acr task show |
Haal de eigenschappen van een benoemde taak op voor een Azure Container Registry. |
Core | GA |
| az acr task show-run |
Haal de eigenschappen op van een opgegeven uitvoering van een Azure Container Registry-taak. |
Core | GA |
| az acr task timer |
Timertriggers voor een taak beheren. |
Core | GA |
| az acr task timer add |
Voeg een timertrigger toe aan een taak. |
Core | GA |
| az acr task timer list |
Alle timertriggers voor een taak weergeven. |
Core | GA |
| az acr task timer remove |
Een timertrigger verwijderen uit een taak. |
Core | GA |
| az acr task timer update |
Werk de timertrigger voor een taak bij. |
Core | GA |
| az acr task update |
Een taak voor een Azure Container Registry bijwerken. |
Core | GA |
| az acr task update-run |
Patch de uitvoeringseigenschappen van een Azure Container Registry-taak. |
Core | 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
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>.
De unieke uitvoerings-id.
Optionele parameters
De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
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-acr-auth-id]
[--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>"
Maak een taak zonder de bronlocatie in een op ABAC gebaseerd opslagplaatsmachtigingsregister en geef een door het systeem toegewezen beheerde identiteit op die wordt gebruikt voor verificatie met het bronregister.
az acr task create -n hello-world -r myregistry --cmd '$Registry/myimage' -c /dev/null --source-acr-auth-id [system]
Maak een taak zonder de bronlocatie in een opslagplaatsmachtigingsregister op basis van ABAC en geef een door de gebruiker toegewezen beheerde identiteit op die wordt gebruikt voor verificatie met het bronregister.
az acr task create -n hello-world -r myregistry --cmd '$Registry/myimage' -c /dev/null --source-acr-auth-id "/subscriptions/<subscriptionId>/resourcegroups/<myResourceGroup>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<myUserAssignedIdentitiy>"
Maak een taak zonder de bronlocatie in een op ABAC gebaseerd opslagplaatsmachtigingsregister met zowel door het systeem toegewezen als door de gebruiker toegewezen beheerde identiteiten en geef de door het systeem toegewezen beheerde identiteit op die wordt gebruikt voor verificatie met het bronregister.
az acr task create -n hello-world -r myregistry --cmd '$Registry/myimage' -c /dev/null --source-acr-auth-id [system]
--assign-identity [system] "/subscriptions/<subscriptionId>/resourcegroups/<myResourceGroup>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<myUserAssignedIdentitiy>"
Vereiste parameters
De naam van de taak.
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
De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.
De naam van de agentgroep.
Bouwargument in de notatie '--arg name[=value]'. Veelvouden worden ondersteund door meerdere keren '--arg name[=value]' door te geven. BELANGRIJK: Deze parameter mag geen wachtwoorden, toegangstokens of gevoelige informatie van welke aard dan ook bevatten. Deze parameterwaarde is zichtbaar voor het ACR-team voor foutopsporing.
Wijs 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/connected-registry voor meer informatie.
Verificatiemodus van het bronregister.
| Eigenschap | Waarde |
|---|---|
| Geaccepteerde waarden: | Default, None |
Geeft aan of de trigger voor de basisinstallatiekopieën is ingeschakeld.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Trigger Arguments |
| Default value: | True |
| Geaccepteerde waarden: | false, true |
De naam van de trigger voor de basisinstallatiekopieën.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Trigger Arguments |
| Default value: | defaultBaseimageTriggerName |
Het type automatische trigger voor updates van afhankelijkheden van basisinstallatiekopieën.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Trigger Arguments |
| Default value: | Runtime |
| Geaccepteerde waarden: | All, Runtime |
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/).
Geeft aan of de doorvoertrigger voor broncodebeheer is ingeschakeld.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Trigger Arguments |
| Default value: | True |
| Geaccepteerde waarden: | false, true |
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.
De CPU-configuratie in termen van het aantal kernen dat nodig is voor de uitvoering.
| Eigenschap | Waarde |
|---|---|
| Default value: | 2 |
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 '-'.
Het toegangstoken dat wordt gebruikt voor toegang tot de bronbeheerprovider.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Trigger Arguments |
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.
Geeft aan of de taakresource een systeemtaak is. De naam van de taak moet 'quicktask' zijn. Alleen van toepassing op cmk ingeschakeld register.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
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.
Geeft aan of de afbeeldingscache is ingeschakeld.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
| Geaccepteerde waarden: | false, true |
Geeft aan of de gemaakte installatiekopie naar het register moet worden gepusht.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
| Geaccepteerde waarden: | false, true |
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.
Geeft aan of de pull-aanvraagtrigger voor broncodebeheer is ingeschakeld. De trigger is standaard uitgeschakeld.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Trigger Arguments |
| Default value: | False |
| Geaccepteerde waarden: | false, true |
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Planning voor een timertrigger die wordt weergegeven als cron-expressie. Een optionele triggernaam kan worden opgegeven met --schedule name:schedule indeling. Veelvouden die worden ondersteund door meerdere keren door te geven - --schedule.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Trigger Arguments |
Argument voor geheim bouwen in de notatie '--secret-arg name[=value]'. Veelvouden worden meerdere keren ondersteund door '--secret-arg name[=value]' door te geven. Deze parameterwaarde wordt niet weergegeven voor het ACR-team en is geschikter voor gevoelige informatie.
Taakwaarde in de notatie '--set name[=value]'. Veelvouden die worden ondersteund door meerdere keren door te geven - --set meerdere keren doorgeven.
Geheime taakwaarde in de notatie '--set-secret name[=value]'. Veelvouden die meerdere keren worden ondersteund door --set-secret door te geven.
Wijs de beheerde identiteit toe die wordt gebruikt voor aanmelding bij het bronregister. 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 beheerde identiteit.
De naam van de brontrigger.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Trigger Arguments |
| Default value: | defaultSourceTriggerName |
De huidige status van de taak.
| Eigenschap | Waarde |
|---|---|
| Default value: | Enabled |
| Geaccepteerde waarden: | Disabled, Enabled |
De naam van de doelbuildfase.
De time-out in seconden.
| Eigenschap | Waarde |
|---|---|
| Default value: | 3600 |
De volledige URL van het eindpunt voor het ontvangen van triggermeldingen voor het bijwerken van basisinstallatiekopieën.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Trigger Arguments |
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.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Trigger Arguments |
| Default value: | Default |
| Geaccepteerde waarden: | Default, Token |
Het bestandspad voor taakwaarden/parameters ten opzichte van de broncontext.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
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
De naam van de taak.
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
De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Niet vragen om bevestiging.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
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
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
De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
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
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
De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.
De naam van de afbeelding. Kan een tag bevatten in de indeling 'name:tag' of digest in de indeling 'name@digest'.
De naam van de taak.
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
De huidige status van de uitvoering.
| Eigenschap | Waarde |
|---|---|
| Geaccepteerde waarden: | Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout |
Beperk het aantal meest recente uitvoeringen in de resultaten.
| Eigenschap | Waarde |
|---|---|
| Default value: | 15 |
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
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
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
De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.
De naam van de afbeelding. Kan een tag bevatten in de indeling 'name:tag' of digest in de indeling 'name@digest'.
De naam van de taak.
Geeft aan of de logboeken in onbewerkte indeling moeten worden weergegeven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
De unieke uitvoerings-id.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
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
De naam van de taak.
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
De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.
De naam van de agentgroep.
Bouwargument in de notatie '--arg name[=value]'. Veelvouden worden ondersteund door meerdere keren '--arg name[=value]' door te geven. BELANGRIJK: Deze parameter mag geen wachtwoorden, toegangstokens of gevoelige informatie van welke aard dan ook bevatten. Deze parameterwaarde is zichtbaar voor het ACR-team voor foutopsporing.
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.
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 '-'.
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.
Geeft aan of de logboeken in onbewerkte indeling moeten worden weergegeven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
De logboeken worden niet weergegeven nadat de build in de wachtrij is gewacht.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Wacht niet totdat de uitvoering is voltooid en keer onmiddellijk na het in de wachtrij plaatsen van de uitvoering terug.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Argument voor geheim bouwen in de notatie '--secret-arg name[=value]'. Veelvouden worden meerdere keren ondersteund door '--secret-arg name[=value]' door te geven. Deze parameterwaarde wordt niet weergegeven voor het ACR-team en is geschikter voor gevoelige informatie.
Taakwaarde in de notatie '--set name[=value]'. Veelvouden die worden ondersteund door meerdere keren door te geven - --set meerdere keren doorgeven.
Geheime taakwaarde in de notatie '--set-secret name[=value]'. Veelvouden die meerdere keren worden ondersteund door --set-secret door te geven.
De naam van de doelbuildfase.
De nettolading die samen met de triggermelding voor de basisinstallatiekopieën wordt doorgestuurd.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
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
De naam van de taak.
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
De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Hiermee wordt aangegeven of de beveiligde eigenschappen van een taak moeten worden geretourneerd.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
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
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>.
De unieke uitvoerings-id.
Optionele parameters
De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
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]
[--source-acr-auth-id]
[--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. (autogenerated)
az acr task update --image MyImage --name MyTask --registry myregistry \
--context https://github.com/Azure-Samples/acr-build-helloworld-node.git
Werk de taak bij met behulp van de door het systeem toegewezen beheerde identiteit voor verificatie met het bronregister in Azure Container Registry.
az acr task update -n MyTask -r myregistry --source-acr-auth-id [system]
Werk de taak bij met behulp van de door de gebruiker toegewezen beheerde identiteit voor verificatie met het bronregister in Azure Container Registry.
az acr task update -n MyTask -r myregistry --source-acr-auth-id "/subscriptions/<subscriptionId>/resourcegroups/<myResourceGroup>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<myUserAssignedIdentitiy>"
Vereiste parameters
De naam van de taak.
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
De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.
De naam van de agentgroep.
Bouwargument in de notatie '--arg name[=value]'. Veelvouden worden ondersteund door meerdere keren '--arg name[=value]' door te geven. BELANGRIJK: Deze parameter mag geen wachtwoorden, toegangstokens of gevoelige informatie van welke aard dan ook bevatten. Deze parameterwaarde is zichtbaar voor het ACR-team voor foutopsporing.
Verificatiemodus van het bronregister.
| Eigenschap | Waarde |
|---|---|
| Geaccepteerde waarden: | Default, None |
Geeft aan of de trigger voor de basisinstallatiekopieën is ingeschakeld.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Trigger Arguments |
| Geaccepteerde waarden: | false, true |
Het type automatische trigger voor updates van afhankelijkheden van basisinstallatiekopieën.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Trigger Arguments |
| Geaccepteerde waarden: | All, Runtime |
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/).
Geeft aan of de doorvoertrigger voor broncodebeheer is ingeschakeld.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Trigger Arguments |
| Geaccepteerde waarden: | false, true |
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.
De CPU-configuratie in termen van het aantal kernen dat nodig is voor de uitvoering.
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 '-'.
Het toegangstoken dat wordt gebruikt voor toegang tot de bronbeheerprovider.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Trigger Arguments |
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.
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.
Geeft aan of de afbeeldingscache is ingeschakeld.
| Eigenschap | Waarde |
|---|---|
| Geaccepteerde waarden: | false, true |
Geeft aan of de gemaakte installatiekopie naar het register moet worden gepusht.
| Eigenschap | Waarde |
|---|---|
| Geaccepteerde waarden: | false, true |
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.
Geeft aan of de pull-aanvraagtrigger voor broncodebeheer is ingeschakeld. De trigger is standaard uitgeschakeld.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Trigger Arguments |
| Geaccepteerde waarden: | false, true |
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Argument voor geheim bouwen in de notatie '--secret-arg name[=value]'. Veelvouden worden meerdere keren ondersteund door '--secret-arg name[=value]' door te geven. Deze parameterwaarde wordt niet weergegeven voor het ACR-team en is geschikter voor gevoelige informatie.
Taakwaarde in de notatie '--set name[=value]'. Veelvouden die worden ondersteund door meerdere keren door te geven - --set meerdere keren doorgeven.
Geheime taakwaarde in de notatie '--set-secret name[=value]'. Veelvouden die meerdere keren worden ondersteund door --set-secret door te geven.
Wijs de beheerde identiteit toe die wordt gebruikt voor aanmelding bij het bronregister. 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 beheerde identiteit.
De huidige status van de taak.
| Eigenschap | Waarde |
|---|---|
| Geaccepteerde waarden: | Disabled, Enabled |
De naam van de doelbuildfase.
De time-out in seconden.
De volledige URL van het eindpunt voor het ontvangen van triggermeldingen voor het bijwerken van basisinstallatiekopieën.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Trigger Arguments |
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.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Trigger Arguments |
| Geaccepteerde waarden: | Default, Token |
Het bestandspad voor taakwaarden/parameters ten opzichte van de broncontext.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
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
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>.
De unieke uitvoerings-id.
Optionele parameters
De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.
Geeft aan of de uitvoering moet worden gearchiveerd.
| Eigenschap | Waarde |
|---|---|
| Geaccepteerde waarden: | false, true |
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |