通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

更新 Azure 容器实例中的容器

  • 项目

在正常操作容器实例期间，你可能会发现有必要更新容器组中正在运行的容器。 例如，你可能希望更新一个属性（例如映像版本、DNS 名称或环境变量），或者刷新其应用程序已出现故障的容器中的属性。

通过使用至少一个已修改的属性重新部署现有组，来更新正在运行的容器组中的容器。 更新某个容器组时，该组中所有正在运行的容器会就地重启（通常在同一基础容器主机上进行）。

注意

已终止或已删除的容器组无法更新。 容器组终止（处于“成功”或“失败”状态）或被删除后，必须将该组作为新组进行部署。 请参阅其他限制。

更新容器组

若要更新现有容器组，请执行以下操作：

  • 发出 create 命令（或使用 Azure 门户），指定现有组的名称
  • 修改或添加至少一个支持在重新部署时进行更新的组属性。 某些属性不支持更新。
  • 使用先前提供的值设置其他属性。 如果未为某个属性设置值，则该属性将恢复为其默认值。

注意

如果将所有属性设置为之前提供的值，并且不修改或添加任何属性，则容器将重启以响应创建命令。

提示

YAML 文件有助于维护容器组的部署配置，你可以从其着手来部署已更新的组。 如果使用了其他方法来创建组，则可使用 az container export 将配置导出到 YAML。

示例

以下 Azure CLI 示例更新具有新 DNS 名称标签的容器组。 由于该组的 DNS 名称标签属性是可以更新的属性，因此会重新部署容器组，并重启其容器。

具有 DNS 名称标签 myapplication-staging 的初始部署：

# Create container group
az container create --resource-group myResourceGroup --name mycontainer \
    --image nginx:alpine --dns-name-label myapplication-staging

使用新的 DNS 名称标签“application”更新容器组，并使用先前使用的值设置其余属性：

# Update DNS name label (restarts container), leave other properties unchanged
az container create --resource-group myResourceGroup --name mycontainer \
    --image nginx:alpine --dns-name-label myapplication

更新的好处

更新现有容器组的主要好处是加快部署速度。 重新部署现有容器组时，会从前一部署缓存的层中提取该组的容器映像层。 此过程不会像新部署中一样从注册表中提取所有全新的映像层，而只会提取修改的层（如果有）。

如果更新容器组而不是删除再部署新的容器组，则基于大型容器映像的应用程序（例如 Windows Server Core）的部署速度会有明显的改善。

限制

  • 并非容器组的所有属性都支持更新。 若要更改某个容器组的某些属性，必须先删除，再重新部署该组。 请参阅需要容器删除操作的属性。
  • 更新某个容器组时，该容器组中的所有容器都会重启。 无法对多容器组中的特定容器执行更新或就地重启。
  • 容器组的 IP 地址通常会在更新之后保留，但不能保证保持不变。 只要将容器组部署到相同的基础主机，容器组就会保留其 IP 地址。 有些 Azure 内部事件可能会导致容器组重新部署到其他主机，尽管这很少见。 为了避免此问题，建议对容器实例使用 DNS 名称标签。
  • 已终止或已删除的容器组无法更新。 容器组停止（处于“已终止”状态）或被删除后，该组将作为新组进行部署。

注意

如果 Azure 容器组附加到 Azure 存储配置文件，则更新命令可能无法正常工作。

需要容器删除操作的属性

并非所有容器组属性都可以更新。 例如，若要更改容器的重启策略，必须先删除容器组，然后再重新创建它。

更改以下属性需要先删除再重新部署容器组：

  • OS 类型
  • CPU、内存或 GPU 资源
  • 重启策略
  • 网络配置文件
  • 可用性区域

重要

自 2021-07-01 API 版本起，网络配置文件已停用。 如果使用的是此版本或更新版本，请忽略与网络配置文件相关的任何步骤和操作。

删除再重新创建某个容器组时，不是“重新部署”该组，而是新建一个容器组。 将从注册表中全新提取所有映像层，而不是从前一个部署缓存的层中提取。 由于部署到不同的基础主机，容器的 IP 地址也可能会更改。

后续步骤

本文中多次提到了容器组。 Azure 容器实例中的每个容器部署在容器组中，容器组可以包含多个容器。 以下文章提供有关容器组的详细信息：