教程：按定义的计划运行 ACR 任务

本教程介绍如何按计划运行 ACR 任务。 通过设置一个或多个计时器触发器来计划任务。 计时器触发器可以单独使用，也可以与其他任务触发器结合使用。

本教程介绍如何计划任务及完成以下任务：

任务计划适用于如下所述的方案：

• 运行容器工作负荷来执行计划性维护操作。 例如，运行容器化应用以从注册表中删除不需要的映像。
• 在工作日针对要在现场监视的生产映像运行一组测试。

先决条件

• 在 Azure Cloud Shell 中使用 Bash 环境。 有关详细信息，请参阅 Azure Cloud Shell 入门。

  

• 如果要在本地运行 CLI 引用命令，请安装 Azure CLI。 如果在 Windows 或 macOS 上运行，请考虑在 Docker 容器中运行 Azure CLI。 有关详细信息，请参阅如何在 Docker 容器中运行 Azure CLI。

  • 如果使用的是本地安装，请使用 az login 命令登录到 Azure CLI。 要完成身份验证过程，请执行终端中显示的步骤。 有关其他登录选项，请参阅 使用 Azure CLI 向 Azure 进行身份验证。

  • 按照提示，请在首次使用时安装 Azure CLI 扩展。 有关扩展的详细信息，请参阅 使用和管理 Azure CLI 中的扩展。

  • 运行 az version 以查找安装的版本和依赖库。 若要升级到最新版本，请运行 az upgrade。

关于计划任务

• 使用 cron 表达式的触发器 - 任务的计时器触发器使用 cron 表达式。 该表达式是包含五个字段的字符串，这些字段指定要触发任务的分钟、小时、日期、月份和星期。 支持的最高频率为每分钟一次。

  例如，表达式 "0 12 * * Mon-Fri" 在每个工作日的中午（UTC 时间）触发任务。 请参阅本文稍后所述的详细信息。

• 多个计时器触发器 - 允许将多个计时器添加到g wh 任务，前提是计划不同。

  • 可在创建任务时指定多个计时器触发器，也可以在以后添加。
  • （可选）为触发器命名以便于管理，否则 ACR 任务将提供默认的触发器名称。
  • 如果多个计时器计划在某个时间发生重叠，ACR 任务将在每个计时器的计划时间触发任务。

• 其他任务触发器 - 在计时器触发的任务中，还可以基于源代码提交或基础映像更新启用触发器。 与其他 ACR 任务一样，也可以手动运行计划任务。

创建具有计时器触发器的任务

任务命令

首先，使用适用于环境的值填充以下 shell 环境变量。 此步骤并非必须执行的步骤，但它能让在此教程中执行多个 Azure CLI 命令更容易。 如果未填充环境变量，则每当示例命令中出现一个值，都必须手动替换该值。

ACR_NAME=<registry-name>        # The name of your Azure container registry

使用 az acr task create 命令创建任务时，可以选择性地添加计时器触发器。 添加 --schedule 参数并为计时器传递 cron 表达式。

举个简单的例子，以下任务会触发每天 21:00（UTC 时间）从 Microsoft 容器注册表运行 hello-world 映像的操作。 该任务无需源代码上下文即可运行。

az acr task create \
  --name timertask \
  --registry $ACR_NAME \
  --cmd mcr.microsoft.com/hello-world \
  --schedule "0 21 * * *" \
  --context /dev/null

运行 az acr task show 命令查看该计时器触发器是否已配置。 默认情况下，还启用了基础映像更新触发器。

az acr task show --name timertask --registry $ACR_NAME --output table

NAME      PLATFORM    STATUS    SOURCE REPOSITORY       TRIGGERS
--------  ----------  --------  -------------------     -----------------
timertask linux       Enabled                           BASE_IMAGE, TIMER

此外，还有一个简单的示例，即使用源代码上下文运行的任务。 以下任务会触发每天 21:00（UTC 时间）从 Microsoft 容器注册表运行 hello-world 映像的操作。

按照先决条件生成源代码上下文，然后使用上下文创建计划任务。

az acr task create \
  --name timertask \
  --registry $ACR_NAME \
  --context https://github.com/$GIT_USER/acr-build-helloworld-node.git#master \
  --file Dockerfile \
  --image timertask:{{.Run.ID}} \
  --git-access-token $GIT_PAT \
  --schedule "0 21 * * *"

运行 az acr task show 命令查看该计时器触发器是否已配置。 默认情况下，还启用了基础映像更新触发器。

az acr task show --name timertask --registry $ACR_NAME --output table

运行 az acr task run 命令以手动触发任务。

az acr task run --name timertask --registry $ACR_NAME

触发任务

使用 az acr task run 手动触发任务，以确保正确设置该任务：

az acr task run --name timertask --registry $ACR_NAME

如果容器成功运行，输出将如下所示。 该输出经过简化，只显示关键步骤

Queued a run with ID: cf2a
Waiting for an agent...
2020/11/20 21:03:36 Using acb_vol_2ca23c46-a9ac-4224-b0c6-9fde44eb42d2 as the home volume
2020/11/20 21:03:36 Creating Docker network: acb_default_network, driver: 'bridge'
[...]
2020/11/20 21:03:38 Launching container with name: acb_step_0

Hello from Docker!
This message shows that your installation appears to be working correctly.
[...]

在计划的时间之后，运行 az acr task list-runs 命令验证计时器是否按预期触发了任务：

az acr task list-runs --name timertask --registry $ACR_NAME --output table

如果计时器成功，输出将如下所示：

RUN ID    TASK       PLATFORM    STATUS     TRIGGER    STARTED               DURATION
--------  ---------  ----------  ---------  ---------  --------------------  ----------
ca15      timertask  linux       Succeeded  Timer      2020-11-20T21:00:23Z  00:00:06
ca14      timertask  linux       Succeeded  Manual     2020-11-20T20:53:35Z  00:00:06

管理计时器触发器

使用 az acr task timer 命令管理 ACR 任务的计时器触发器。

添加或更新计时器触发器

创建任务后，可以选择性地使用 az acr task timer add 命令添加计时器触发器。 以下示例将名为 timer2 的计时器触发器添加到前面创建的 timertask。 此计时器每日 10:30（UTC 时间）触发任务。

az acr task timer add \
  --name timertask \
  --registry $ACR_NAME \
  --timer-name timer2 \
  --schedule "30 10 * * *"

使用 az acr task timer update 命令更新现有触发器的计划或更改其状态。 例如，更新名为 timer2 的触发器，以在 11:30（UTC 时间）触发任务：

az acr task timer update \
  --name timertask \
  --registry $ACR_NAME \
  --timer-name timer2 \
  --schedule "30 11 * * *"

列出计时器触发器

az acr task timer list 命令可显示针对任务设置的计时器触发器：

az acr task timer list --name timertask --registry $ACR_NAME

示例输出：

[
  {
    "name": "timer2",
    "schedule": "30 11 * * *",
    "status": "Enabled"
  },
  {
    "name": "t1",
    "schedule": "0 21 * * *",
    "status": "Enabled"
  }
]

删除计时器触发器

使用 az acr task timer remove 命令从任务中删除计时器触发器。 以下示例从 timertask 中删除 timer2 触发器：

az acr task timer remove \
  --name timertask \
  --registry $ACR_NAME \
  --timer-name timer2

Cron 表达式

ACR 任务使用 NCronTab 库来解释 cron 表达式。 ACR 任务支持的表达式包含空格分隔的五个必需字段：

{minute} {hour} {day} {month} {day-of-week}

cron 表达式使用的时区为协调世界时 (UTC)。 时间为 24 小时制。

每个字段可以具有下列类型之一的值：

若要指定月份或天，可以使用数字值、名称或名称的缩写：

• 对于天，数字值为 0 到 6，其中 0 表示星期日。
• 名称采用英语。 例如：Monday、January。
• 名称不区分大小写。
• 名称可缩写。 建议对缩写使用三个字母。 例如：Mon、Jan。

Cron 示例

清理资源

若要删除本系列教程中创建的所有资源（包括容器注册表、容器实例、密钥保管库和服务主体），请发出以下命令：

az group delete --resource-group $RES_GROUP
az ad sp delete --id http://$ACR_NAME-pull

后续步骤

本教程介绍了如何创建由计时器自动触发的 Azure 容器注册表任务。

有关使用计划任务清理注册表中的存储库的示例，请参阅从 Azure 容器注册表中自动清除映像。

有关由源代码提交或基础映像更新触发的任务的示例，请参阅 ACR 任务系列教程中的其他文章。