我在业余时间开发了一款自己的独立产品:升讯威在线客服与营销系统。陆陆续续开发了几年,从一开始的偶有用户尝试,到如今线上环境和私有化部署均有了越来越多的稳定用户,在这个过程中,我也积累了不少如何开发运营一款独立产品的经验。
我之前写过一篇文章,介绍如何用 Docker 让潜在客户快速体验你的独立产品。
有朋友看到这篇文章之后,试用了产品并且给了我新的建议:用 Docker 环境变量让试用更方便。在此感谢这位 xj 的朋友。
我的例子
在前一篇文章中,要运行我制作的在线客服系统 Docker 镜像为例,需要 2 个命令:
-
从 Docker Hub 下载升讯威在线客服系统镜像
docker pull iccb1013/linkup:latest
-
启动容器(之前的命令)
docker run -p 8021-8023:8021-8023 -p 9527:9527 -dit --restart=always --privileged=true --name=linkup_latest iccb1013/linkup:latest
但是在启动容器之后,还有一个步骤需要手工操作,就是查看容器的 Id,并进入容器内部去修改配置文件,修改 kf-api、kf-resource 两个域名和 IP 地址,这一步虽说不算麻烦,但毕竟要进入容器内部再用 vim 去操作。
这位 xj 的朋友给了我一个建议,用环境变量,使用环境变量之后启动命令看起来长这样:
docker run -e ApiUrl=http://kf-api.yourname.com -e ResourceUrl=http://kf-resource.yourname.com -e TcpIpAddress=您的服务器公网IP地址 -p 8021-8023:8021-8023 -p 9527:9527 -dit --restart=always --privileged=true --name=linkup_latest iccb1013/linkup:latest
在新的启动命令中,包括了 3 个环境变量,分别是:
- ApiUrl:您的主程序域名
- ResourceUrl:静态资源站点域名
- TcpIpAddress:您的服务器公网IP地址
通过指定这些环境变量,可以在启动容器后直接上线使用,而无需进入容器手工修改配置文件。
这样就可以将这 3 个主要参数带进容器内部,自动写入配置文件中,完全免去了进入容器内部 vim 修改的步骤,接下来只需要在宿主机 Nginx 中配上站点,把请求代理到容器上就完事儿了,真真正正做到了在线客服系统 1 分钟上线。
重点来了,如何让你的独立产品用上 Docker 环境变量
Docker环境变量是 Docker 容器化应用中一种重要的配置方式。它们可以帮助在容器启动时为应用提供必要的参数或配置,而不需要修改容器内部的代码或配置文件。Docker 环境变量使得容器可以更加灵活和动态化,尤其在不同的部署环境中尤为重要。
1. 什么是 Docker 环境变量?
Docker 环境变量(Environment Variables)是操作系统层面上用于存储配置信息的变量。在 Docker 容器中,环境变量通常用于存储应用的配置信息、凭证、API 密钥、数据库连接字符串等。它们可以在容器启动时传递,并可以在运行时访问和修改。
2. 为什么使用环境变量?
- 灵活性:可以根据不同的运行环境提供不同的值,无需修改容器镜像。
- 安全性:可以避免硬编码敏感信息(如密码、API 密钥等),提升安全性。
- 配置管理:通过环境变量可以在不修改容器内容的情况下,动态调整容器行为。
3. 如何在 Docker 中使用环境变量?
Docker 提供了几种设置和使用环境变量的方式:
3.1 使用 -e
或 --env
参数设置环境变量
在使用 docker run
启动容器时,可以通过 -e
参数来设置环境变量。例如:
docker run -e MY_ENV_VAR=value my_image
这样会在容器中设置一个名为 MY_ENV_VAR
的环境变量,值为 value
。
3.2 使用 .env
文件
为了方便管理多个环境变量,可以使用 .env
文件。在 .env
文件中,每一行定义一个环境变量的键值对:
MY_ENV_VAR=value
ANOTHER_ENV_VAR=another_value
然后通过 --env-file
参数将该文件传递给 Docker 容器:
docker run --env-file .env my_image
3.3 在 Dockerfile 中使用 ENV
指令
在构建镜像时,可以在 Dockerfile
中使用 ENV
指令来设置环境变量:
FROM ubuntu:latest
ENV MY_ENV_VAR=value
这将创建一个在容器运行时可用的环境变量 MY_ENV_VAR
。
3.4 使用 docker-compose
中的环境变量
在使用 docker-compose
管理多个容器时,可以在 docker-compose.yml
文件中定义环境变量:
version: '3'
services:webapp:image: my_imageenvironment:- MY_ENV_VAR=value- ANOTHER_VAR=another_value
此外,也可以从 .env
文件加载环境变量:
version: '3'
services:webapp:image: my_imageenv_file:- .env
3.5 通过 docker exec
查看环境变量
可以通过 docker exec
进入容器内部,使用 env
或 printenv
命令查看容器中的环境变量:
docker exec -it container_id env
4. 环境变量的作用与实践
环境变量通常用于以下几种场景:
4.1 数据库连接信息
在多环境部署中,数据库连接信息可以通过环境变量配置,以避免在源代码中硬编码这些信息。例如:
docker run -e DB_HOST=localhost -e DB_USER=root -e DB_PASS=secret my_image
4.2 API 密钥
很多应用依赖于外部服务的 API 密钥,这些密钥可以通过环境变量来传递,以避免泄露。例如:
docker run -e API_KEY=your_api_key my_image
4.3 配置不同的运行环境
可以根据不同的环境传递不同的环境变量值,如开发、测试和生产环境。例如,在生产环境中你可能需要开启调试日志,但在开发环境中关闭它。
docker run -e ENV=production -e LOG_LEVEL=error my_image
5. 容器间共享环境变量
在多容器的场景中,如果需要多个容器共享环境变量,可以通过 Docker 网络和服务间的环境变量传递来实现。例如,使用 Docker Compose 启动多个服务时,web
服务可以访问 db
服务的环境变量。
6. 限制和注意事项
- 敏感信息:环境变量可以在 Docker 容器启动时传递,但它们也有泄露的风险。例如,容器日志或操作系统的某些工具可能会暴露这些变量。
- 变量覆盖:在容器运行时,环境变量的值可能会被外部传递的变量覆盖。例如,在
docker-compose.yml
中设置的环境变量可以在docker run
时通过-e
参数覆盖。 - 共享变量的作用域:在 Docker Compose 或多容器应用中,环境变量的作用域仅限于指定的容器,跨容器传递时需要显式声明。