az acr task

  • Référence

Gérez une collection d’étapes pour la création, le test et la mise à jour corrective des images conteneur de système d’exploitation et d’infrastructure à l’aide des registres de conteneurs Azure.

Commandes

Nom Description Type État
az acr task cancel-run

Annulez une exécution spécifiée d’un Registre de conteneurs Azure.

 Core GA
az acr task create

Créez une série d’étapes pour la création, le test et les conteneurs de mise à jour corrective du système d’exploitation et du framework. Les tâches prennent en charge les déclencheurs à partir de validations Git et de mises à jour d’images de base.

 Core GA
az acr task credential

Gérer les informations d’identification d’une tâche. Pour plus d’informations, consultez https://aka.ms/acr/tasks/cross-registry-authentication.

 Core GA
az acr task credential add

Ajoutez des informations d’identification de connexion de Registre personnalisées à la tâche.

 Core GA
az acr task credential list

Répertoriez toutes les informations d’identification de Registre personnalisées pour la tâche.

 Core GA
az acr task credential remove

Supprimez les informations d’identification d’une tâche.

 Core GA
az acr task credential update

Mettez à jour les informations d’identification de connexion du Registre pour une tâche.

 Core GA
az acr task delete

Supprimez une tâche d’azure Container Registry.

 Core GA
az acr task identity

Identités managées pour la tâche. Pour plus d’informations, consultez https://aka.ms/acr/tasks/task-create-managed-identity.

 Core GA
az acr task identity assign

Mettez à jour l’identité managée pour une tâche.

 Core GA
az acr task identity remove

Supprimez les identités managées pour une tâche.

 Core GA
az acr task identity show

Affichez les identités managées pour la tâche.

 Core GA
az acr task list

Répertoriez les tâches d’un Registre de conteneurs Azure.

 Core GA
az acr task list-runs

Répertoriez toutes les exécutions exécutées pour azure Container Registry, avec la possibilité de filtrer par une tâche spécifique.

 Core GA
az acr task logs

Afficher les journaux d’activité d’une exécution particulière. Si aucun id d’exécution n’est fourni, affichez les journaux de la dernière exécution créée.

 Core GA
az acr task run

Déclenchez manuellement une tâche susceptible d’attendre des validations Git ou des déclencheurs de mise à jour d’image de base.

 Core GA
az acr task show

Obtenez les propriétés d’une tâche nommée pour azure Container Registry.

 Core GA
az acr task show-run

Obtenez les propriétés d’une exécution spécifiée d’une tâche Azure Container Registry.

 Core GA
az acr task timer

Gérer les déclencheurs du minuteur pour une tâche.

 Core GA
az acr task timer add

Ajoutez un déclencheur de minuteur à une tâche.

 Core GA
az acr task timer list

Répertorier tous les déclencheurs du minuteur pour une tâche.

 Core GA
az acr task timer remove

Supprimez un déclencheur de minuteur d’une tâche.

 Core GA
az acr task timer update

Mettez à jour le déclencheur du minuteur pour une tâche.

 Core GA
az acr task update

Mettez à jour une tâche pour azure Container Registry.

 Core GA
az acr task update-run

Corrigez les propriétés d’exécution d’une tâche Azure Container Registry.

 Core GA

az acr task cancel-run

Modifier

Annulez une exécution spécifiée d’un Registre de conteneurs Azure.

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

Exemples

Annuler une exécution

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

Paramètres obligatoires

--registry -r

Nom du registre de conteneurs. Elle doit être spécifiée en minuscules. Vous pouvez configurer le nom de Registre par défaut à l’aide az configure --defaults acr=<registry name>de .

--run-id

Identificateur d’exécution unique.

Paramètres facultatifs

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az acr task create

Modifier

Créez une série d’étapes pour la création, le test et les conteneurs de mise à jour corrective du système d’exploitation et du framework. Les tâches prennent en charge les déclencheurs à partir de validations Git et de mises à jour d’images de 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]

Exemples

Créez une tâche sans l’emplacement source.

az acr task create -n hello-world -r myregistry --cmd '$Registry/myimage' -c /dev/null

Créez une tâche avec la définition à partir de l’entrée standard et avec un déclencheur de minuteur qui exécute la tâche en haut de chaque heure à l’aide du nom de déclencheur par défaut. « Ctrl + Z » (Windows) ou « Ctrl + D » (Linux) termine le flux d’entrée.

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

Créez une tâche Linux à partir d’un dépôt GitHub public qui génère l’image hello-world sans déclencheurs et utilise un argument de génération.

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

Créez une tâche Linux à l’aide d’une branche spécifique d’un référentiel Azure DevOps privé qui génère l’image hello-world sur l’architecture Arm (variante V7) et active les déclencheurs.

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

Créez une tâche Linux à partir d’un dépôt GitHub public qui génère l’image hello-world avec un déclencheur de validation Git et de demande de tirage activé. Notez que cette tâche n’utilise pas le Registre source (myregistry), afin que nous puissions définir explicitement le mode d’authentification comme Aucun pour celui-ci.

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

Créez une tâche Windows à partir d’un référentiel GitHub public qui génère l’image Azure Container Builder sur l’architecture Amd64 avec uniquement le déclencheur d’image de base activé.

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

Créez une tâche multi-étapes Linux à partir d’un référentiel GitHub public avec des identités managées affectées par le système et une image de base affectée par l’utilisateur, une validation Git, une demande de tirage et des déclencheurs de minuteur qui exécutent la tâche à midi le lundi au vendredi avec le nom du déclencheur du minuteur fourni.

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

Paramètres obligatoires

--name -n

Nom de la tâche.

--registry -r

Nom du registre de conteneurs. Elle doit être spécifiée en minuscules. Vous pouvez configurer le nom de Registre par défaut à l’aide az configure --defaults acr=<registry name>de .

Paramètres facultatifs

--agent-pool
Préversion

Nom du pool d’agents.

--arg

Argument de génération au format '--arg name[=value]'. Les multiples sont pris en charge en passant « --arg name[=value] » plusieurs fois. IMPORTANT : ce paramètre ne doit pas inclure de mots de passe, de jetons d’accès ou d’informations sensibles d’un type quelconque. Cette valeur de paramètre sera visible par l’équipe ACR à des fins de débogage.

--assign-identity

Affecte des identités managées à la tâche. Utilisez « [système] » pour faire référence à l’identité affectée par le système ou à un ID de ressource pour faire référence à une identité affectée par l’utilisateur. Pour plus d’informations, consultez https://aka.ms/acr/tasks/task-create-managed-identity.

--auth-mode

Mode d’authentification du registre source.

Valeurs acceptées: Default, None
--base-image-trigger-enabled

Indique si le déclencheur d’image de base est activé.

Valeurs acceptées: false, true
Valeur par défaut: True
--base-image-trigger-name

Nom du déclencheur d’image de base.

Valeur par défaut: defaultBaseimageTriggerName
--base-image-trigger-type

Type du déclencheur automatique pour les mises à jour des dépendances d’image de base.

Valeurs acceptées: All, Runtime
Valeur par défaut: Runtime
--cmd

Commandes à exécuter. Cela prend également en charge des paramètres d’exécution Docker supplémentaires (https://docs.docker.com/engine/reference/commandline/run/) ou même d’autres commandes Docker (https://docs.docker.com/engine/reference/commandline/docker/).

--commit-trigger-enabled

Indique si le déclencheur de validation du contrôle de code source est activé.

Valeurs acceptées: false, true
Valeur par défaut: True
--context -c

URL complète vers le référentiel de code source (nécessite le suffixe « .git » pour un dépôt github) ou un tarball distant (par exemple, «http://server/context.tar.gz ») ou le dépôt d’un artefact OCI dans un registre de conteneurs Azure (par exemple, « oci://myregistry.azurecr.io/myartifact:mytag »). Si « /dev/null » est spécifié, la valeur est définie sur None et ignorée. Il s’agit d’un argument obligatoire si la tâche n’est pas une tâche système.

--cpu

Configuration du processeur en termes de nombre de cœurs requis pour l’exécution.

Valeur par défaut: 2
--file -f

Chemin relatif du fichier task/docker vers le dossier racine du code source. Les fichiers de tâche doivent être suffixes avec « .yaml » ou redirigés à partir de l’entrée standard à l’aide de « - ».

--git-access-token

Jeton d’accès utilisé pour accéder au fournisseur de contrôle de code source.

--image -t

Nom et balise de l’image au format : ' -t repo/image :tag'. Plusieurs balises sont prises en charge en passant -t plusieurs fois.

--is-system-task
Préversion

Indique si la ressource de tâche est une tâche système. Le nom de la tâche doit être « quicktask ». Applicable uniquement au registre activé par CMK.

Valeur par défaut: False
--log-template
Préversion

Le référentiel et le modèle de balise pour exécuter l’artefact de journal à l’aide du format « log/repo :tag » (par exemple, « acr/logs :{.Run.ID}} »). Applicable uniquement au registre activé par CMK.

--no-cache

Indique si le cache d’images est activé.

Valeurs acceptées: false, true
Valeur par défaut: False
--no-push

Indique si l’image générée doit être envoyée (push) au registre.

Valeurs acceptées: false, true
Valeur par défaut: False
--platform

Plateforme où la génération/tâche est exécutée, par exemple, « windows » et « linux ». Lorsqu’elle est utilisée dans les commandes de build, elle peut également être spécifiée au format « os/arch/variant » pour l’image obtenue. Par exemple, linux/arm/v7. Les parties « arch » et « variant » sont facultatives.

--pull-request-trigger-enabled

Indique si le déclencheur de demande de tirage de contrôle de code source est activé. Le déclencheur est désactivé par défaut.

Valeurs acceptées: false, true
Valeur par défaut: False
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--schedule

Planifiez un déclencheur de minuteur représenté en tant qu’expression cron. Un nom de déclencheur facultatif peut être spécifié à l’aide du --schedule name:schedule format. Multiples pris en charge en passant --schedule plusieurs fois.

--secret-arg

Argument de génération de secret au format « --secret-arg name[=value] ». Les multiples sont pris en charge en passant plusieurs fois « --secret-arg name[=value] ». Cette valeur de paramètre n’est pas exposée à l’équipe ACR et est plus adaptée aux informations sensibles.

--set

Valeur de tâche au format '--set name[=value]'. Multiples pris en charge en passant --set plusieurs fois.

--set-secret

Valeur de tâche secrète au format « --set-secret name[=value] ». Multiples pris en charge en passant --set-secret plusieurs fois.

--source-trigger-name

Nom du déclencheur source.

Valeur par défaut: defaultSourceTriggerName
--status

État actuel de la tâche.

Valeurs acceptées: Disabled, Enabled
Valeur par défaut: Enabled
--target

Nom de l’étape de génération cible.

--timeout

Délai d’expiration en secondes.

Valeur par défaut: 3600
--update-trigger-endpoint
Préversion

URL complète du point de terminaison pour recevoir des notifications de déclencheur de mise à jour de l’image de base.

--update-trigger-payload-type
Préversion

Indique s’il faut inclure des métadonnées sur le déclencheur d’image de base dans la charge utile avec le jeton de déclencheur de mise à jour, lorsqu’une notification est envoyée.

Valeurs acceptées: Default, Token
Valeur par défaut: Default
--values

Chemin d’accès du fichier de valeurs/paramètres de tâche par rapport au contexte source.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az acr task delete

Modifier

Supprimez une tâche d’azure Container Registry.

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

Exemples

Supprimez une tâche d’azure Container Registry.

az acr task delete -n MyTask -r myregistry

Paramètres obligatoires

--name -n

Nom de la tâche.

--registry -r

Nom du registre de conteneurs. Elle doit être spécifiée en minuscules. Vous pouvez configurer le nom de Registre par défaut à l’aide az configure --defaults acr=<registry name>de .

Paramètres facultatifs

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--yes -y

Ne pas demander de confirmation.

Valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az acr task list

Modifier

Répertoriez les tâches d’un Registre de conteneurs Azure.

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

Exemples

Répertorier les tâches et afficher les résultats d’une table.

az acr task list -r myregistry -o table

Paramètres obligatoires

--registry -r

Nom du registre de conteneurs. Elle doit être spécifiée en minuscules. Vous pouvez configurer le nom de Registre par défaut à l’aide az configure --defaults acr=<registry name>de .

Paramètres facultatifs

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az acr task list-runs

Modifier

Répertoriez toutes les exécutions exécutées pour azure Container Registry, avec la possibilité de filtrer par une tâche spécifique.

az acr task list-runs --registry
                      [--image]
                      [--name]
                      [--resource-group]
                      [--run-status {Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout}]
                      [--top]

Exemples

Répertoriez toutes les exécutions d’un registre et affichez les résultats dans une table.

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

Répertorier les exécutions d’une tâche et afficher les résultats d’une table.

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

Répertoriez les 10 dernières exécutions réussies pour un registre et affichez les résultats d’une table.

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

Répertoriez toutes les exécutions qui ont généré l’image « hello-world » pour un registre et affichez les résultats dans une table.

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

Paramètres obligatoires

--registry -r

Nom du registre de conteneurs. Elle doit être spécifiée en minuscules. Vous pouvez configurer le nom de Registre par défaut à l’aide az configure --defaults acr=<registry name>de .

Paramètres facultatifs

--image -t

Nom de l'image. Peut inclure une balise au format « name :tag » ou digest au format « name@digest ».

--name -n

Nom de la tâche.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--run-status

État actuel de l’exécution.

Valeurs acceptées: Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout
--top

Limitez le nombre d’exécutions les plus récentes dans les résultats.

Valeur par défaut: 15
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az acr task logs

Modifier

Afficher les journaux d’activité d’une exécution particulière. Si aucun id d’exécution n’est fourni, affichez les journaux de la dernière exécution créée.

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

Exemples

Afficher les journaux de la dernière exécution créée dans le Registre.

az acr task logs -r myregistry

Affichez les journaux de la dernière exécution créée dans le Registre, filtrées par tâche.

az acr task logs -r myregistry -n MyTask

Afficher les journaux d’activité d’une exécution particulière.

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

Affichez les journaux de la dernière exécution créée dans le Registre qui a créé l’image « hello-world ».

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

Paramètres obligatoires

--registry -r

Nom du registre de conteneurs. Elle doit être spécifiée en minuscules. Vous pouvez configurer le nom de Registre par défaut à l’aide az configure --defaults acr=<registry name>de .

Paramètres facultatifs

--image -t

Nom de l'image. Peut inclure une balise au format « name :tag » ou digest au format « name@digest ».

--name -n

Nom de la tâche.

--no-format

Indique si les journaux doivent être affichés au format brut.

Valeur par défaut: False
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--run-id

Identificateur d’exécution unique.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az acr task run

Modifier

Déclenchez manuellement une tâche susceptible d’attendre des validations Git ou des déclencheurs de mise à jour d’image de 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]

Exemples

Déclenchez une exécution de tâche.

az acr task run -n MyTask -r myregistry

Déclenchez une exécution de tâche en remplaçant le contexte et le fichier transmis pendant la création de tâche avec un dépôt distant.

az acr task run -n MyTask -r myregistry -c https://github.com/Azure-Samples/acr-build-helloworld-node.git -f Dockerfile

Déclenchez une exécution de tâche en remplaçant le contexte et le fichier transmis pendant la création de tâche avec un contexte local.

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

Déclenchez une tâche exécutée en ajoutant ou en remplaçant des arguments de build définis pendant la création de la tâche.

az acr task run -n MyTask -r myregistry --arg DOCKER_CLI_BASE_IMAGE=docker:18.03.0-ce-git

Paramètres obligatoires

--name -n

Nom de la tâche.

--registry -r

Nom du registre de conteneurs. Elle doit être spécifiée en minuscules. Vous pouvez configurer le nom de Registre par défaut à l’aide az configure --defaults acr=<registry name>de .

Paramètres facultatifs

--agent-pool
Préversion

Nom du pool d’agents.

--arg

Argument de génération au format '--arg name[=value]'. Les multiples sont pris en charge en passant « --arg name[=value] » plusieurs fois. IMPORTANT : ce paramètre ne doit pas inclure de mots de passe, de jetons d’accès ou d’informations sensibles d’un type quelconque. Cette valeur de paramètre sera visible par l’équipe ACR à des fins de débogage.

--context -c

URL complète vers le référentiel de code source (nécessite le suffixe « .git » pour un dépôt github) ou un tarball distant (par exemple, «http://server/context.tar.gz ») ou le dépôt d’un artefact OCI dans un registre de conteneurs Azure (par exemple, « oci://myregistry.azurecr.io/myartifact:mytag »). Si « /dev/null » est spécifié, la valeur est définie sur None et ignorée. Il s’agit d’un argument obligatoire si la tâche n’est pas une tâche système.

--file -f

Chemin relatif du fichier task/docker vers le dossier racine du code source. Les fichiers de tâche doivent être suffixes avec « .yaml » ou redirigés à partir de l’entrée standard à l’aide de « - ».

--log-template
Préversion

Le référentiel et le modèle de balise pour exécuter l’artefact de journal à l’aide du format « log/repo :tag » (par exemple, « acr/logs :{.Run.ID}} »). Applicable uniquement au registre activé par CMK.

--no-format

Indique si les journaux doivent être affichés au format brut.

Valeur par défaut: False
--no-logs

N’affichez pas les journaux après la mise en file d’attente réussie de la build.

Valeur par défaut: False
--no-wait

N’attendez pas la fin de l’exécution et revenez immédiatement après la mise en file d’attente de l’exécution.

Valeur par défaut: False
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--secret-arg

Argument de génération de secret au format « --secret-arg name[=value] ». Les multiples sont pris en charge en passant plusieurs fois « --secret-arg name[=value] ». Cette valeur de paramètre n’est pas exposée à l’équipe ACR et est plus adaptée aux informations sensibles.

--set

Valeur de tâche au format '--set name[=value]'. Multiples pris en charge en passant --set plusieurs fois.

--set-secret

Valeur de tâche secrète au format « --set-secret name[=value] ». Multiples pris en charge en passant --set-secret plusieurs fois.

--target

Nom de l’étape de génération cible.

--update-trigger-token
Préversion

Charge utile qui sera renvoyée avec la notification de déclencheur d’image de base.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az acr task show

Modifier

Obtenez les propriétés d’une tâche nommée pour azure Container Registry.

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

Exemples

Obtenez les propriétés d’une tâche, affichant les résultats dans une table.

az acr task show -n MyTask -r myregistry -o table

Obtenez les propriétés d’une tâche, y compris les propriétés sécurisées.

az acr task show -n MyTask -r myregistry --with-secure-properties

Paramètres obligatoires

--name -n

Nom de la tâche.

--registry -r

Nom du registre de conteneurs. Elle doit être spécifiée en minuscules. Vous pouvez configurer le nom de Registre par défaut à l’aide az configure --defaults acr=<registry name>de .

Paramètres facultatifs

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--with-secure-properties

Indique si les propriétés sécurisées d’une tâche doivent être retournées.

Valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az acr task show-run

Modifier

Obtenez les propriétés d’une exécution spécifiée d’une tâche Azure Container Registry.

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

Exemples

Obtenez les détails d’une exécution, affichant les résultats dans une table.

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

Paramètres obligatoires

--registry -r

Nom du registre de conteneurs. Elle doit être spécifiée en minuscules. Vous pouvez configurer le nom de Registre par défaut à l’aide az configure --defaults acr=<registry name>de .

--run-id

Identificateur d’exécution unique.

Paramètres facultatifs

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az acr task update

Modifier

Mettez à jour une tâche pour 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]

Exemples

Mettez à jour les mises à jour de l’image de base pour déclencher toutes les images dépendantes d’un dockerfile à plusieurs étapes et l’état d’une tâche dans Azure Container Registry.

az acr task update -n MyTask -r myregistry --base-image-trigger-type All --status Disabled

Mettez à jour la plateforme pour l’étape build de votre tâche sur Windows (prév Linux).

az acr task update -n MyTask -r myregistry --platform Windows

Mettez à jour les déclencheurs et le contexte de la tâche pour 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

Mettez à jour une tâche pour azure Container Registry. (généré automatiquement)

az acr task update --image MyImage --name MyTask --registry myregistry \
    --context https://github.com/Azure-Samples/acr-build-helloworld-node.git

Paramètres obligatoires

--name -n

Nom de la tâche.

--registry -r

Nom du registre de conteneurs. Elle doit être spécifiée en minuscules. Vous pouvez configurer le nom de Registre par défaut à l’aide az configure --defaults acr=<registry name>de .

Paramètres facultatifs

--agent-pool
Préversion

Nom du pool d’agents.

--arg

Argument de génération au format '--arg name[=value]'. Les multiples sont pris en charge en passant « --arg name[=value] » plusieurs fois. IMPORTANT : ce paramètre ne doit pas inclure de mots de passe, de jetons d’accès ou d’informations sensibles d’un type quelconque. Cette valeur de paramètre sera visible par l’équipe ACR à des fins de débogage.

--auth-mode

Mode d’authentification du registre source.

Valeurs acceptées: Default, None
--base-image-trigger-enabled

Indique si le déclencheur d’image de base est activé.

Valeurs acceptées: false, true
--base-image-trigger-type

Type du déclencheur automatique pour les mises à jour des dépendances d’image de base.

Valeurs acceptées: All, Runtime
--cmd

Commandes à exécuter. Cela prend également en charge des paramètres d’exécution Docker supplémentaires (https://docs.docker.com/engine/reference/commandline/run/) ou même d’autres commandes Docker (https://docs.docker.com/engine/reference/commandline/docker/).

--commit-trigger-enabled

Indique si le déclencheur de validation du contrôle de code source est activé.

Valeurs acceptées: false, true
--context -c

URL complète vers le référentiel de code source (nécessite le suffixe « .git » pour un dépôt github) ou un tarball distant (par exemple, «http://server/context.tar.gz ») ou le dépôt d’un artefact OCI dans un registre de conteneurs Azure (par exemple, « oci://myregistry.azurecr.io/myartifact:mytag »). Si « /dev/null » est spécifié, la valeur est définie sur None et ignorée. Il s’agit d’un argument obligatoire si la tâche n’est pas une tâche système.

--cpu

Configuration du processeur en termes de nombre de cœurs requis pour l’exécution.

--file -f

Chemin relatif du fichier task/docker vers le dossier racine du code source. Les fichiers de tâche doivent être suffixes avec « .yaml » ou redirigés à partir de l’entrée standard à l’aide de « - ».

--git-access-token

Jeton d’accès utilisé pour accéder au fournisseur de contrôle de code source.

--image -t

Nom et balise de l’image au format : ' -t repo/image :tag'. Plusieurs balises sont prises en charge en passant -t plusieurs fois.

--log-template
Préversion

Le référentiel et le modèle de balise pour exécuter l’artefact de journal à l’aide du format « log/repo :tag » (par exemple, « acr/logs :{.Run.ID}} »). Applicable uniquement au registre activé par CMK.

--no-cache

Indique si le cache d’images est activé.

Valeurs acceptées: false, true
--no-push

Indique si l’image générée doit être envoyée (push) au registre.

Valeurs acceptées: false, true
--platform

Plateforme où la génération/tâche est exécutée, par exemple, « windows » et « linux ». Lorsqu’elle est utilisée dans les commandes de build, elle peut également être spécifiée au format « os/arch/variant » pour l’image obtenue. Par exemple, linux/arm/v7. Les parties « arch » et « variant » sont facultatives.

--pull-request-trigger-enabled

Indique si le déclencheur de demande de tirage de contrôle de code source est activé. Le déclencheur est désactivé par défaut.

Valeurs acceptées: false, true
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--secret-arg

Argument de génération de secret au format « --secret-arg name[=value] ». Les multiples sont pris en charge en passant plusieurs fois « --secret-arg name[=value] ». Cette valeur de paramètre n’est pas exposée à l’équipe ACR et est plus adaptée aux informations sensibles.

--set

Valeur de tâche au format '--set name[=value]'. Multiples pris en charge en passant --set plusieurs fois.

--set-secret

Valeur de tâche secrète au format « --set-secret name[=value] ». Multiples pris en charge en passant --set-secret plusieurs fois.

--status

État actuel de la tâche.

Valeurs acceptées: Disabled, Enabled
--target

Nom de l’étape de génération cible.

--timeout

Délai d’expiration en secondes.

--update-trigger-endpoint
Préversion

URL complète du point de terminaison pour recevoir des notifications de déclencheur de mise à jour de l’image de base.

--update-trigger-payload-type
Préversion

Indique s’il faut inclure des métadonnées sur le déclencheur d’image de base dans la charge utile avec le jeton de déclencheur de mise à jour, lorsqu’une notification est envoyée.

Valeurs acceptées: Default, Token
--values

Chemin d’accès du fichier de valeurs/paramètres de tâche par rapport au contexte source.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az acr task update-run

Modifier

Corrigez les propriétés d’exécution d’une tâche Azure Container Registry.

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

Exemples

Mettez à jour une exécution existante à archiver.

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

Paramètres obligatoires

--registry -r

Nom du registre de conteneurs. Elle doit être spécifiée en minuscules. Vous pouvez configurer le nom de Registre par défaut à l’aide az configure --defaults acr=<registry name>de .

--run-id

Identificateur d’exécution unique.

Paramètres facultatifs

--no-archive

Indique si l’exécution doit être archivée.

Valeurs acceptées: false, true
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.