排查 Azure 容器实例中的常见问题

项目
07/03/2023

本文展示了如何排查管理容器或向 Azure 容器实例部署容器时出现的常见问题。另请参阅常见问题解答。

如果需要更多支持，请参阅 Azure 门户中提供的“帮助 + 支持”选项。

容器组部署过程中的问题

命名约定

定义容器规格时，某些参数需要遵循命名限制。下表包含容器组属性的特定要求。有关更多信息，请参见 Azure 体系结构中心中的命名约定和 Azure 资源的命名规则和限制。

范围	长度	大小写	有效的字符	建议的模式	示例
容器名称¹	1-63	小写	第一个或最后一个字符不能为字母数字和连字符	`<name>-<role>-container<number>`	`web-batch-container1`
容器端口	介于 1 和 65535 之间	Integer	一个介于 1 和 65535 之间的整数	`<port-number>`	`443`
DNS 名称标签	5-63	不区分大小写	第一个或最后一个字符不能为字母数字和连字符	`<name>`	`frontend-site1`
环境变量	1-63	不区分大小写	第一个或最后一个字符不能为字母数字和下划线 (_)	`<name>`	`MY_VARIABLE`
卷名	5-63	小写	第一个或最后一个字符不能为字母数字和连字符。不能包含两个连续的连字符。	`<name>`	`batch-output-volume`

¹如果没有单独指定容器实例（如通过 az container create 命令部署），那么还会对容器组名称进行限制。

不受支持的映像的操作系统版本

如果指定了 Azure 容器实例不支持的映像，则将返回 OsVersionNotSupported 错误。该错误类似于以下内容，其中 {0} 是你尝试部署的映像的名称：

{
  "error": {
    "code": "OsVersionNotSupported",
    "message": "The OS version of image '{0}' is not supported."
  }
}

在部署基于半年频道版本 1709 或 1803（不支持这些版本）的 Windows 映像时，通常会遇到此错误。有关 Azure 容器实例中支持的 Windows 映像，请参阅常见问题解答。

无法请求映像

如果 Azure 容器实例最初无法请求映像，则会重试一段时间。如果映像请求操作继续失败，ACI 最终会使部署失败，可能会显示 Failed to pull image 错误。

若要解决此问题，请删除容器实例，然后重试部署。请确保映像存在于注册表中，并且你已正确键入映像名称。

如果无法请求映像，az container show 的输出会显示如下事件：

"events": [
  {
    "count": 3,
    "firstTimestamp": "2017-12-21T22:56:19+00:00",
    "lastTimestamp": "2017-12-21T22:57:00+00:00",
    "message": "pulling image \"mcr.microsoft.com/azuredocs/aci-hellowrld\"",
    "name": "Pulling",
    "type": "Normal"
  },
  {
    "count": 3,
    "firstTimestamp": "2017-12-21T22:56:19+00:00",
    "lastTimestamp": "2017-12-21T22:57:00+00:00",
    "message": "Failed to pull image \"mcr.microsoft.com/azuredocs/aci-hellowrld\": rpc error: code 2 desc Error: image t/aci-hellowrld:latest not found",
    "name": "Failed",
    "type": "Warning"
  },
  {
    "count": 3,
    "firstTimestamp": "2017-12-21T22:56:20+00:00",
    "lastTimestamp": "2017-12-21T22:57:16+00:00",
    "message": "Back-off pulling image \"mcr.microsoft.com/azuredocs/aci-hellowrld\"",
    "name": "BackOff",
    "type": "Normal"
  }
],

资源不可用错误

由于 Azure 中的区域资源负载不同，尝试部署容器实例时可能会收到以下错误：

The requested resource with 'x' CPU and 'y.z' GB memory is not available in the location 'example region' at this moment. Please retry with a different resource request or in another location.

此错误指示由于尝试部署的区域中负载较重，无法在此时为容器分配指定的资源。使用以下一个或多个缓解步骤来帮助解决此问题。

验证容器部署设置是否位于 Azure 容器实例的区域可用性中定义的参数内
为容器指定较低的 CPU 和内存设置
部署到其他 Azure 区域
稍后部署

容器组运行过程中的问题

容器遇到了没有显式用户输入的隔离重启

容器组在没有显式用户输入的情况下可能重启的原因有两个广泛的类别。首先，容器可能会遇到应用程序进程崩溃导致的重启。 ACI 服务建议应用 Application Insights SDK、容器组指标和容器组日志等可观测性解决方案来确定应用程序遇到问题的原因。其次，由于维护事件，客户可能会遇到 ACI 基础结构启动的重启。若要提高应用程序的可用性，请在入口组件（例如应用程序网关或流量管理器）后面运行多个容器组。

容器不断退出并重启（没有长时间运行的进程）

容器组的重启策略默认为 Always，因此容器组中的容器在运行完成后始终会重启。如果打算运行基于任务的容器，则可能需要将此策略更改为 OnFailure 或 Never。如果指定了“失败时” ，但仍不断重启，则可能容器中执行的应用程序或脚本存在问题。

在没有长时间运行的进程的情况下运行容器组时，可能会看到重复退出并重启 Ubuntu 或 Alpine 等映像。通过 EXEC 连接将无法正常工作，因为容器没有使其保持活动的进程。若要解决此问题，请在容器组部署中包含如下所示的启动命令，以使容器保持运行。

## Deploying a Linux container
az container create -g MyResourceGroup --name myapp --image ubuntu --command-line "tail -f /dev/null"

## Deploying a Windows container
az container create -g myResourceGroup --name mywindowsapp --os-type Windows --image mcr.microsoft.com/windows/servercore:ltsc2019
 --command-line "ping -t localhost"

容器实例 API 和 Azure 门户包含 restartCount 属性。若要检查容器的重启次数，可在 Azure CLI 中使用 az container show 命令。在以下示例输出中（为简洁起见已将其截断），可以在输出末尾看到 restartCount 属性。

...
 "events": [
   {
     "count": 1,
     "firstTimestamp": "2017-11-13T21:20:06+00:00",
     "lastTimestamp": "2017-11-13T21:20:06+00:00",
     "message": "Pulling: pulling image \"myregistry.azurecr.cn/aci-tutorial-app:v1\"",
     "type": "Normal"
   },
   {
     "count": 1,
     "firstTimestamp": "2017-11-13T21:20:14+00:00",
     "lastTimestamp": "2017-11-13T21:20:14+00:00",
     "message": "Pulled: Successfully pulled image \"myregistry.azurecr.cn/aci-tutorial-app:v1\"",
     "type": "Normal"
   },
   {
     "count": 1,
     "firstTimestamp": "2017-11-13T21:20:14+00:00",
     "lastTimestamp": "2017-11-13T21:20:14+00:00",
     "message": "Created: Created container with id bf25a6ac73a925687cafcec792c9e3723b0776f683d8d1402b20cc9fb5f66a10",
     "type": "Normal"
   },
   {
     "count": 1,
     "firstTimestamp": "2017-11-13T21:20:14+00:00",
     "lastTimestamp": "2017-11-13T21:20:14+00:00",
     "message": "Started: Started container with id bf25a6ac73a925687cafcec792c9e3723b0776f683d8d1402b20cc9fb5f66a10",
     "type": "Normal"
   }
 ],
 "previousState": null,
 "restartCount": 0
...
}

注意

Linux 分发的大多数容器映像会设置一个 shell（如 bash）作为默认命令。由于 Shell 本身不是长时间运行的服务，因此如果这些容器配置了“始终”重启策略，会立即退出并不断重启。

容器启动时间过长

影响 Azure 容器实例中的容器启动时间的三个主要因素是：

映像大小
映像位置
缓存的映像

Windows 映像具有其他注意事项。

映像大小

如果容器启动时间过长，但最终成功启动，请先查看容器映像大小。由于 Azure 容器实例按需请求容器映像，因此显示的启动时间与映像大小直接相关。

可在 Docker CLI 中使用 docker images 命令查看容器映像大小：

docker images

REPOSITORY                                    TAG       IMAGE ID        CREATED          SIZE
mcr.microsoft.com/azuredocs/aci-helloworld    latest    7367f3256b41    15 months ago    67.6MB

保持容器较小的关键是，确保最终映像不包含任何运行时不需要的内容。执行此操作的一种方法是使用多阶段生成。多阶段生成可轻松确保最终映像仅包含应用程序所需的项目，而不包含任何生成时需要的额外内容。

映像位置

若要减小映像请求对容器启动时间的影响，另一种方法是在希望部署容器实例的同一区域的 Azure 容器注册表中托管容器映像。这会缩短容器映像需要经过的网络路径，显著缩短下载时间。

缓存的映像

对于基于常用 Windows 基本映像（包括 nanoserver:1809、servercore:ltsc2019 和 servercore:1809）的映像，Azure 容器实例使用一种缓存机制来帮助加快容器启动时间。常用的 Linux 映像（例如 ubuntu:1604 和 alpine:3.6）也会缓存。对于 Windows 和 Linux 映像，请避免使用 latest 标记。有关指南，请参阅容器注册表的映像标记最佳做法。若要获取缓存的映像和标记的最新列表，请使用列出缓存的映像 API。

注意

在 Azure 容器实例中使用基于 Windows Server 2019 的映像处于预览状态。

Windows 容器慢速网络准备情况

在初始创建时，Windows 容器在最多 30 秒内（在极少数情况下，会更长时间）可能没有入站或出站连接。如果容器应用程序需要 Internet 连接，请添加延迟和重试逻辑以允许 30 秒建立 Internet 连接。初始设置后，容器网络应适当恢复。

无法连接到基础 Docker API 或运行特权容器

Azure 容器实例不公开对托管容器组的底层基础结构的直接访问。这包括对容器运行时、业务流程技术和运行特权容器操作的访问。若要查看 ACI 支持的操作，请参阅 REST 参考文档。如果缺少某些内容，请在 ACI 反馈论坛上提交请求。

容器组 IP 地址可能会由于端口不匹配而无法访问

Azure 容器实例尚不支持具有常规 docker 配置的端口映射。如果你发现容器组的 IP 地址在你认为应该可以访问的情况下无法访问，请确保已使用 ports 属性将容器映像配置为侦听在容器组中公开的相同端口。

如果要确认 Azure 容器实例可以在容器映像中配置的端口上侦听，请测试公开了该端口的 aci-helloworld 映像的部署。另外，请运行 aci-helloworld 应用，使其在该端口上侦听。 aci-helloworld 接受一个可选的环境变量 PORT 来替代它用于侦听的默认端口 80。例如，若要测试端口 9000，请在创建容器组时设置该环境变量：

设置容器组来公开端口 9000，并将端口号传递为环境变量的值。此示例已针对 Bash shell 格式化。若要使用其他 shell（例如 PowerShell 或命令提示符），需要相应地调整变量赋值。
```
az container create --resource-group myResourceGroup \
--name mycontainer --image mcr.microsoft.com/azuredocs/aci-helloworld \
--ip-address Public --ports 9000 \
--environment-variables 'PORT'='9000'
```
在 az container create 的命令输出中找到该容器组的 IP 地址。查找 ip 的值。
成功预配容器后，在浏览器中浏览到容器应用程序的 IP 地址和端口，例如：192.0.2.0:9000。

你应该会看到 Web 应用程序显示的消息：“欢迎使用 Azure 容器实例！”。

完成容器的操作后，使用 az container delete 命令将其删除：

az container delete --resource-group myResourceGroup --name mycontainer

后续步骤

了解如何检索容器日志和事件来帮助调试你的容器。