Compartir a través de


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

--registry -r

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

--run-id

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.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

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

--name -n

Nombre de la tarea.

--registry -r

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.

--agent-pool
Vista previa

Nombre del grupo de agentes.

--arg

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.

--assign-identity

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.

--auth-mode

Modo de autenticación del registro de origen.

Propiedad Valor
Valores aceptados: Default, None
--base-image-trigger-enabled

Indica si el desencadenador de imagen base está habilitado.

Propiedad Valor
Grupo de parámetros: Trigger Arguments
Valor predeterminado: True
Valores aceptados: false, true
--base-image-trigger-name

Nombre del desencadenador de imagen base.

Propiedad Valor
Grupo de parámetros: Trigger Arguments
Valor predeterminado: defaultBaseimageTriggerName
--base-image-trigger-type

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

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

--commit-trigger-enabled

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
--context -c

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.

--cpu

Configuración de CPU en términos de número de núcleos necesarios para la ejecución.

Propiedad Valor
Valor predeterminado: 2
--file -f

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

--git-access-token

Token de acceso usado para acceder al proveedor de control de código fuente.

Propiedad Valor
Grupo de parámetros: Trigger Arguments
--image -t

El nombre y la etiqueta de la imagen con el formato : "-t repo/image:tag". Se admiten varias etiquetas pasando -t varias veces.

--is-system-task
Vista previa

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
--log-template
Vista previa

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.

--no-cache

Indica si la caché de imágenes está habilitada.

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
--no-push

Indica si la imagen compilada debe insertarse en el registro.

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
--platform

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.

--pull-request-trigger-enabled

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
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--schedule

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
--secret-arg

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.

--set

Valor de tarea en formato "--set name[=value]". Se admiten varias veces al pasar --set varias veces.

--set-secret

Valor de tarea secreto en formato "--set-secret name[=value]". Se admiten varias veces al pasar --set-secret.

--source-acr-auth-id

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.

--source-trigger-name

Nombre del desencadenador de origen.

Propiedad Valor
Grupo de parámetros: Trigger Arguments
Valor predeterminado: defaultSourceTriggerName
--status

Estado actual de la tarea.

Propiedad Valor
Valor predeterminado: Enabled
Valores aceptados: Disabled, Enabled
--target

Nombre de la fase de compilación de destino.

--timeout

Tiempo de espera en segundos.

Propiedad Valor
Valor predeterminado: 3600
--update-trigger-endpoint
Vista previa

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
--update-trigger-payload-type
Vista previa

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

Ruta de acceso del archivo de valores o parámetros de tarea relativa al contexto de origen.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

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

--name -n

Nombre de la tarea.

--registry -r

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.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--yes -y

No solicita confirmación.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

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

--registry -r

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.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

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

--registry -r

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.

--image -t

Nombre de la imagen. Puede incluir una etiqueta en el formato "name:tag" o resumen en el formato "name@digest".

--name -n

Nombre de la tarea.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--run-status

Estado actual de la ejecución.

Propiedad Valor
Valores aceptados: Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout
--top

Limite el número de ejecuciones más recientes en los resultados.

Propiedad Valor
Valor predeterminado: 15
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

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

--registry -r

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.

--image -t

Nombre de la imagen. Puede incluir una etiqueta en el formato "name:tag" o resumen en el formato "name@digest".

--name -n

Nombre de la tarea.

--no-format

Indica si los registros deben mostrarse en formato sin formato.

Propiedad Valor
Valor predeterminado: False
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--run-id

Identificador de ejecución único.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

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

--name -n

Nombre de la tarea.

--registry -r

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.

--agent-pool
Vista previa

Nombre del grupo de agentes.

--arg

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.

--context -c

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.

--file -f

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

--log-template
Vista previa

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.

--no-format

Indica si los registros deben mostrarse en formato sin formato.

Propiedad Valor
Valor predeterminado: False
--no-logs

No muestre los registros después de poner en cola correctamente la compilación.

Propiedad Valor
Valor predeterminado: False
--no-wait

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
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--secret-arg

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.

--set

Valor de tarea en formato "--set name[=value]". Se admiten varias veces al pasar --set varias veces.

--set-secret

Valor de tarea secreto en formato "--set-secret name[=value]". Se admiten varias veces al pasar --set-secret.

--target

Nombre de la fase de compilación de destino.

--update-trigger-token
Vista previa

La carga que se pasará junto con la notificación del desencadenador de imagen base.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

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

--name -n

Nombre de la tarea.

--registry -r

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.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--with-secure-properties

Indica si se deben devolver las propiedades seguras de una tarea.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

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

--registry -r

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

--run-id

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.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

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

--name -n

Nombre de la tarea.

--registry -r

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.

--agent-pool
Vista previa

Nombre del grupo de agentes.

--arg

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.

--auth-mode

Modo de autenticación del registro de origen.

Propiedad Valor
Valores aceptados: Default, None
--base-image-trigger-enabled

Indica si el desencadenador de imagen base está habilitado.

Propiedad Valor
Grupo de parámetros: Trigger Arguments
Valores aceptados: false, true
--base-image-trigger-type

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

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

--commit-trigger-enabled

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
--context -c

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.

--cpu

Configuración de CPU en términos de número de núcleos necesarios para la ejecución.

--file -f

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

--git-access-token

Token de acceso usado para acceder al proveedor de control de código fuente.

Propiedad Valor
Grupo de parámetros: Trigger Arguments
--image -t

El nombre y la etiqueta de la imagen con el formato : "-t repo/image:tag". Se admiten varias etiquetas pasando -t varias veces.

--log-template
Vista previa

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.

--no-cache

Indica si la caché de imágenes está habilitada.

Propiedad Valor
Valores aceptados: false, true
--no-push

Indica si la imagen compilada debe insertarse en el registro.

Propiedad Valor
Valores aceptados: false, true
--platform

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.

--pull-request-trigger-enabled

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
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--secret-arg

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.

--set

Valor de tarea en formato "--set name[=value]". Se admiten varias veces al pasar --set varias veces.

--set-secret

Valor de tarea secreto en formato "--set-secret name[=value]". Se admiten varias veces al pasar --set-secret.

--source-acr-auth-id

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.

--status

Estado actual de la tarea.

Propiedad Valor
Valores aceptados: Disabled, Enabled
--target

Nombre de la fase de compilación de destino.

--timeout

Tiempo de espera en segundos.

--update-trigger-endpoint
Vista previa

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
--update-trigger-payload-type
Vista previa

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

Ruta de acceso del archivo de valores o parámetros de tarea relativa al contexto de origen.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

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

--registry -r

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

--run-id

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.

--no-archive

Indica si la ejecución debe archivarse.

Propiedad Valor
Valores aceptados: false, true
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False