az acr task
Administre una colección de pasos para compilar, probar y aplicar revisiones a imágenes de contenedor de & Framework mediante Azure Container Registries.
Comandos
| Nombre | Description | Tipo | Estado |
|---|---|---|---|
| az acr task cancel-run |
Cancele una ejecución especificada de una instancia de Azure Container Registry. |
Core | GA |
| az acr task create |
Cree una serie de pasos para crear, probar y contenedores de aplicación de revisiones de & Framework. Las tareas admiten desencadenadores de confirmaciones de Git y actualizaciones de imágenes base. |
Core | GA |
| az acr task credential |
Administrar las credenciales de una tarea. Consulte https://aka.ms/acr/tasks/cross-registry-authentication para obtener más información. |
Core | GA |
| az acr task credential add |
Agregue una credencial de inicio de sesión del Registro personalizada a la tarea. |
Core | GA |
| az acr task credential list |
Enumere todas las credenciales del Registro personalizadas para la tarea. |
Core | GA |
| az acr task credential remove |
Quite las credenciales de una tarea. |
Core | GA |
| az acr task credential update |
Actualice la credencial de inicio de sesión del Registro para una tarea. |
Core | GA |
| az acr task delete |
Elimine una tarea de una instancia de Azure Container Registry. |
Core | GA |
| az acr task identity |
Identidades administradas para la tarea. Consulte https://aka.ms/acr/tasks/task-create-managed-identity para obtener más información. |
Core | GA |
| az acr task identity assign |
Actualice la identidad administrada de una tarea. |
Core | GA |
| az acr task identity remove |
Quite las identidades administradas de una tarea. |
Core | GA |
| az acr task identity show |
Muestra las identidades administradas para la tarea. |
Core | GA |
| az acr task list |
Enumere las tareas de una instancia de Azure Container Registry. |
Core | GA |
| az acr task list-runs |
Enumere todas las ejecuciones ejecutadas para una instancia de Azure Container Registry, con la capacidad de filtrar por una tarea específica. |
Core | GA |
| az acr task logs |
Mostrar registros para una ejecución determinada. Si no se proporciona ningún identificador de ejecución, muestre los registros de la última ejecución creada. |
Core | GA |
| az acr task run |
Desencadene manualmente una tarea que podría estar esperando confirmaciones de Git o desencadenadores de actualización de imágenes base. |
Core | GA |
| az acr task show |
Obtenga las propiedades de una tarea con nombre para una instancia de Azure Container Registry. |
Core | GA |
| az acr task show-run |
Obtenga las propiedades de una ejecución especificada de una tarea de Azure Container Registry. |
Core | GA |
| az acr task timer |
Administrar desencadenadores de temporizador para una tarea. |
Core | GA |
| az acr task timer add |
Agregue un desencadenador de temporizador a una tarea. |
Core | GA |
| az acr task timer list |
Enumerar todos los desencadenadores de temporizador para una tarea. |
Core | GA |
| az acr task timer remove |
Quite un desencadenador de temporizador de una tarea. |
Core | GA |
| az acr task timer update |
Actualice el desencadenador del temporizador para una tarea. |
Core | GA |
| az acr task update |
Actualice una tarea para una instancia de Azure Container Registry. |
Core | GA |
| az acr task update-run |
Aplique revisiones a las propiedades de ejecución de una tarea de Azure Container Registry. |
Core | GA |
az acr task cancel-run
Cancele una ejecución especificada de una instancia de Azure Container Registry.
az acr task cancel-run --registry
--run-id
[--resource-group]
Ejemplos
Cancelación de una ejecución
az acr task cancel-run -r myregistry --run-id runId
Parámetros requeridos
Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.
Identificador de ejecución único.
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az acr task create
Cree una serie de pasos para crear, probar y contenedores de aplicación de revisiones de & Framework. Las tareas admiten desencadenadores de confirmaciones de Git y actualizaciones de imágenes base.
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]
Ejemplos
Cree una tarea sin la ubicación de origen.
az acr task create -n hello-world -r myregistry --cmd '$Registry/myimage' -c /dev/null
Cree una tarea con la definición de la entrada estándar y con un desencadenador de temporizador que ejecute la tarea en la parte superior de cada hora con el nombre de desencadenador predeterminado. "Ctrl + Z" (Windows) o "Ctrl + D" (Linux) finaliza la secuencia de entrada.
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 * * *"
Cree una tarea de Linux desde un repositorio público de GitHub que compile la imagen hello-world sin desencadenadores y use un argumento de compilación.
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
Cree una tarea de Linux mediante una rama específica de un repositorio privado de Azure DevOps que compile la imagen hello-world en la arquitectura arm (variante V7) y tenga desencadenadores habilitados.
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
Cree una tarea de Linux a partir de un repositorio público de GitHub que compile la imagen hello-world con un desencadenador de confirmación de Git y solicitud de incorporación de cambios habilitado. Tenga en cuenta que esta tarea no usa el Registro de origen (myregistry), por lo que podemos establecer explícitamente el modo de autenticación como Ninguno para ella.
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
Cree una tarea de Windows desde un repositorio público de GitHub que compile la imagen de Azure Container Builder en la arquitectura Amd64 con solo el desencadenador de imagen base habilitado.
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
Cree una tarea de varios pasos de Linux desde un repositorio público de GitHub con identidades administradas asignadas por el sistema y asignadas por el usuario, e imagen base, git commit, solicitud de incorporación de cambios y desencadenadores de temporizador que ejecutan la tarea a mediodía los lunes a viernes con el nombre del desencadenador del temporizador proporcionado.
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>"
Cree una tarea sin la ubicación de origen en un registro de permisos de repositorio basado en ABAC y especifique una identidad administrada asignada por el sistema que se usa para la autenticación con el registro de origen.
az acr task create -n hello-world -r myregistry --cmd '$Registry/myimage' -c /dev/null --source-acr-auth-id [system]
Cree una tarea sin la ubicación de origen en un registro de permisos de repositorio basado en ABAC y especifique una identidad administrada asignada por el usuario que se usa para la autenticación con el registro de origen.
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>"
Cree una tarea sin la ubicación de origen en un registro de permisos de repositorio basado en ABAC con identidades administradas asignadas por el sistema y asignadas por el usuario y especifique la identidad administrada asignada por el sistema que se usa para la autenticación con el registro de origen.
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>"
Parámetros requeridos
Nombre de la tarea.
Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
Nombre del grupo de agentes.
Argumento de compilación en formato "--arg name[=value]". Se admiten varios pasos "--arg name[=value]" varias veces. IMPORTANTE: Este parámetro no debe incluir contraseñas, tokens de acceso ni información confidencial de ningún tipo. Este valor de parámetro será visible para el equipo de ACR con fines de depuración.
Asigne identidades administradas a la tarea. Use "[system]" para hacer referencia a la identidad asignada por el sistema o a un identificador de recurso para hacer referencia a una identidad asignada por el usuario. Consulte https://aka.ms/acr/tasks/task-create-managed-identity para obtener más información.
Modo de autenticación del registro de origen.
| Propiedad | Valor |
|---|---|
| Valores aceptados: | Default, None |
Indica si el desencadenador de imagen base está habilitado.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Trigger Arguments |
| Valor predeterminado: | True |
| Valores aceptados: | false, true |
Nombre del desencadenador de imagen base.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Trigger Arguments |
| Valor predeterminado: | defaultBaseimageTriggerName |
Tipo del desencadenador automático para las actualizaciones de dependencias de imágenes base.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Trigger Arguments |
| Valor predeterminado: | Runtime |
| Valores aceptados: | All, Runtime |
Comandos que se van a ejecutar. Esto también admite parámetros adicionales de ejecución de Docker (https://docs.docker.com/engine/reference/commandline/run/) o incluso otros comandos de Docker (https://docs.docker.com/engine/reference/commandline/docker/).
Indica si el desencadenador de confirmación del control de código fuente está habilitado.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Trigger Arguments |
| Valor predeterminado: | True |
| Valores aceptados: | false, true |
La dirección URL completa del repositorio de código fuente (requiere el sufijo ".git" para un repositorio de GitHub) o un tarball remoto (por ejemplo, "http://server/context.tar.gz") o el repositorio de un artefacto OCI en un registro de contenedor de Azure (por ejemplo, "oci://myregistry.azurecr.io/myartifact:mytag"). Si se especifica '/dev/null', el valor se establecerá en Ninguno y se omitirá. Este es un argumento obligatorio si la tarea no es una tarea del sistema.
Configuración de CPU en términos de número de núcleos necesarios para la ejecución.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | 2 |
Ruta de acceso relativa del archivo task/docker a la carpeta raíz del código fuente. Los archivos de tareas deben tener el sufijo ".yaml" o canalizarse desde la entrada estándar mediante "-".
Token de acceso usado para acceder al proveedor de control de código fuente.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Trigger Arguments |
El nombre y la etiqueta de la imagen con el formato : "-t repo/image:tag". Se admiten varias etiquetas pasando -t varias veces.
Indica si el recurso de tarea es una tarea del sistema. El nombre de la tarea debe ser "quicktask". Solo se aplica al registro habilitado para CMK.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
La plantilla de repositorio y etiqueta para ejecutar el artefacto de registro con el formato "log/repo:tag" (por ejemplo, "acr/logs:{{.Run.ID}}"). Solo se aplica al registro habilitado para CMK.
Indica si la caché de imágenes está habilitada.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
| Valores aceptados: | false, true |
Indica si la imagen compilada debe insertarse en el registro.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
| Valores aceptados: | false, true |
La plataforma donde se ejecuta build/task, Eg, "windows" y "linux". Cuando se usa en los comandos de compilación, también se puede especificar en formato "os/arch/variant" para la imagen resultante. Por ejemplo, linux/arm/v7. Las partes 'arch' y 'variant' son opcionales.
Indica si el desencadenador de solicitud de incorporación de cambios del control de código fuente está habilitado. El desencadenador está deshabilitado de forma predeterminada.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Trigger Arguments |
| Valor predeterminado: | False |
| Valores aceptados: | false, true |
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Programación de un desencadenador de temporizador representado como una expresión cron. Se puede especificar un nombre de desencadenador opcional mediante --schedule name:schedule formato. Se admiten varias veces mediante la omisión de --schedule.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Trigger Arguments |
Argumento de compilación secreto en formato "--secret-arg name[=value]". Se admiten varios pasos "--secret-arg name[=value]" varias veces. Este valor de parámetro no aparece en el equipo de ACR y es más adecuado para la información confidencial.
Valor de tarea en formato "--set name[=value]". Se admiten varias veces al pasar --set varias veces.
Valor de tarea secreto en formato "--set-secret name[=value]". Se admiten varias veces al pasar --set-secret.
Asigne la identidad administrada que se usa para el inicio de sesión del Registro de origen. Use "[system]" para hacer referencia a la identidad asignada por el sistema o a un identificador de recurso para hacer referencia a una identidad administrada asignada por el usuario.
Nombre del desencadenador de origen.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Trigger Arguments |
| Valor predeterminado: | defaultSourceTriggerName |
Estado actual de la tarea.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | Enabled |
| Valores aceptados: | Disabled, Enabled |
Nombre de la fase de compilación de destino.
Tiempo de espera en segundos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | 3600 |
Dirección URL completa del punto de conexión para recibir notificaciones del desencadenador de actualización de imágenes base.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Trigger Arguments |
Indica si se deben incluir metadatos sobre el desencadenador de imagen base en la carga junto con el token del desencadenador de actualización, cuando se envía una notificación.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Trigger Arguments |
| Valor predeterminado: | Default |
| Valores aceptados: | Default, Token |
Ruta de acceso del archivo de valores o parámetros de tarea relativa al contexto de origen.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az acr task delete
Elimine una tarea de una instancia de Azure Container Registry.
az acr task delete --name
--registry
[--resource-group]
[--yes]
Ejemplos
Elimine una tarea de una instancia de Azure Container Registry.
az acr task delete -n MyTask -r myregistry
Parámetros requeridos
Nombre de la tarea.
Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
No solicita confirmación.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az acr task list
Enumere las tareas de una instancia de Azure Container Registry.
az acr task list --registry
[--resource-group]
Ejemplos
Enumere las tareas y muestre los resultados en una tabla.
az acr task list -r myregistry -o table
Parámetros requeridos
Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az acr task list-runs
Enumere todas las ejecuciones ejecutadas para una instancia de Azure Container Registry, con la capacidad de filtrar por una tarea específica.
az acr task list-runs --registry
[--image]
[--name]
[--resource-group]
[--run-status {Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout}]
[--top]
Ejemplos
Enumere todas las ejecuciones de un registro y muestre los resultados en una tabla.
az acr task list-runs -r myregistry -o table
Enumera las ejecuciones de una tarea y muestran los resultados en una tabla.
az acr task list-runs -r myregistry -n MyTask -o table
Enumere las últimas 10 ejecuciones correctas de un registro y muestre los resultados en una tabla.
az acr task list-runs -r myregistry --run-status Succeeded --top 10 -o table
Enumera todas las ejecuciones que crearon la imagen "hello-world" para un registro y muestran los resultados en una tabla.
az acr task list-runs -r myregistry --image hello-world -o table
Parámetros requeridos
Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
Nombre de la imagen. Puede incluir una etiqueta en el formato "name:tag" o resumen en el formato "name@digest".
Nombre de la tarea.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Estado actual de la ejecución.
| Propiedad | Valor |
|---|---|
| Valores aceptados: | Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout |
Limite el número de ejecuciones más recientes en los resultados.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | 15 |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az acr task logs
Mostrar registros para una ejecución determinada. Si no se proporciona ningún identificador de ejecución, muestre los registros de la última ejecución creada.
az acr task logs --registry
[--image]
[--name]
[--no-format]
[--resource-group]
[--run-id]
Ejemplos
Muestra los registros de la última ejecución creada en el Registro.
az acr task logs -r myregistry
Muestra los registros de la última ejecución creada en el Registro, filtrado por tarea.
az acr task logs -r myregistry -n MyTask
Mostrar registros para una ejecución determinada.
az acr task logs -r myregistry --run-id runId
Muestra los registros de la última ejecución creada en el registro que creó la imagen "hello-world".
az acr task logs -r myregistry --image hello-world
Parámetros requeridos
Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
Nombre de la imagen. Puede incluir una etiqueta en el formato "name:tag" o resumen en el formato "name@digest".
Nombre de la tarea.
Indica si los registros deben mostrarse en formato sin formato.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Identificador de ejecución único.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az acr task run
Desencadene manualmente una tarea que podría estar esperando confirmaciones de Git o desencadenadores de actualización de imágenes base.
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]
Ejemplos
Desencadene una ejecución de tareas.
az acr task run -n MyTask -r myregistry
Desencadene una ejecución de tareas invalidando el contexto y el archivo pasados durante la creación de tareas con un repositorio remoto.
az acr task run -n MyTask -r myregistry -c https://github.com/Azure-Samples/acr-build-helloworld-node.git -f Dockerfile
Desencadene una ejecución de tareas invalidando el contexto y el archivo pasados durante la creación de tareas con un contexto local.
az acr task run -n MyTask -r myregistry -c . -f Dockerfile
Desencadene una ejecución de tarea agregando o reemplazando argumentos de compilación establecidos durante la creación de tareas.
az acr task run -n MyTask -r myregistry --arg DOCKER_CLI_BASE_IMAGE=docker:18.03.0-ce-git
Parámetros requeridos
Nombre de la tarea.
Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
Nombre del grupo de agentes.
Argumento de compilación en formato "--arg name[=value]". Se admiten varios pasos "--arg name[=value]" varias veces. IMPORTANTE: Este parámetro no debe incluir contraseñas, tokens de acceso ni información confidencial de ningún tipo. Este valor de parámetro será visible para el equipo de ACR con fines de depuración.
La dirección URL completa del repositorio de código fuente (requiere el sufijo ".git" para un repositorio de GitHub) o un tarball remoto (por ejemplo, "http://server/context.tar.gz") o el repositorio de un artefacto OCI en un registro de contenedor de Azure (por ejemplo, "oci://myregistry.azurecr.io/myartifact:mytag"). Si se especifica '/dev/null', el valor se establecerá en Ninguno y se omitirá. Este es un argumento obligatorio si la tarea no es una tarea del sistema.
Ruta de acceso relativa del archivo task/docker a la carpeta raíz del código fuente. Los archivos de tareas deben tener el sufijo ".yaml" o canalizarse desde la entrada estándar mediante "-".
La plantilla de repositorio y etiqueta para ejecutar el artefacto de registro con el formato "log/repo:tag" (por ejemplo, "acr/logs:{{.Run.ID}}"). Solo se aplica al registro habilitado para CMK.
Indica si los registros deben mostrarse en formato sin formato.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
No muestre los registros después de poner en cola correctamente la compilación.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
No espere a que se complete la ejecución y vuelva inmediatamente después de poner en cola la ejecución.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Argumento de compilación secreto en formato "--secret-arg name[=value]". Se admiten varios pasos "--secret-arg name[=value]" varias veces. Este valor de parámetro no aparece en el equipo de ACR y es más adecuado para la información confidencial.
Valor de tarea en formato "--set name[=value]". Se admiten varias veces al pasar --set varias veces.
Valor de tarea secreto en formato "--set-secret name[=value]". Se admiten varias veces al pasar --set-secret.
Nombre de la fase de compilación de destino.
La carga que se pasará junto con la notificación del desencadenador de imagen base.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az acr task show
Obtenga las propiedades de una tarea con nombre para una instancia de Azure Container Registry.
az acr task show --name
--registry
[--resource-group]
[--with-secure-properties]
Ejemplos
Obtiene las propiedades de una tarea, mostrando los resultados en una tabla.
az acr task show -n MyTask -r myregistry -o table
Obtenga las propiedades de una tarea, incluidas las propiedades seguras.
az acr task show -n MyTask -r myregistry --with-secure-properties
Parámetros requeridos
Nombre de la tarea.
Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Indica si se deben devolver las propiedades seguras de una tarea.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az acr task show-run
Obtenga las propiedades de una ejecución especificada de una tarea de Azure Container Registry.
az acr task show-run --registry
--run-id
[--resource-group]
Ejemplos
Obtenga los detalles de una ejecución y muestre los resultados en una tabla.
az acr task show-run -r myregistry --run-id runId -o table
Parámetros requeridos
Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.
Identificador de ejecución único.
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az acr task update
Actualice una tarea para una instancia de 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}]
[--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]
Ejemplos
Actualice las actualizaciones de la imagen base para desencadenar en todas las imágenes dependientes de un dockerfile de varias fases y el estado de una tarea en azure Container Registry.
az acr task update -n MyTask -r myregistry --base-image-trigger-type All --status Disabled
Actualice la plataforma para el paso de compilación de la tarea en Windows (anterior a Linux).
az acr task update -n MyTask -r myregistry --platform Windows
Actualice los desencadenadores y el contexto de una tarea de 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
Actualice una tarea para una instancia de Azure Container Registry. (autogenerated)
az acr task update --image MyImage --name MyTask --registry myregistry \
--context https://github.com/Azure-Samples/acr-build-helloworld-node.git
Actualice la tarea mediante la identidad administrada asignada por el sistema para la autenticación con el registro de origen en Azure Container Registry.
az acr task update -n MyTask -r myregistry --source-acr-auth-id [system]
Actualice la tarea mediante la identidad administrada asignada por el usuario para la autenticación con el registro de origen en Azure Container Registry.
az acr task update -n MyTask -r myregistry --source-acr-auth-id "/subscriptions/<subscriptionId>/resourcegroups/<myResourceGroup>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<myUserAssignedIdentitiy>"
Parámetros requeridos
Nombre de la tarea.
Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
Nombre del grupo de agentes.
Argumento de compilación en formato "--arg name[=value]". Se admiten varios pasos "--arg name[=value]" varias veces. IMPORTANTE: Este parámetro no debe incluir contraseñas, tokens de acceso ni información confidencial de ningún tipo. Este valor de parámetro será visible para el equipo de ACR con fines de depuración.
Modo de autenticación del registro de origen.
| Propiedad | Valor |
|---|---|
| Valores aceptados: | Default, None |
Indica si el desencadenador de imagen base está habilitado.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Trigger Arguments |
| Valores aceptados: | false, true |
Tipo del desencadenador automático para las actualizaciones de dependencias de imágenes base.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Trigger Arguments |
| Valores aceptados: | All, Runtime |
Comandos que se van a ejecutar. Esto también admite parámetros adicionales de ejecución de Docker (https://docs.docker.com/engine/reference/commandline/run/) o incluso otros comandos de Docker (https://docs.docker.com/engine/reference/commandline/docker/).
Indica si el desencadenador de confirmación del control de código fuente está habilitado.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Trigger Arguments |
| Valores aceptados: | false, true |
La dirección URL completa del repositorio de código fuente (requiere el sufijo ".git" para un repositorio de GitHub) o un tarball remoto (por ejemplo, "http://server/context.tar.gz") o el repositorio de un artefacto OCI en un registro de contenedor de Azure (por ejemplo, "oci://myregistry.azurecr.io/myartifact:mytag"). Si se especifica '/dev/null', el valor se establecerá en Ninguno y se omitirá. Este es un argumento obligatorio si la tarea no es una tarea del sistema.
Configuración de CPU en términos de número de núcleos necesarios para la ejecución.
Ruta de acceso relativa del archivo task/docker a la carpeta raíz del código fuente. Los archivos de tareas deben tener el sufijo ".yaml" o canalizarse desde la entrada estándar mediante "-".
Token de acceso usado para acceder al proveedor de control de código fuente.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Trigger Arguments |
El nombre y la etiqueta de la imagen con el formato : "-t repo/image:tag". Se admiten varias etiquetas pasando -t varias veces.
La plantilla de repositorio y etiqueta para ejecutar el artefacto de registro con el formato "log/repo:tag" (por ejemplo, "acr/logs:{{.Run.ID}}"). Solo se aplica al registro habilitado para CMK.
Indica si la caché de imágenes está habilitada.
| Propiedad | Valor |
|---|---|
| Valores aceptados: | false, true |
Indica si la imagen compilada debe insertarse en el registro.
| Propiedad | Valor |
|---|---|
| Valores aceptados: | false, true |
La plataforma donde se ejecuta build/task, Eg, "windows" y "linux". Cuando se usa en los comandos de compilación, también se puede especificar en formato "os/arch/variant" para la imagen resultante. Por ejemplo, linux/arm/v7. Las partes 'arch' y 'variant' son opcionales.
Indica si el desencadenador de solicitud de incorporación de cambios del control de código fuente está habilitado. El desencadenador está deshabilitado de forma predeterminada.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Trigger Arguments |
| Valores aceptados: | false, true |
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Argumento de compilación secreto en formato "--secret-arg name[=value]". Se admiten varios pasos "--secret-arg name[=value]" varias veces. Este valor de parámetro no aparece en el equipo de ACR y es más adecuado para la información confidencial.
Valor de tarea en formato "--set name[=value]". Se admiten varias veces al pasar --set varias veces.
Valor de tarea secreto en formato "--set-secret name[=value]". Se admiten varias veces al pasar --set-secret.
Asigne la identidad administrada que se usa para el inicio de sesión del Registro de origen. Use "[system]" para hacer referencia a la identidad asignada por el sistema o a un identificador de recurso para hacer referencia a una identidad administrada asignada por el usuario.
Estado actual de la tarea.
| Propiedad | Valor |
|---|---|
| Valores aceptados: | Disabled, Enabled |
Nombre de la fase de compilación de destino.
Tiempo de espera en segundos.
Dirección URL completa del punto de conexión para recibir notificaciones del desencadenador de actualización de imágenes base.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Trigger Arguments |
Indica si se deben incluir metadatos sobre el desencadenador de imagen base en la carga junto con el token del desencadenador de actualización, cuando se envía una notificación.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Trigger Arguments |
| Valores aceptados: | Default, Token |
Ruta de acceso del archivo de valores o parámetros de tarea relativa al contexto de origen.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az acr task update-run
Aplique revisiones a las propiedades de ejecución de una tarea de Azure Container Registry.
az acr task update-run --registry
--run-id
[--no-archive {false, true}]
[--resource-group]
Ejemplos
Actualice una ejecución existente que se va a archivar.
az acr task update-run -r myregistry --run-id runId --no-archive false
Parámetros requeridos
Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.
Identificador de ejecución único.
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
Indica si la ejecución debe archivarse.
| Propiedad | Valor |
|---|---|
| Valores aceptados: | false, true |
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |