You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/container-registry/container-registry-task-run-template.md
+15-13Lines changed: 15 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
-
title: Run task using template
3
-
description: Run an ACR quick task using an Azure Resource Manager template
2
+
title: Quick task run with template
3
+
description: Queue an ACR task run to build an image using an Azure Resource Manager template
4
4
ms.topic: article
5
5
ms.date: 04/22/2020
6
6
---
@@ -11,24 +11,24 @@ ms.date: 04/22/2020
11
11
12
12
This article shows Azure Resource Manager template examples to queue a [quick task](container-registry-tasks-overview.md#quick-task), similar to one you can create manually using the [az acr build][az-acr-build] command.
13
13
14
-
A Resource Manager template to queue a task is useful in automation scenarios and extends the functionality of `az acr build`. For example:
14
+
A Resource Manager template to queue a task run is useful in automation scenarios and extends the functionality of `az acr build`. For example:
15
15
16
-
* Use a template to create a container registry and immediately queue an ACR task to build and push a container image
17
-
* Create or enable additional resources you can use in a quick task, such as a managed identity for Azure resources
16
+
* Use a template to create a container registry and immediately queue a task run to build and push a container image
17
+
* Create or enable additional resources you can use in a quick task run, such as a managed identity for Azure resources
18
18
19
19
## Limitations
20
20
21
-
* You must specify a remote context such as a GitHub repo as the [source location](container-registry-tasks-overview.md#context-locations) for your task. You can't use a local source context.
21
+
* You must specify a remote context such as a GitHub repo as the [source location](container-registry-tasks-overview.md#context-locations) for your task run. You can't use a local source context.
22
22
* For task runs using a managed identity, only a *user-assigned* managed identity is permitted.
23
23
24
24
## Prerequisites
25
25
26
26
***GitHub account** - Create an account on https://github.com if you don't already have one.
27
27
***Fork sample repository** - For the task examples shown here, use the GitHub UI to fork the following sample repository into your GitHub account: https://github.com/Azure-Samples/acr-build-helloworld-node. This repo contains sample Dockerfiles and source code to build small container images.
28
28
29
-
## Example: Create registry and queue build task
29
+
## Example: Create registry and queue task run
30
30
31
-
This example uses a [sample template](https://github.com/Azure/acr/tree/master/docs/tasks/run-as-deployment/quickdockerbuild) to create a container registry and queue a task that builds and pushes an image.
31
+
This example uses a [sample template](https://github.com/Azure/acr/tree/master/docs/tasks/run-as-deployment/quickdockerbuild) to create a container registry and queue a task run that builds and pushes an image.
32
32
33
33
### Template parameters
34
34
@@ -102,19 +102,21 @@ az acr task logs \
102
102
--run-id ca1
103
103
```
104
104
105
-
The output shows the task log.
105
+
The output shows the task run log.
106
106
107
107
You can also view the task run log in the Azure portal.
108
108
109
109
1. Navigate to your container registry
110
110
2. Under **Services**, select **Tasks** > **Runs**.
111
111
3. Select the run ID, in this case *ca1*.
112
112
113
-
The portal shows the task log.
113
+
The portal shows the task run log.
114
114
115
-
## Example: Queue task with managed identity
115
+
## Example: Task run with managed identity
116
116
117
-
Use a [sample template](https://github.com/Azure/acr/tree/master/docs/tasks/run-as-deployment/quickdockerbuildwithidentity) to queue a task that enables a user-assigned managed identity. During the task run, the identity authenticates to pull an image from another Azure container registry. This scenario is similar to [Cross-registry authentication in an ACR task using an Azure-managed identity](container-registry-tasks-cross-registry-authentication.md). For example, an organization might maintain a centralized registry with base images accessed by multiple development teams.
117
+
Use a [sample template](https://github.com/Azure/acr/tree/master/docs/tasks/run-as-deployment/quickdockerbuildwithidentity) to queue a task that enables a user-assigned managed identity. During the task run, the identity authenticates to pull an image from another Azure container registry.
118
+
119
+
This scenario is similar to [Cross-registry authentication in an ACR task using an Azure-managed identity](container-registry-tasks-cross-registry-authentication.md). For example, an organization might maintain a centralized registry with base images accessed by multiple development teams.
118
120
119
121
### Prepare base registry
120
122
@@ -229,7 +231,7 @@ To view the run log, see steps in the [preceding section](#view-run-log).
229
231
## Next steps
230
232
231
233
* See more template examples in the [ACR GitHub repo](https://github.com/Azure/acr/tree/master/docs/tasks/run-as-deployment).
232
-
* For details about template properties, see the template reference for [Tasks](/azure/templates/microsoft.containerregistry/2019-06-01-preview/registries/tasks) and [Task runs](/azure/templates/microsoft.containerregistry/2019-06-01-preview/registries/taskruns).
234
+
* For details about template properties, see the template reference for [Task runs](/azure/templates/microsoft.containerregistry/2019-06-01-preview/registries/taskruns) and [Tasks](/azure/templates/microsoft.containerregistry/2019-06-01-preview/registries/tasks).
0 commit comments