docker-compose 使用环境变量及常见问题解决方法

在前端开发中，Docker 已成为一个不可或缺的工具。而 docker-compose 则是 Docker 官方推荐的编排工具之一，方便开发人员管理和运行多个容器应用。

在使用 docker-compose 进行容器编排的同时，使用环境变量能够让我们更灵活地管理容器应用。本文将介绍如何在 docker-compose 中使用环境变量，并解决使用过程中可能会遇到的常见问题。

使用环境变量

在 docker-compose 中使用环境变量需要借助 .env 文件，这个文件是一个纯文本文件，内容形如 VAR_NAME=VAR_VALUE。

在 docker-compose 文件中，可以使用 ${VAR_NAME} 的方式引用 .env 文件中定义的环境变量，例如：

services:
  web:
    image: "nginx:${NGINX_VERSION}"

这里的 ${NGINX_VERSION} 就是引用了 .env 文件中定义的 NGINX_VERSION 环境变量。

同时，还可以使用 export 命令将环境变量导出至命令行，例如：

export NGINX_VERSION=1.19.7
docker-compose up -d

这样，在运行 docker-compose 命令时就可以使用导出后的环境变量了。

常见问题解决方法

问题一：.env 文件不生效

在使用 docker-compose 时，.env 文件不生效的原因可能是由于文件名不符合预期。

在 docker-compose 编排文件中，.env 文件使用以下规则查找：

1. 如果文件名已经指定，则使用指定的文件名；
2. 如果当前目录中存在 .env 文件，则使用该文件；
3. 如果不存在 .env 文件，则找到父目录。如果父目录中存在 .env 文件，则使用该文件；
4. 重复该过程，直到根目录。

因此，如果 .env 文件没有生效，可以检查文件名是否满足上述规则。

问题二：环境变量在容器中不存在

如果在容器内部找不到指定的环境变量，可能是由于 docker-compose 运行时并没有将 .env 文件中的环境变量传递到容器中。

在 docker-compose 文件中，可以使用 env_file 参数指定传递环境变量的文件，例如：

services:
  web:
    image: nginx:${NGINX_VERSION}
    env_file:
      - .env

这里指定了 .env 文件作为传递环境变量的文件。如果环境变量仍然无法传递到容器中，可以使用 printenv 命令在容器内部查看环境变量是否存在。

问题三：环境变量值中包含特殊字符

在 .env 文件中定义的环境变量可能会包含特殊字符，例如空格、引号和反斜杠等。在使用 docker-compose 时，为了避免转义字符的影响，可以使用双引号将变量值括起来，例如：

MYSQL_ROOT_PASSWORD="root\`123456$%^&*\""

这里的双引号可以保证变量值不被转义。

总结

使用环境变量可以让 docker-compose 更加灵活，对于需要在多个环境中部署应用的开发者来说，是一个必不可少的技能点。

通过解决常见问题，我们可以更好地使用 docker-compose 和环境变量，提高开发效率和部署灵活性。

来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/64a2c26c48841e9894f3a57d