Docker Compose高级用法：环境变量与配置管理
目录
4.1 环境变量的作用
4.1.1 在 docker-compose.yml 中定义环境变量
4.1.2 使用 .env 文件管理环境变量
4.1.3 使用命令行传递环境变量
4.2 配置文件的使用
4.2.1 数据库初始化脚本
4.2.2 服务配置文件
4.3 实战案例：配置一个完整的 Web 应用
项目结构
docker-compose.yml 文件内容
.env 文件内容
启动和测试应用
测试服务
4.4 注意事项
4.5 总结
在开发和部署多容器应用时，配置管理是一个关键环节。Docker Compose 提供了灵活的环境变量和配置管理功能，使得开发者可以轻松地在不同环境中切换配置，而无需修改代码或 docker-compose.yml 文件。本文将详细介绍如何使用环境变量和配置文件来管理 Docker Compose 项目的配置，并通过实际案例展示其应用场景。
4.1 环境变量的作用
在多容器应用中，环境变量是管理配置的常用方式。它们可以用于设置数据库连接信息、服务端口、API 密钥等。Docker Compose 支持多种方式来管理环境变量，包括直接在 docker-compose.yml 文件中定义、使用 .env 文件或通过命令行传递。
4.1.1 在 docker-compose.yml 中定义环境变量
你可以在 docker-compose.yml 文件中直接定义环境变量。例如：
yaml复制
version: '3.8'
services:
web:
image: nginx:latest
ports:
- "80:80"
environment:
- NGINX_ENV=production
- NGINX_PORT=80
db:
image: mysql:5.7
environment:
MYSQL_ROOT_PASSWORD: example
MYSQL_DATABASE: mydb这种方式的优点是简单直接，但缺点是不适合管理敏感信息（如密码），且不便于在不同环境中切换配置。
4.1.2 使用 .env 文件管理环境变量
为了更好地管理环境变量，Docker Compose 支持 .env 文件。你可以在项目根目录下创建一个 .env 文件，并在其中定义环境变量。例如：
.env 文件内容：
plaintext复制
NGINX_ENV=production
NGINX_PORT=80
MYSQL_ROOT_PASSWORD=example
MYSQL_DATABASE=mydb然后在 docker-compose.yml 文件中引用这些变量：
yaml复制
version: '3.8'
services:
web:
image: nginx:latest
ports:
- "${NGINX_PORT}:80"
environment:
- NGINX_ENV=${NGINX_ENV}
db:
image: mysql:5.7
environment:
MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
MYSQL_DATABASE: ${MYSQL_DATABASE}这种方式的优点是将配置与代码分离，便于在不同环境中切换配置，同时避免敏感信息暴露在代码中。
4.1.3 使用命令行传递环境变量
你也可以通过命令行传递环境变量。例如：
bash复制
MYSQL_ROOT_PASSWORD=example MYSQL_DATABASE=mydb docker-compose up -d这种方式适用于临时测试或自动化脚本，但不适合长期管理。
4.2 配置文件的使用
除了环境变量，Docker Compose 还支持加载外部配置文件，例如数据库初始化脚本、服务配置文件等。这可以通过 volumes 挂载实现。
4.2.1 数据库初始化脚本
假设你有一个 MySQL 数据库服务，需要在启动时初始化数据。你可以在项目目录下创建一个 db/init.sql 文件，并在 docker-compose.yml 文件中挂载该文件：
db/init.sql 文件内容：
sql复制
CREATE DATABASE mydb;
USE mydb;
CREATE TABLE example (
id INT AUTO_INCREMENT PRIMARY KEY,
name VARCHAR(50) NOT NULL
);
INSERT INTO example (name) VALUES ('Docker Compose');docker-compose.yml 文件内容：
yaml复制
version: '3.8'
services:
db:
image: mysql:5.7
environment:
MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
MYSQL_DATABASE: ${MYSQL_DATABASE}
volumes:
- db_data:/var/lib/mysql
- ./db/init.sql:/docker-entrypoint-initdb.d/init.sql
volumes:
db_data:4.2.2 服务配置文件
对于需要配置文件的服务，例如 Nginx，你可以在项目目录下创建一个 nginx.conf 文件，并在 docker-compose.yml 文件中挂载该文件：
frontend/nginx.conf 文件内容：
nginx复制
server {
listen 80;
location / {
root /usr/share/nginx/html;
index index.html;
}
}docker-compose.yml 文件内容：
yaml复制
version: '3.8'
services:
web:
image: nginx:latest
ports:
- "80:80"
volumes:
- ./frontend:/usr/share/nginx/html
- ./frontend/nginx.conf:/etc/nginx/nginx.conf这种方式的优点是将配置文件与服务分离，便于管理和更新。
4.3 实战案例：配置一个完整的 Web 应用
为了更好地理解环境变量和配置文件的使用，我们将通过一个实际案例展示如何配置一个完整的 Web 应用，包括前端、后端和数据库服务。
项目结构
复制
my_web_app/
├── docker-compose.yml
├── .env
├── frontend/
│ ├── index.html
│ └── nginx.conf
├── backend/
│ ├── app.py
│ └── requirements.txt
└── db/
└── init.sqldocker-compose.yml 文件内容
yaml复制
version: '3.8'
services:
web:
image: nginx:latest
ports:
- "${NGINX_PORT}:80"
volumes:
- ./frontend:/usr/share/nginx/html
- ./frontend/nginx.conf:/etc/nginx/nginx.conf
environment:
- NGINX_ENV=${NGINX_ENV}
networks:
- webapp_network
backend:
build: ./backend
ports:
- "${BACKEND_PORT}:5000"
environment:
DB_HOST: db
DB_USER: ${MYSQL_USER}
DB_PASSWORD: ${MYSQL_PASSWORD}
DB_NAME: ${MYSQL_DATABASE}
depends_on:
- db
networks:
- webapp_network
db:
image: mysql:5.7
environment:
MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
MYSQL_DATABASE: ${MYSQL_DATABASE}
volumes:
- db_data:/var/lib/mysql
- ./db/init.sql:/docker-entrypoint-initdb.d/init.sql
networks:
- webapp_network
networks:
webapp_network:
driver: bridge
volumes:
db_data:.env 文件内容
plaintext复制
NGINX_ENV=production
NGINX_PORT=80
BACKEND_PORT=5000
MYSQL_ROOT_PASSWORD=example
MYSQL_DATABASE=mydb
MYSQL_USER=root
MYSQL_PASSWORD=example启动和测试应用
在项目根目录下运行以下命令启动服务：
bash复制
docker-compose up -d测试服务
-
访问前端页面：
-
打开浏览器，访问
http://localhost，你应该能看到前端页面的内容。
-
-
测试后端 API：
-
使用浏览器或 Postman 访问
http://localhost:5000/api/data，你应该能看到数据库中初始化的数据。
-
-
检查服务状态：
bash复制
docker-compose ps -
查看日志：
bash复制
docker-compose logs backend
4.4 注意事项
-
敏感信息管理：
-
避免在
docker-compose.yml文件中直接写入敏感信息（如密码）。建议使用.env文件或环境变量管理。
-
-
配置文件的版本管理：
-
将配置文件（如
nginx.conf、init.sql）纳入版本控制，便于管理和回滚。
-
-
环境变量的默认值：
-
在
.env文件中为环境变量设置默认值，避免因环境变量未设置而导致服务启动失败。
-
-
多环境配置：
-
对于不同环境（开发、测试、生产），可以创建多个
.env文件（如.env.dev、.env.prod），并通过命令行指定加载的.env文件：bash复制
docker-compose --env-file .env.prod up -d
-
4.5 总结
通过本文的介绍，我们详细探讨了 Docker Compose 中环境变量和配置文件的使用方法。通过合理使用 .env 文件和外部配置文件，你可以轻松管理多容器应用的配置，同时避免敏感信息暴露在代码中。环境变量和配置文件的结合使用，使得 Docker Compose 项目在不同环境中具有高度的灵活性和可维护性。
在接下来的博客中，我们将继续探索 Docker Compose 的高级功能，例如与 Docker Swarm 的集成、性能优化以及安全性最佳实践。敬请期待！
希望这篇博客对你有帮助！如果你对 Docker Compose 的环境变量和配置管理有任何疑问，或者需要进一步
