Azure容器应用挂载Azure存储运行Mautic启动报错

问题描述 #

尝试在Azure App Service容器中运行Mautic，已启用WEBSITES_ENABLE_APP_SERVICE_STORAGE使用Azure存储，且完成Docker容器与Azure文件共享的挂载配置。已验证文件成功复制到Azure文件存储，但启动时仍持续出现错误：Mautic not found in /var/www/html - copying now....，最终导致多容器应用启动失败。

docker-compose.yml配置 #

version: "3"

services:
  mautic:
    image: mautic/mautic:v4-apache
    volumes:
      - mouticdatamount:/var/www/html
    environment:
      - MAUTIC_DB_HOST=mydb.mysql.database.azure.com
      - MAUTIC_DB_USER=mydbuser
      - MAUTIC_DB_PASSWORD=mydbpassword
      - MAUTIC_DB_NAME=mydbname
    restart: always

错误日志 #

2023-07-15T07:20:25.335Z INFO  - docker run -d -p 9560:80 --name myhost_mautic_0_3cb64f5a -e WEBSITES_ENABLE_APP_SERVICE_STORAGE=true -e WEBSITE_SITE_NAME=myhost -e WEBSITE_AUTH_ENABLED=False -e WEBSITE_ROLE_INSTANCE_ID=0 -e WEBSITE_HOSTNAME=hostname.azurewebsites.net -e WEBSITE_INSTANCE_ID=7e65b7bfda61c0327cd6b05b68172e68b22e90752de61b8d5f6484746acfcd5d -e HTTP_LOGGING_ENABLED=1 -e WEBSITE_USE_DIAGNOSTIC_SERVER=False mautic/mautic:v4-apache  

2023-07-15T07:24:16.260Z ERROR - multi-container unit was not started successfully
2023-07-15T07:24:16.261Z INFO  - Container logs from myhost_mautic_0_3cb64f5a = 2023-07-15T07:20:25.831636447Z Mautic not found in /var/www/html - copying now...

2023-07-15T07:24:21.707Z INFO  - Stopping site myhost because it failed during startup.
2023-07-15T07:30:33.880Z INFO  - Starting multi-container app..

解决方法 #

1. 修复挂载目录权限 #

Mautic容器默认以www-data用户运行，需确保该用户对/var/www/html路径有读写权限：

• 在docker-compose.yml中添加启动命令，先设置权限再启动服务：

  services:
    mautic:
      # 其他配置不变
      command: chown -R www-data:www-data /var/www/html && apache2-foreground
  

• 或者在Azure门户中调整文件共享权限，确保容器用户可正常访问。

2. 验证存储挂载有效性 #

• 检查Azure App Service配置中，卷mouticdatamount与Azure文件共享的关联信息（存储账户、文件共享名称、访问密钥）是否完全匹配。
• 通过Azure门户的SSH功能进入容器，查看/var/www/html目录下的文件结构是否完整。若挂载失败，目录会为空，导致容器触发初始化复制流程但因权限/网络问题卡住。

3. 延长容器启动超时时间 #

Azure App Service默认启动超时可能不足以完成Mautic文件复制与初始化：

• 在应用服务的环境变量中添加WEBSITES_CONTAINER_START_TIME_LIMIT，设置为更大值（如300秒），给容器足够时间完成初始化。

4. 调整挂载策略，避免覆盖核心文件 #

直接挂载整个/var/www/html会覆盖镜像内的初始文件，导致启动脚本误判文件缺失。改为只挂载需要持久化的子目录：

volumes:
  - mouticdatamount:/var/www/html/app
  - mouticdatamount:/var/www/html/media
  - mouticdatamount:/var/www/html/themes

既保留镜像核心文件，又持久化用户自定义数据。

5. 验证数据库连接配置 #

数据库连接失败也可能导致容器启动异常：

• 检查MAUTIC_DB_HOST、MAUTIC_DB_USER、MAUTIC_DB_PASSWORD、MAUTIC_DB_NAME是否正确。
• 确认Azure MySQL数据库已允许应用服务的IP访问，且目标数据库已创建。

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