Azure容器实例始终处于等待状态无法启动，请求排查方案

一、部署YAML配置的潜在问题 #

1. 资源请求过高
   你的配置中请求了1.0 CPU和1.5GB内存，瑞典中部区域的容器实例可能因资源不足导致调度失败，进而卡在Waiting状态。建议先调低资源请求测试，比如：

   resources:
     requests:
       cpu: 0.5
       memoryInGB: 0.5
   

2. 镜像与挂载路径不匹配（针对Nginx测试场景）
   测试官方Nginx镜像时，你挂载了/app/data路径，但Nginx默认的工作目录或数据路径并非此处，虽然这不一定直接导致Waiting，但可能引发后续启动异常。可以先移除卷挂载配置，简化部署后再验证。

3. 镜像地址一致性
   你提到使用的是Uptime Kuma镜像，但YAML中配置的是acrcustom.azurecr.io/nginx-app:v1，确保测试不同镜像时，YAML中的镜像地址与实际要部署的镜像一致，避免拉取错误镜像。

二、获取调试日志与状态信息的方法 #

1. 查看容器实时启动日志
   使用Azure CLI执行以下命令，查看容器启动过程的实时输出：

   az container attach --resource-group <你的资源组名称> --name uptime-kuma
   

   即使容器处于Waiting状态，该命令也可能返回调度或镜像拉取阶段的错误信息。

2. 检查容器组事件
   容器组的事件会记录调度失败、资源不足、权限错误等关键信息，通过CLI查询：

   az container show --resource-group <你的资源组名称> --name uptime-kuma --query 'instanceView.events' -o table
   

   或在Azure门户中进入容器组的实例视图页面，查看事件列表。

3. 尝试直接连接容器
   如果容器已部分启动，可通过Azure CLI或门户的连接功能进入容器内部，检查文件系统或启动脚本：

   az container exec --resource-group <你的资源组名称> --name uptime-kuma --container-name uptime-kuma-app --exec-command "/bin/bash"
   

三、其他排查步骤 #

1. 检查订阅资源配额
   登录Azure门户，进入订阅->配额，搜索“Container Instances”，确认瑞典中部区域的CPU和内存配额是否满足你的资源请求。如果配额不足，可提交配额提升申请。

2. 简化部署配置
   移除卷挂载、私有镜像拉取等复杂配置，先部署一个最基础的Nginx容器验证环境：

   api-version: 2021-12-25
   location: swedencentral
   name: test-basic-nginx
   properties:
     containers:
     - name: nginx
       properties:
         image: nginx:latest
         ports:
         - port: 80
           protocol: TCP
         resources:
           requests:
             cpu: 0.5
             memoryInGB: 0.5
     ipAddress:
       dnsNameLabel: test-basic-nginx
       ports:
       - port: 80
         protocol: TCP
       type: Public
     osType: Linux
   type: Microsoft.ContainerInstance/containerGroups
   

3. 验证ACR访问权限
   如果使用私有ACR镜像，确认ACR的网络设置未限制容器实例的访问：

   • 检查ACR的网络页面，是否允许所有网络访问，或已将容器实例所在的虚拟网络添加到允许列表。
   • 确认YAML中的imageRegistryCredentials用户名和密码正确，可通过az acr login --name acrcustom测试凭据有效性。

内容的提问来源于stack exchange，提问作者tonsteri