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 OS & 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 compilar, probar y aplicar revisiones a los contenedores del sistema operativo y del marco. 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 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 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

--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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az acr task create

Cree una serie de pasos para compilar, probar y aplicar revisiones a los contenedores del sistema operativo y del marco. 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-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, desencadenadores de confirmación de Git, solicitud de incorporación de cambios y temporizador que ejecutan la tarea al mediodía de 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>"

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

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

Asigna 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 más información.

--auth-mode

Modo de autenticación del registro de origen.

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

Indica si el desencadenador de imagen base está habilitado.

Valores aceptados: false, true
Valor predeterminado: True
--base-image-trigger-name

Nombre del desencadenador de imagen base.

Valor predeterminado: defaultBaseimageTriggerName
--base-image-trigger-type

Tipo del desencadenador automático para las actualizaciones de dependencias de imágenes base.

Valores aceptados: All, Runtime
Valor predeterminado: 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.

Valores aceptados: false, true
Valor predeterminado: 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 de 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.

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.

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

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.

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

Indica si la imagen compilada debe insertarse en el registro.

Valores aceptados: false, true
Valor predeterminado: False
--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.

Valores aceptados: false, true
Valor predeterminado: False
--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 el formato . Se admiten varias veces mediante la omisión de --schedule.

--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-trigger-name

Nombre del desencadenador de origen.

Valor predeterminado: defaultSourceTriggerName
--status

Estado actual de la tarea.

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

Nombre de la fase de compilación de destino.

--timeout

Tiempo de espera en segundos.

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.

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

Valores aceptados: Default, Token
Valor predeterminado: Default
--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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

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

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

Valor predeterminado: False
Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

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

--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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

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

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

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

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

Valor predeterminado: 15
Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

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

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

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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

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

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

Valor predeterminado: False
--no-logs

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

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.

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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

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

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

Valor predeterminado: False
Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

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

--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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

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]
                   [--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. (generado automáticamente)

az acr task update --image MyImage --name MyTask --registry myregistry \
    --context https://github.com/Azure-Samples/acr-build-helloworld-node.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

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

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

Indica si el desencadenador de imagen base está habilitado.

Valores aceptados: false, true
--base-image-trigger-type

Tipo del desencadenador automático para las actualizaciones de dependencias de imágenes base.

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.

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

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

Valores aceptados: false, true
--no-push

Indica si la imagen compilada debe insertarse en el registro.

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.

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.

--status

Estado actual de la tarea.

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.

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

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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

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

--no-archive

Indica si la ejecución debe archivarse.

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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.