目录

前言

1 Docker-compose环境变量基础

1.1 环境变量的作用与优势

1.2 环境变量的作用范围

2 .env文件的核心用法

2.1 .env文件基础语法

2.2 变量引用与替换

2.3 多环境配置策略

3 高级配置技巧

3.1 环境变量优先级

3.2 条件配置与模板

3.3 安全实践

4 案例:多环境配置管理

4.1 项目结构设计

4.2 分层配置示例

4.3 Compose文件设计

4.4 部署流程

5 常见问题与解决方案

5.1 变量未生效问题

5.2 敏感信息泄露风险

5.3 多环境切换困难

6 总结


前言

在实际的Docker化应用开发和部署过程中,如何高效管理不同环境的配置差异是一个关键挑战。Docker-compose提供了强大的环境变量支持,允许我们实现配置的动态注入和环境隔离。

1 Docker-compose环境变量基础

1.1 环境变量的作用与优势

环境变量是操作系统或容器运行时提供给应用程序的动态配置方式,在Docker-compose中使用环境变量具有以下优势:
  • 配置与代码分离:避免将敏感信息硬编码在配置文件中
  • 多环境支持:同一份Compose文件可适应不同环境
  • 动态注入:运行时决定配置值
  • 安全性:敏感信息不暴露在版本控制中

1.2 环境变量的作用范围

  • 在Docker-compose生态中,环境变量可以在多个层面定义和使用:

层级

定义方式

作用范围

典型用途

Shell环境

export VAR=value

当前终端会话

临时测试

.env文件

VAR=value

整个Compose项目

项目默认配置

compose文件

environment:

指定服务

服务特定配置

env_file

env_file:指定文件

指定服务

服务专用配置

2 .env文件的核心用法

2.1 .env文件基础语法

  • .env文件是Docker-compose默认加载的环境变量定义文件,采用简单的键值对格式:
# 注释以#开头
DB_HOST=mysql
DB_PORT=3306
DB_USER=admin
DB_PASSWORD=secret  # 包含空格的值需要引号

# 支持空行分隔

APP_ENV=production
语法规则
  • 每行一个键值对,格式为KEY=VALUE
  • 值可以不加引号,除非包含空格或特殊字符
  • #开头的行为注释
  • 变量名通常大写,下划线分隔

2.2 变量引用与替换

  • 在docker-compose.yml中可以通过${VAR_NAME}语法引用.env文件中定义的变量:
services:
  db:
    image: mysql:5.7
    environment:
      MYSQL_ROOT_PASSWORD: ${DB_PASSWORD}
      MYSQL_DATABASE: ${DB_NAME:-defaultdb}  # 默认值语法
变量替换语法
  • ${VAR}:基本引用
  • ${VAR:-default}:带默认值的引用
  • ${VAR:?error}:必须定义的变量,未定义时报错

2.3 多环境配置策略

  • 实际项目通常需要管理多个环境的配置,推荐的文件结构:
project/
├── .env.dev       # 开发环境
├── .env.test      # 测试环境
├── .env.prod      # 生产环境
├── docker-compose.yml
└── docker-compose.override.yml
加载机制
  • 默认加载.env文件
  • 可通过--env-file指定不同文件
  • 环境变量可组合使用

3 高级配置技巧

3.1 环境变量优先级

  • 当多个地方定义了相同变量时,Docker-compose遵循以下优先级规则:
services:
  app:
    image: ${IMAGE_NAME:-myapp}:${TAG:-latest}
    deploy:
      replicas: ${REPLICAS:-1}
    ports:
      - "${HOST_PORT:-8080}:80"
实际应用场景
  • 敏感信息:使用env_file并加入.gitignore
  • 环境差异:使用不同.env文件
  • 临时覆盖:使用Shell环境变量

3.2 条件配置与模板

  • 利用环境变量实现条件化配置:
高级用法
  • 镜像标签动态控制
  • 资源限制按环境调整
  • 功能开关配置

3.3 安全实践

  • 敏感信息管理
# 生成随机密码
openssl rand -base64 16 > .secrets
  • git忽略配置
# .gitignore
.env.local
.secrets
*.env
!.env.example
  • 只读挂载
services:
  app:
    env_file:
      - ./secrets.env:ro

4 案例:多环境配置管理

4.1 项目结构设计

ecommerce/
├── .env            # 基础配置
├── .env.dev        # 开发环境覆盖
├── .env.staging    # 预发布环境
├── .env.prod       # 生产环境
├── config/
│   ├── dev/        # 开发环境专用配置
│   ├── prod/       # 生产环境专用配置
│   └── common/     # 通用配置
├── docker-compose.yml
└── docker-compose.prod.yml

4.2 分层配置示例

  • 基础.env
# 通用配置
APP_NAME=MyApp
LOG_LEVEL=info

# 数据库默认配置
DB_HOST=db
DB_PORT=3306
  • 开发环境.env.dev
# 覆盖开发环境特定配置
LOG_LEVEL=debug
DB_HOST=localhost
DB_PASSWORD=devpass
  • 生产环境.env.prod
# 生产环境配置
LOG_LEVEL=warn
DB_PASSWORD=${PROD_DB_PASSWORD}  # 从CI/CD注入

4.3 Compose文件设计

version: '3.8'

services:
  app:
    build: .
    environment:
      - APP_ENV=${APP_ENV:-development}
      - DB_HOST=${DB_HOST}
      - DB_PORT=${DB_PORT}
      - DB_USER=${DB_USER:-appuser}
      - DB_PASSWORD=${DB_PASSWORD}
    env_file:
      - ./config/${APP_ENV}/secrets.env

  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: ${DB_ROOT_PASSWORD}
      MYSQL_DATABASE: ${DB_NAME}
    volumes:
      - db_data:/var/lib/mysql

volumes:
  db_data:

4.4 部署流程

  • 开发环境启动:
export APP_ENV=dev && docker-compose up
  • 生产环境部署:
export APP_ENV=prod
export PROD_DB_PASSWORD=$(aws secretsmanager get-secret-value ...)
docker-compose -f docker-compose.yml -f docker-compose.prod.yml up -d

5 常见问题与解决方案

5.1 变量未生效问题

症状:容器内获取不到预期的环境变量值
排查步骤
  • 使用docker-compose config验证最终配置
  • 检查变量名拼写(大小写敏感)
  • 确认.env文件位置正确
  • 查看变量优先级是否被覆盖

5.2 敏感信息泄露风险

防护措施
  • 永远不要提交包含真实密码的.env文件到版本控制
  • 使用.env.example模板文件记录变量名
  • 考虑使用密钥管理服务(如AWS Secrets Manager)
  • 限制.env文件权限:chmod 600 .env

5.3 多环境切换困难

  • 解决方案
# 环境切换脚本 switch_env.sh #!/bin/bash ENV=$1 cp .env.$ENV .env echo "Switched to $ENV environment" # 使用方式 ./switch_env.sh prod

6 总结

通过本文,我们了解了Docker-compose中环境变量与配置隔离的各个方面。从基础的.env文件使用到复杂的多环境管理,环境变量机制为我们提供了灵活的应用配置方案。
掌握这些环境变量管理技巧后,你的Docker-compose配置将变得更加灵活、安全和可维护,能够轻松应对从开发到生产各种环境的配置挑战。
Logo

北京人形旗下天工造物具身智能开源社区,聚焦具身天工与慧思开物两大平台

更多推荐