将Buildah构建的镜像从Azure容器注册表部署到ACI超时失败如何解决？

常见触发原因 #

• 镜像架构不兼容：Buildah默认会根据构建机器的架构生成镜像，如果你在Arm架构设备（如苹果M系列芯片、Arm服务器）上构建，生成的arm64架构镜像无法在仅支持amd64架构的ACI环境运行，会导致启动阶段无限卡住直到超时。
• 启动命令配置异常：镜像未配置正确的前台常驻启动命令，容器启动后立刻退出，ACI会按照默认重启策略无限重启容器，导致部署状态一直处于未完成状态，最终触发30分钟超时。
• 网络访问限制：如果ACI部署在自定义VNet内，且ACR开启了网络访问限制，未将ACI所属VNet/子网加入允许列表，会导致ACI一直无法拉取镜像，长时间重试后超时。你之前验证的镜像可推拉大概率是本地公网环境的测试结果，和ACI的网络环境不一致。
• 镜像格式兼容性问题：Buildah默认生成的OCI格式镜像如果使用了较新的OCI规范特性，ACI的旧版容器运行时可能无法识别，卡在镜像解压或初始化阶段。
• 镜像体积过大：单镜像体积超过2G时，ACI拉取镜像的耗时很容易超过部署阈值，触发超时。
• 资源配额不足：对应区域的ACI CPU、内存配额已经耗尽，资源调度长时间无法完成最终超时。

解决建议 #

• 校验并指定镜像架构：执行buildah inspect <镜像名称>查看Architecture字段，确认为amd64。如果为arm64，重新构建时指定平台参数：buildah build --platform linux/amd64 -t <镜像标签> .，重新推送ACR后再测试部署。
• 本地模拟ACI运行逻辑：不要使用交互模式启动容器，执行podman run --rm -d <本地镜像标签>，查看容器是否能持续运行超过5分钟不退出。如果自动退出，修改Containerfile的ENTRYPOINT/CMD配置，确保主进程前台运行，不要使用后台守护进程模式。
• 排查网络与权限配置：如果用VNet部署ACI，确认ACR防火墙已放通ACI所属VNet/子网，同时部署ACI时正确配置了ACR的拉取凭证（管理员账号、托管身份均可）。如果是公网部署ACI，可先尝试部署公共nginx镜像验证环境可用性，排除基础资源问题。
• 调整镜像构建格式：构建时指定Docker兼容格式，命令为buildah build --format docker -t <镜像标签> .，避免OCI格式的兼容性问题。
• 优化镜像大小：使用多阶段构建删除冗余依赖、构建缓存等文件，尽量将镜像体积控制在1G以内。
• 检查配额：到Azure订阅的配额页面，确认对应区域的ACI CPU、内存配额未耗尽，如果配额不足提交工单申请调整。

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