独立开发经验谈:我是如何借助 Docker 环境变量让客户 1 分钟上线客服系统的

我在业余时间开发了一款自己的独立产品:升讯威在线客服与营销系统。陆陆续续开发了几年,从一开始的偶有用户尝试,到如今线上环境和私有化部署均有了越来越多的稳定用户,在这个过程中,我也积累了不少如何开发运营一款独立产品的经验。

我之前写过一篇文章,介绍如何用 Docker 让潜在客户快速体验你的独立产品。

有朋友看到这篇文章之后,试用了产品并且给了我新的建议:用 Docker 环境变量让试用更方便。在此感谢这位 xj 的朋友。

我的例子

在前一篇文章中,要运行我制作的在线客服系统 Docker 镜像为例,需要 2 个命令:

  1. 从 Docker Hub 下载升讯威在线客服系统镜像
    docker pull iccb1013/linkup:latest

  2. 启动容器(之前的命令)
    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 参数来设置环境变量。例如:

bash 复制代码
docker run -e MY_ENV_VAR=value my_image

这样会在容器中设置一个名为 MY_ENV_VAR 的环境变量,值为 value

3.2 使用 .env 文件

为了方便管理多个环境变量,可以使用 .env 文件。在 .env 文件中,每一行定义一个环境变量的键值对:

bash 复制代码
MY_ENV_VAR=value
ANOTHER_ENV_VAR=another_value

然后通过 --env-file 参数将该文件传递给 Docker 容器:

bash 复制代码
docker run --env-file .env my_image

3.3 在 Dockerfile 中使用 ENV 指令

在构建镜像时,可以在 Dockerfile 中使用 ENV 指令来设置环境变量:

dockerfile 复制代码
FROM ubuntu:latest
ENV MY_ENV_VAR=value

这将创建一个在容器运行时可用的环境变量 MY_ENV_VAR

3.4 使用 docker-compose 中的环境变量

在使用 docker-compose 管理多个容器时,可以在 docker-compose.yml 文件中定义环境变量:

yaml 复制代码
version: '3'
services:
  webapp:
    image: my_image
    environment:
      - MY_ENV_VAR=value
      - ANOTHER_VAR=another_value

此外,也可以从 .env 文件加载环境变量:

yaml 复制代码
version: '3'
services:
  webapp:
    image: my_image
    env_file:
      - .env

3.5 通过 docker exec 查看环境变量

可以通过 docker exec 进入容器内部,使用 envprintenv 命令查看容器中的环境变量:

bash 复制代码
docker exec -it container_id env

4. 环境变量的作用与实践

环境变量通常用于以下几种场景:

4.1 数据库连接信息

在多环境部署中,数据库连接信息可以通过环境变量配置,以避免在源代码中硬编码这些信息。例如:

bash 复制代码
docker run -e DB_HOST=localhost -e DB_USER=root -e DB_PASS=secret my_image

4.2 API 密钥

很多应用依赖于外部服务的 API 密钥,这些密钥可以通过环境变量来传递,以避免泄露。例如:

bash 复制代码
docker run -e API_KEY=your_api_key my_image

4.3 配置不同的运行环境

可以根据不同的环境传递不同的环境变量值,如开发、测试和生产环境。例如,在生产环境中你可能需要开启调试日志,但在开发环境中关闭它。

bash 复制代码
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 或多容器应用中,环境变量的作用域仅限于指定的容器,跨容器传递时需要显式声明。

钟意的话请给个赞支持一下吧,谢谢~