Docker Compose高级用法：环境变量与配置管理

CarlowZJ

已于 2025-05-05 17:37:47 修改

阅读量2k

点赞数 9

文章标签： docker 容器运维

于 2025-03-15 16:06:40 首次发布

本文链接：https://blog.csdn.net/csdn122345/article/details/146222350

版权

4.1 环境变量的作用

4.1.1 在 docker-compose.yml 中定义环境变量

4.1.2 使用 .env 文件管理环境变量

4.3 实战案例：配置一个完整的 Web 应用

项目结构

docker-compose.yml 文件内容

在开发和部署多容器应用时，配置管理是一个关键环节。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.sql

`docker-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 的环境变量和配置管理有任何疑问，或者需要进一步