如何解决ddev启动Drupal 9站点时“unknown flag: --progress”错误？

问题描述 #

启动Drupal9站点时触发错误：

unknown flag: --progress

当前环境版本信息：

ITEM             VALUE                                   
 DDEV version     v1.22.0                                 
 architecture     amd64                                   
 db               ddev/ddev-dbserver-mariadb-10.4:v1.22.0 
 ddev-ssh-agent   ddev/ddev-ssh-agent:v1.22.0             
 docker           24.0.5                                  
 docker-compose   v2.10.2                                 
 docker-platform  Ubuntu 22.04.2 LTS                      
 mutagen          0.17.2                                  
 os               linux                                   
 router           traefik:v2.10                           
 web              ddev/ddev-webserver:v1.22.0  

原因 #

Ddev v1.22.0会调用docker-compose --progress参数，但该参数仅在docker-compose v2.17.0及以上版本支持，当前使用的v2.10.2不兼容该参数。

解决方法 #

方法1：升级docker-compose到兼容版本 #

在Ubuntu系统中执行以下命令升级：

sudo curl -L "https://github.com/docker/compose/releases/download/v2.20.3/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

验证升级结果：

docker-compose --version

方法2：降级Ddev到适配版本 #

如果不想升级docker-compose，可降级Ddev到v1.21.6（该版本不依赖--progress参数）：

curl -LO https://github.com/ddev/ddev/releases/download/v1.21.6/ddev_linux-amd64.tar.gz
tar -xzf ddev_linux-amd64.tar.gz
sudo mv ddev /usr/local/bin/

验证降级结果：

ddev version

方法3：临时禁用进度参数（临时方案） #

在项目目录下的.ddev/config.yaml中添加配置：

environment:
  - COMPOSE_PROGRESS=no

或者启动时临时设置环境变量：

COMPOSE_PROGRESS=no ddev start

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