如何配置 Docker 环境变量

简介

在本全面教程中，我们将深入探讨 Docker 环境变量的世界，涵盖从基础到在容器化应用程序中传递、配置和管理它们的高级技术的所有内容。无论你是经验丰富的 Docker 用户还是刚刚起步，本指南都将为你提供知识和最佳实践，以有效利用环境变量，并确保基于 Docker 的部署的安全性、可维护性和可移植性。

Skills Graph

Docker 环境基础

理解 Docker 环境变量

Docker 环境变量是关键的配置机制，可实现容器的动态运行时设置。它们提供了一种灵活的方式来注入配置并控制容器行为，而无需修改容器镜像。

关键环境变量类型

配置方法

开发者可以通过多种方式定义 Docker 环境变量：

1. Dockerfile 配置

FROM ubuntu:22.04
ENV APP_NAME=myservice
ENV DEBUG_MODE=false

2. 命令行注入

docker run -e DATABASE_URL=postgres://user:pass@localhost/db myimage

3. 环境文件

docker run --env-file./config.env myimage

运行时配置示例

## 创建一个环境配置文件
echo "DB_HOST=database.example.com" > app.env
echo "LOG_LEVEL=debug" >> app.env

## 使用环境文件启动容器
docker run --env-file app.env ubuntu:22.04

此方法展示了 Docker 环境变量如何实现灵活、安全且动态的容器配置，而无需将敏感信息直接硬编码到镜像中。

管理 Docker 环境

环境配置策略

Docker 环境管理需要系统的方法来处理不同部署阶段的复杂配置场景。

环境变量作用域

环境文件管理

## 创建环境配置
mkdir -p /opt/docker/configs
touch /opt/docker/configs/app.env
echo "DATABASE_URL=postgresql://user:pass@localhost/db" > /opt/docker/configs/app.env
echo "DEBUG_MODE=false" >> /opt/docker/configs/app.env

## 使用环境文件启动容器
docker run --env-file /opt/docker/configs/app.env ubuntu:22.04

安全的环境变量处理

## 使用 Docker 机密存储敏感数据
echo "sensitive_password" | docker secret create db_password -

docker service create \
  --name database \
  --secret db_password \
  postgres:latest

动态环境注入

## 运行时环境变量替换
export DB_HOST=production.database.com
docker run -e DB_HOST=$DB_HOST myapplication

此方法展示了在不同部署环境中灵活且安全的 Docker 环境管理技术。

高级环境策略

复杂环境配置技术

高级 Docker 环境管理需要复杂的策略来处理复杂的部署场景。

环境变量验证

## 实现严格的环境验证
validate_env() {
  if [ -z "$DATABASE_URL" ]; then
    echo "错误：必须指定 DATABASE_URL"
    exit 1
  fi
}

## 在 Docker 入口脚本中使用
validate_env

多阶段环境配置

安全环境加密

## 加密敏感环境配置
apt-get update && apt-get install -y gpg

## 生成加密密钥
gpg --gen-key

## 加密环境文件
gpg -c /opt/docker/configs/sensitive.env

## 在容器启动期间解密
gpg -d /opt/docker/configs/sensitive.env.gpg

动态环境适配

FROM ubuntu:22.04

## 条件环境配置
ARG ENV_TYPE=development
ENV APP_MODE=${ENV_TYPE}

RUN if [ "$APP_MODE" = "production" ]; then \
        echo "应用生产优化"; \
    else \
        echo "使用开发配置"; \
    fi

运行时环境自省

## 检查容器环境
docker inspect \
  --format='{{range.Config.Env}}{{println.}}{{end}}' \
  容器名称

这些高级策略展示了 Docker 环境管理的复杂方法，重点在于验证、安全和动态配置。

总结

在本教程结束时，你将对如何在 Docker 中使用环境变量有扎实的理解，包括将它们传递给容器、在 Docker Compose 中配置它们，以及遵循管理敏感和非敏感变量的最佳实践。你还将学习如何排查与 Docker 环境变量相关的常见问题，从而能够构建更健壮、更可靠的容器化应用程序。