casadosaber/node

Doppler增强的CircleCI Node.js镜像

镜像概述

本Docker镜像基于CircleCI官方的cimg/node镜像构建，在其基础上集成了Doppler环境变量管理工具。cimg/node是CircleCI提供的优化Node.js开发环境镜像，而Doppler则是一款用于安全管理、同步和注入环境变量的工具，二者结合为Node.js项目提供了便捷的环境变量管理能力。

核心功能与特性

• 基于官方镜像：继承cimg/node的所有特性，包括预配置的Node.js环境、npm/yarn包管理器及常用开发工具
• 预安装Doppler：已集成Doppler CLI，可直接使用doppler命令进行环境变量管理
• 环境隔离：支持通过Doppler管理不同环境（开发、测试、生产）的环境变量，避免硬编码敏感信息
• 无缝集成：可直接用于CI/CD流程或本地开发环境，简化环境变量配置流程

使用场景与适用范围

• Node.js项目的CI/CD流水线（如CircleCI、GitHub Actions等）
• 需要安全管理敏感环境变量的开发环境
• 多环境部署的Node.js应用（开发、测试、生产环境配置分离）
• 需要快速同步团队成员环境变量配置的协作场景

使用方法与配置说明

基本使用（Docker Run）

bash
docker run -it --rm \
  -e DOPPLER_TOKEN=<your-doppler-token> \
  <image-name> \
  doppler run -- node your-app.js

Docker Compose配置示例

yaml
version: '3'
services:
  node-app:
    image: <image-name>
    environment:
      - DOPPLER_TOKEN=<your-doppler-token>
    command: doppler run -- node app.js
    volumes:
      - ./app:/app
    working_dir: /app

关键环境变量

Doppler基本操作

在容器内可直接使用Doppler CLI命令：

• 验证Doppler安装：doppler --version
• 查看当前环境变量：doppler secrets
• 运行应用并注入环境变量：doppler run -- node your-app.js
• 切换环境配置：doppler config set config=dev

注意事项

• 使用前需在Doppler官网创建项目并获取访问令牌
• cimg/node的基础版本信息可参考CircleCI官方文档
• 敏感环境变量通过Doppler管理，避免在镜像或容器配置中直接暴露