基于容器的Azure Web App部署SonarQube端口9000无响应问题咨询

Azure Web App非80端口镜像支持说明 #

Azure Web App完全支持使用暴露非80端口的Docker Hub镜像，你配置WEBSITES_PORT=9000的操作本身符合官方要求，本次启动失败为其他运行环境或配置问题导致。

故障可能原因 #

• 内核参数不满足SonarQube运行要求：这是最常见的触发原因。SonarQube内置Elasticsearch服务，强制要求宿主机vm.max_map_count参数不低于262144，默认Azure Web App容器底层的宿主机参数未达到该要求，会导致SonarQube启动过程中直接崩溃退出，还没到监听9000端口的阶段，因此平台健康检查无法收到响应。
• 实例资源配额不足：SonarQube最低运行要求为2核4G内存，如果你使用的是B1、S1等小规格实例，服务启动过程中会因内存不足被OOM机制杀掉，无法完成端口监听。
• 服务启动超时：SonarQube首次启动需要完成初始化、内置数据库配置、插件加载等操作，耗时较长，Azure Web App默认容器启动超时时间为230秒，服务还未启动完成就会被平台判定为启动失败强制销毁。
• 持久化存储配置错误：SonarQube需要写入数据、日志、插件等文件到指定目录，如果你未配置Azure Files持久化挂载，或是挂载的存储目录权限不足，会导致服务启动时写入失败直接退出。
• 外置数据库配置错误：如果使用生产级外置数据库（PostgreSQL/MySQL等），连接地址、账号密码、数据库版本不兼容的问题也会导致SonarQube启动中断，不会监听端口。

快速修复建议 #

• 拉取完整的容器内部运行日志，确认是否存在内核参数不足、内存溢出、数据库连接失败等明确报错，缩小排查范围
• 升级实例规格到至少P1v2（2核7G），排除资源不足问题
• 添加应用配置WEBSITES_CONTAINER_START_TIME_LIMIT=1800，将容器启动超时时间拉长到30分钟，给服务足够的初始化时间
• 针对内核参数问题，你可以在Web App的启动命令配置项中填入以下内容，启动时先修改内核参数再启动SonarQube服务：

  sysctl -w vm.max_map_count=262144 && /opt/sonarqube/docker/entrypoint.sh
  

• 检查持久化存储挂载配置，确保sonarqube用户对挂载的/opt/sonarqube/data、/opt/sonarqube/logs、/opt/sonarqube/extensions三个目录有读写权限

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