Docker-compose 编排实例 -- 52. 避免 `docker-compose.yml` 文件中的错误

学习优先级：★★★★☆

易用性：★★★☆☆

docker-compose.yml 文件中的一个小错误可能会导致容器无法正确启动或出现意外行为。常见的错误包括缩进错误或环境变量配置错误。

以下是一个示例，展示了 docker-compose.yml 文件中的错误以及如何修复它。

示例代码

错误的 docker-compose.yml 文件

version: '3'

services:
  web:
    image: nginx:alpine
    ports:
      - "8080:80"
    environment:
      MYSQL_ROOT_PASSWORD example  # 错误：缺少等号

执行结果

运行此配置时，会出现以下错误：

ERROR: yaml.parser.ParserError: while parsing a block mapping in "docker-compose.yml", expected <block end>, but found '<scalar>'

在 YAML 文件中，正确的语法非常重要。此示例中的错误是环境变量 MYSQL_ROOT_PASSWORD 缺少了等号（=）。YAML 需要等号来正确分配值。另一个常见错误是缩进错误或行错误，这会阻止文件的解析。Docker Compose 提供了 docker-compose config 命令来检查错误，这有助于提前发现语法错误或错误配置。

补充说明

YAML 语法对空格和缩进非常敏感。在大型项目中，docker-compose.yml 文件中的一个小错误可能会导致严重问题。因此，建议在每次更改后验证文件。