Azure App Service容器启动时PowerShell脚本未执行问题

1. 调整Dockerfile的启动命令格式 #

Azure App Service的Windows容器环境对CMD的shell解析逻辑和本地Docker有差异，换用exec格式的指令能避免解析问题：

# 替换原CMD指令为以下内容
CMD ["powershell.exe", "-ExecutionPolicy", "Bypass", "-File", "C:/azp/start.ps1"]

或者用ENTRYPOINT+CMD的组合，确保PowerShell环境被正确初始化：

ENTRYPOINT ["powershell.exe", "-ExecutionPolicy", "Bypass"]
CMD ["-File", "C:/azp/start.ps1"]

2. 确保代理脚本保持前台运行 #

App Service要求容器必须有长期运行的前台进程，如果start.ps1启动代理后直接退出，容器会被判定为启动失败并重启，看起来像命令没执行。在start.ps1末尾添加进程等待逻辑：

# 启动代理后，等待代理进程持续运行
Wait-Process -Name Agent.Listener

或者在启动代理时用Start-Process -Wait参数，强制脚本保持前台状态。

3. 检查App Service启动命令是否被覆盖 #

登录App Service门户，进入配置 > 常规设置，确认“启动命令”字段为空。如果这里有内容，会直接覆盖Dockerfile中的CMD指令，导致自定义脚本不执行。

4. 排查脚本路径与权限问题 #

虽然Dockerfile设置了WORKDIR /azp，但App Service可能重置工作目录，所以必须用绝对路径调用脚本。同时确保脚本有执行权限，在Dockerfile中添加：

RUN icacls "C:/azp/start.ps1" /grant Everyone:F

5. 查看详细启动日志 #

部署中心日志不够全面，去App Service门户的日志 > 日志流查看容器启动时的实时输出，能直接看到PowerShell命令的执行情况、是否有报错信息，快速定位问题。

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