Azure App Service启动命令执行后仍失效：pyOpenMS致Flask应用启动失败

核心原因 #

直接在App Service启动命令中执行apt命令但未生效，大概率是两个问题：

1. 权限不足：默认App Service容器运行的是非root用户，执行apt操作需要加sudo提升权限
2. 命令执行顺序或完整性问题：启动命令未将依赖安装与应用启动用&&串联，导致依赖还没安装完成就启动了应用，或者只执行了依赖安装却没启动应用

可行解决方案 #

方案1：修正启动命令（最简单） #

在App Service的「配置」-「常规设置」-「启动命令」中，使用带sudo且串联应用启动的命令，示例：

sudo apt update && sudo apt-get install -y libglib2.0-0 libsm6 libxrender1 libxext6 && gunicorn --bind=0.0.0.0 --timeout 600 app:app

注意：将末尾的gunicorn --bind=0.0.0.0 --timeout 600 app:app替换成你实际的应用启动命令（比如用flask run的话要先设置FLASK_APP等环境变量）

方案2：用自定义启动脚本 #

1. 在项目根目录创建startup.sh脚本，内容如下：

#!/bin/bash
# 安装系统依赖
sudo apt update > /dev/null
sudo apt-get install -y libglib2.0-0 libsm6 libxrender1 libxext6 > /dev/null
# 启动应用
gunicorn --bind=0.0.0.0 --timeout 600 app:app

2. 在Azure DevOps的构建步骤中，添加脚本执行权限：

chmod +x startup.sh

3. 在App Service配置中设置启动命令为./startup.sh

方案3：自定义Docker镜像（最稳定） #

如果频繁部署，推荐用自定义镜像预先安装好所有依赖，避免每次部署重复安装：

1. 项目根目录创建Dockerfile：

# 基于Azure官方Python镜像
FROM mcr.microsoft.com/azure-app-service/python:3.10-slim

WORKDIR /app

# 安装Python依赖
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 安装pyOpenMS需要的系统依赖
RUN apt-get update && \
    apt-get install -y libglib2.0-0 libsm6 libxrender1 libxext6 && \
    rm -rf /var/lib/apt/lists/*  # 清理缓存减小镜像体积

# 复制应用代码
COPY . .

# 启动应用
CMD ["gunicorn", "--bind=0.0.0.0:8000", "--timeout", "600", "app:app"]

2. 在Azure DevOps中配置Docker构建任务，将镜像推送到Azure Container Registry，再部署到App Service即可

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